javax.swing
类 JLayeredPane

java.lang.Object
  java.awt.Component
      java.awt.Container
          javax.swing.JComponent
              javax.swing.JLayeredPane

所有已实现的接口：

ImageObserver, MenuContainer, Serializable, Accessible

直接已知子类：

JDesktopPane

public class JLayeredPane
extends JComponent
implements Accessible

JLayeredPane 为 JFC/Swing 容器添加了深度，允许组件在需要时互相重叠。Integer 对象指定容器中每个组件的深度，其中编号较高的组件位于其他组件之上。有关面向任务的文档和使用分层窗格的示例，请参阅 The Java Tutorial 中的 How to Use a Layered Pane 一节。

DEFAULT_LAYER

大多数组件位于的标准层。这是最底层。

PALETTE_LAYER

调色板层位于默认层之上。它们对于浮动工具栏和调色板很有用，因此可以位于其他组件之上。

MODAL_LAYER

该层用于模式对话框。它们将出现在容器中所有工具栏、调色板或标准组件的上面。

POPUP_LAYER

弹出层显示在对话框的上面。这样，与组合框、工具提示和其他帮助文本关联的弹出式窗口将出现在组件、调色板或生成它们的对话框之上。

DRAG_LAYER

拖动一个组件时，将该组件重分配到拖动层可确保将其定位在容器中的其他所有组件之上。完成拖动后，可将该组件重分配到其正常层。

详细信息

每一层都是一个不同的整数。可以在调用 add 的过程中通过传递 Integer 对象，从而在 Component 上设置 layer 属性。
例如：

     layeredPane.add(child, JLayeredPane.DEFAULT_LAYER);
或者
layeredPane.add(child, new Integer(10));
 

     layeredPaneParent.setLayer(child, 10)

编号较高的层显示在编号较低的层之上。因此，对于每个组件，使用其层编号和字母即可，有代表性的列表顺序如下所示：

       5a, 5b, 5c, 2a, 2b, 2c, 1a 

可以通过调用 moveToFront 或 moveToBack 将组件移入到其所在层的顶部或底部位置。

还可以直接指定某层中组件的位置。有效的位置范围是从 0 到该层中组件数减一所得的值。值 -1 指示最底层位置。值 0 指示最顶层位置。与层的编号不同，较高的位置值显示在较低 处。

注： 此序列（通过 java.awt.Container 定义）与层的编号序列相反。可是通常使用的是 moveToFront、moveToBack 和 setLayer 方法。

       5a, 5b, 5c, 5x, 2a, 2b, 2c, 1a 

       5a, 5b, 5z, 5c, 5x, 2a, 2b, 2c, 1a 

       5a, 5b, 5z, 5c, 5x, 3a, 2a, 2b, 2c, 1a 

注： 这些层只是一个逻辑构造，LayoutManager 将影响此容器的所有子组件，而不管其层设置如何。

警告：Swing 不是线程安全的。有关更多信息，请参阅 Swing's Threading Policy。

警告：此类的序列化对象与以后的 Swing 版本不兼容。当前序列化支持适用于短期存储，或适用于在运行相同 Swing 版本的应用程序之间进行 RMI（Remote Method Invocation，远程方法调用）。从 1.4 版本开始，已在 java.beans 包中添加了支持所有 JavaBeans^TM 长期存储的功能。请参见 XMLEncoder。

DEFAULT_LAYER

public static final Integer DEFAULT_LAYER

定义 Default 层的便捷对象。等同于新的 Integer(0)。

PALETTE_LAYER

public static final Integer PALETTE_LAYER

定义 Palette 层的便捷对象。等同于新的 Integer(100)。

MODAL_LAYER

public static final Integer MODAL_LAYER

定义 Modal 层的便捷对象。等同于新的 Integer(200)。

POPUP_LAYER

public static final Integer POPUP_LAYER

定义 Popup 层的便捷对象。等同于新的 Integer(300)。

DRAG_LAYER

public static final Integer DRAG_LAYER

定义 Drag 层的便捷对象。等同于新的 Integer(400)。

FRAME_CONTENT_LAYER

public static final Integer FRAME_CONTENT_LAYER

定义 Frame Content 层的便捷对象。此层通常只用于定位 JFrame 的 contentPane 和 menuBar 组件。等同于新的 Integer(-30000)。

另请参见：

JFrame

LAYER_PROPERTY

public static final String LAYER_PROPERTY

绑定属性

另请参见：

常量字段值

JLayeredPane

public JLayeredPane()

创建新的 JLayeredPane

addImpl

protected void addImpl(Component comp,
                       Object constraints,
                       int index)

从类 Container 复制的描述

将指定组件添加到此容器的指定索引所在的位置上。此方法还通知布局管理器，通过 addLayoutComponent 方法，使用指定的约束对象将组件添加到此容器的布局中。

这些约束是由正使用的特定布局管理器定义的。例如，BorderLayout 类定义了五个约束：BorderLayout.NORTH、BorderLayout.SOUTH、BorderLayout.EAST、BorderLayout.WEST 和 BorderLayout.CENTER。

GridBagLayout 类需要一个 GridBagConstraints 对象。如果传递正确的约束对象类型时失败，则会导致 IllegalArgumentException。

如果当前布局管理器实现了 LayoutManager2，则在其上调用 LayoutManager2.addLayoutComponent(Component,Object)。如果当前布局管理器没有实现 LayoutManager2，并且约束是一个 String，则在其上调用 LayoutManager.addLayoutComponent(String,Component)。

如果该组件不是此容器的祖先容器，并且有一个非 null 父组件，则在将该组件添加到此容器之前，从其当前父组件中移除它。

在其他所有添加方法引用此方法时，如果某个程序需要追踪每个添加到容器的请求，那么这就是要重写的方法。被重写的方法通常应该包括一个对该方法的超类版本的调用：

super.addImpl(comp, constraints, index)

覆盖：

类 Container 中的 addImpl

参数：

comp - 要添加的组件

constraints - 表示此组件的布局约束的对象

另请参见：

Container.add(Component), Container.add(Component, int), Container.add(Component, java.lang.Object), LayoutManager, LayoutManager2

remove

public void remove(int index)

从此窗格中移除已索引的组件。这是绝对索引，与层无关。

覆盖：

类 Container 中的 remove

参数：

index - 指定要移除组件的 int 值

另请参见：

getIndexOf(java.awt.Component)

removeAll

public void removeAll()

从此容器中移除所有组件。

覆盖：

类 Container 中的 removeAll

从以下版本开始：

1.5

另请参见：

Container.add(java.awt.Component), Container.remove(int)

isOptimizedDrawingEnabled

public boolean isOptimizedDrawingEnabled()

如果窗格中的组件可以重叠，则返回 false（因为这会导致最优绘制无法进行）。否则返回 true。

覆盖：

类 JComponent 中的 isOptimizedDrawingEnabled

返回：

如果组件可以重叠，则返回 false；否则返回 true

另请参见：

JComponent.isOptimizedDrawingEnabled()

putLayer

public static void putLayer(JComponent c,
                            int layer)

设置 JComponent 上的 layer 属性。此方法不会产生与 setLayer() 类似的副作用（绘制、添加/移除等）。通常，为了获得所需的副作用（如重绘），应该使用实例方法 setLayer()。

参数：

c - 要移动的 JComponent

layer - 一个 int 值，指定要移入的层

另请参见：

setLayer(java.awt.Component, int)

getLayer

public static int getLayer(JComponent c)

获得 JComponent 的 layer 属性，此方法不会产生与 setLayer() 类似的副作用（绘制、添加/移除等）。要获得绘制、添加/移除等功能，通常应该使用实例方法 getLayer()。

参数：

c - 要检查的 JComponent

返回：

指定组件层的 int 值

getLayeredPaneAbove

public static JLayeredPane getLayeredPaneAbove(Component c)

一个便捷方法，它返回包含指定组件的第一个 JLayeredPane。注意，所有 JFrame 在其根部都有一个 JLayeredPane，因此 JFrame 中的任何组件都具有 JLayeredPane 父级。

参数：

c - 要检查的 Component

返回：

包含该组件的 JLayeredPane，如果在组件层次结构中未找到 JLayeredPane，则返回 null

另请参见：

JFrame, JRootPane

setLayer

public void setLayer(Component c,
                     int layer)

设置指定组件的 layer 属性，使之成为该层中最底部的组件。应该在将组件添加到其父组件之前调用该方法。

参数：

c - 要为其设置层的 Component

layer - 一个 int 值，指定要设置的层，其中较低编号更接近底部

setLayer

public void setLayer(Component c,
                     int layer,
                     int position)

为指定组件设置 layer 属性，并设置它在该层中的位置。

参数：

c - 要为其设置层的 Component

layer - 一个 int 值，指定要设置的层，其中较低编号更接近底部

position - 指定层中位置的 int 值，其中 0 表示最顶层位置，-1 表示最底层位置

getLayer

public int getLayer(Component c)

返回指定 Component 的 layer 属性。

参数：

c - 要检查的 Component

返回：

指定组件当前层的 int 值

getIndexOf

public int getIndexOf(Component c)

返回指定 Component 的索引。这是绝对索引，与层无关。索引编号与位置编号一样，索引零表示最顶层组件。较大编号更接近底部。

参数：

c - 要检查的 Component

返回：

指定组件索引的 int 值

moveToFront

public void moveToFront(Component c)

将该组件移到当前层中所有组件的顶层（位置 0）。

参数：

c - 要移动的 Component

另请参见：

setPosition(Component, int)

moveToBack

public void moveToBack(Component c)

将该组件移到当前层中所有组件的底层（位置 -1）。

参数：

c - 要移动的 Component

另请参见：

setPosition(Component, int)

setPosition

public void setPosition(Component c,
                        int position)

将该组件移到当前层中的 position 处，其中 0 表示该层中的最顶层位置，-1 表示最底层位置。

注：位置编号由 java.awt.Container 定义，且与层的编号相反。较低的位置编号更接近顶层（0 为最顶层），较高的位置编号更接近底层。

参数：

c - 要移动的 Component

position - 范围在 -1 到 N-1 之间的 int 值，其中 N 是该组件当前层中的组件数

getPosition

public int getPosition(Component c)

获得该组件在其所在层中的相对位置。

参数：

c - 要检查的 Component

返回：

给出组件位置的一个 int 值，其中 0 表示最顶层位置，且最高索引值等于该层中的组件数减一

另请参见：

getComponentCountInLayer(int)

highestLayer

public int highestLayer()

返回所有当前子组件的最高层值。如果没有子组件，则返回 0。

返回：

一个 int 值，指示窗格中最顶层组件的层，如果没有子组件，则返回 0

lowestLayer

public int lowestLayer()

返回所有当前子组件的最低层值。如果没有子组件，则返回 0。

返回：

一个 int 值，指示窗格中最底层组件的层；如果没有子组件，则返回 0

getComponentCountInLayer

public int getComponentCountInLayer(int layer)

返回指定层中当前的子组件数。

参数：

layer - 一个 int 值，指定要检查的层

返回：

一个 int 值，指定该层中的组件数

getComponentsInLayer

public Component[] getComponentsInLayer(int layer)

返回指定层中组件的数组。

参数：

layer - 一个 int 值，指定要检查的层

返回：

该层中包含的 Component 数组

paint

public void paint(Graphics g)

在指定的图形上下文中绘制此 JLayeredPane。

覆盖：

类 JComponent 中的 paint

参数：

g - 要在其中进行绘制的 Graphics 上下文

另请参见：

JComponent.paintComponent(java.awt.Graphics), JComponent.paintBorder(java.awt.Graphics), JComponent.paintChildren(java.awt.Graphics), JComponent.getComponentGraphics(java.awt.Graphics), JComponent.repaint(long, int, int, int, int)

getComponentToLayer

protected Hashtable<Component,Integer> getComponentToLayer()

返回将组件映射到层的哈希表。

返回：

用于将组件映射到对应层的 Hashtable

getObjectForLayer

protected Integer getObjectForLayer(int layer)

返回与指定层关联的 Integer 对象。

参数：

layer - 指定该层的 int 值

返回：

该层的 Integer 对象

insertIndexForLayer

protected int insertIndexForLayer(int layer,
                                  int position)

一个根据层和位置要求确定插入新子组件的正确位置的基本方法。

参数：

layer - 指定该层的 int 值

position - 指定层中位置的 int 值

返回：

给出（绝对的）插入索引的 int 值

另请参见：

getIndexOf(java.awt.Component)

paramString

protected String paramString()

返回此 JLayeredPane 的字符串表示形式。此方法仅在进行调试的时候使用，对于各个实现，所返回字符串的内容和格式可能有所不同。返回的字符串可能为空，但不可能为 null。

覆盖：

类 JComponent 中的 paramString

返回：

此 JLayeredPane 的字符串表示形式。

getAccessibleContext

public AccessibleContext getAccessibleContext()

获得与此 JLayeredPane 关联的 AccessibleContext。对于分层窗格，AccessibleContext 采用 AccessibleJLayeredPane 的形式。如有必要，将创建一个新的 AccessibleJLayeredPane 实例。

指定者：

接口 Accessible 中的 getAccessibleContext

覆盖：

类 JComponent 中的 getAccessibleContext

返回：

一个 AccessibleJLayeredPane，它充当此 JLayeredPane 的 AccessibleContext

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。