java命名空间java.awt类container的类成员方法:
setcomponentzorder定义及介绍
本文导语:
setcomponentzorder
public void setcomponentzorder(component comp,
int index)
将指定组件移动到容器中指定的 z 顺序索引。z 顺序确定了绘制组件的顺序;具有最高 z 顺序的组件将第一个绘制,而具有最低 z 顺序的组件...
setcomponentzorder
public void setcomponentzorder(component comp,
int index)
- 将指定组件移动到容器中指定的 z 顺序索引。z 顺序确定了绘制组件的顺序;具有最高 z 顺序的组件将第一个绘制,而具有最低 z 顺序的组件将最后一个绘制。在组件重叠的地方,具有较低 z 顺序的组件将覆盖具有较高 z 顺序的组件。
如果组件是其他某个 container 的子组件,则在将它添加到此容器之前,从该容器中移除它。此方法与 java.awt.container.add(component, int)
之间的重要不同是,在将组件从其以前的容器中移除时,此方法不对该组件调用 removenotify
,除非有此必要,并且基础本机窗口系统允许这样做。因此,如果组件拥有键盘焦点,那么在移动到新的位置上时,它会维持该焦点。
要保证此属性只应用于轻量级的非 container
组件。
注:并不是所有的平台都支持在不调用 removenotify
的情况下,将重量级组件的 z 顺序从一个容器更改到另一个容器中。无法检测某个平台是否支持这一点,因此开发人员不应该作出任何假设。
- 参数:
comp
- 要移动的组件index
- 在容器的列表中插入组件的位置,其中 getcomponentcount()
指追加到尾部
- 抛出:
nullpointerexception
- 如果 comp
为 null
illegalargumentexception
- 如果 comp
是该容器的父容器之一
illegalargumentexception
- 如果在容器间移动的 index
不在 [0, getcomponentcount()]
范围内,或者在容器内移动的 index
不在 [0, getcomponentcount()-1]
范围内
illegalargumentexception
- 如果将一个容器添加给其自身
illegalargumentexception
- 如果将 window
添加到容器中- 从以下版本开始:
- 1.5
- 另请参见:
getcomponentzorder(java.awt.component)