Класс JLayeredPane

@JavaBean(defaultProperty="accessibleContext")
public class JLayeredPane
extends JComponent
implements Accessible

JLayeredPane добавляет глубину контейнеру JFC/Swing, позволяя компонентам перекрывать друг друга при необходимости. Объект Integer указывает глубину каждого компонента в контейнере, где компоненты с более высокими номерами располагаются «сверху» других компонентов. Для получения документации по задачам и примеров использования слоистых панелей см. Как использовать слоистую панель — раздел в Руководстве Java.

Для удобства, JLayeredPane разбивает диапазон глубин на несколько различных слоев. Размещение компонента в одном из этих слоев упрощает обеспечение правильного перекрытия компонентов без необходимости указания чисел для конкретных глубин:

DEFAULT_LAYER

Стандартный слой, в котором находятся большинство компонентов. Это самый нижний слой.

PALETTE_LAYER

Слой палитры расположится над стандартным слоем. Полезно для плавающих панелей инструментов и палитр, чтобы их можно было расположить над другими компонентами.

MODAL_LAYER

Слой, используемый для модальных диалогов. Они будут отображаться поверх любых панелей инструментов, палитр или стандартных компонентов в контейнере.

POPUP_LAYER

Слой всплывающих окон отображается поверх диалогов. Таким образом, всплывающие окна, связанные с раскрывающимися списками, подсказками и другими текстовыми подсказками, будут отображаться поверх компонента, палитры или диалога, который их сгенерировал.

DRAG_LAYER

При перетаскивании компонента его переназначение на слой перетаскивания гарантирует, что он расположен поверх всех остальных компонентов в контейнере. По завершении перетаскивания он может быть переназначен на свой обычный слой.

Методы JLayeredPane moveToFront(Component), moveToBack(Component) и setPosition могут использоваться для изменения положения компонента в пределах его слоя. Метод setLayer также может использоваться для изменения текущего слоя компонента.

Детали

JLayeredPane управляет списком своих дочерних элементов, как и Container, но позволяет определить несколько слоев внутри себя. Дочерние элементы в одном слое управляются точно так же, как обычный объект Container, с добавлением функции, что при перекрытии дочерних компонентов дочерние элементы в верхних слоях отображаются поверх дочерних элементов в нижних слоях.

Каждый слой — это отдельное целое число. Атрибут слоя можно установить на Component, передав объект Integer во время вызова add.

Например:

layeredPane.add(child, JLayeredPane.DEFAULT_LAYER);
 or
     layeredPane.add(child, Integer.valueOf.valueOf(10));

Атрибут слоя также можно установить на компоненте, вызвав

layeredPaneParent.setLayer(child, 10)

на JLayeredPane, являющемся родителем компонента. Слой следует установить до добавления дочернего элемента к родителю.

Слои с более высокими номерами отображаются поверх слоев с более низкими номерами. Таким образом, используя числа для слоев и буквы для отдельных компонентов, представительный порядок списка будет выглядеть следующим образом:

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

где компоненты слева находятся ближе к верху дисплея.

Компонент можно переместить в верхнее или нижнее положение в пределах своего слоя, вызвав moveToFront или moveToBack.

Положение компонента в слое также можно указать непосредственно. Допустимые позиции варьируются от 0 до значения, на единицу меньше количества компонентов в данном слое. Значение -1 указывает самое нижнее положение. Значение 0 указывает самое верхнее положение. В отличие от номеров слоев, более высокие значения позиции находятся ниже на дисплее.

Note: This sequence (defined by java.awt.Container) is the reverse of the layer numbering sequence. Usually though, you will use moveToFront, moveToBack, and setLayer.

Вот несколько примеров, использующих метод add(Component, layer, position): Вызов add(5x, 5, -1) приводит к:

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

Вызов add(5z, 5, 2) приводит к:

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

Вызов add(3a, 3, 7) приводит к:

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

Использование обычных механизмов рисования/событий приводит к тому, что 1a отображается внизу, а 5a — над всеми остальными компонентами.

Примечание: Эти слои представляют собой всего лишь логическую конструкцию, и LayoutManagers будут влиять на все дочерние компоненты этого контейнера без учета настроек слоев.

Предупреждение: Swing не потокобезопасен. Более подробная информация приведена в Политике потоков Swing.

Предупреждение: Сериализованные объекты этого класса не будут совместимы с будущими выпусками Swing. Текущая поддержка сериализации подходит для краткосрочного хранения или RMI между приложениями, использующими одну и ту же версию Swing. Начиная с 1.4, поддержка долгосрочного хранения всех JavaBeans™ была добавлена в пакет java.beans. Пожалуйста, обратитесь к XMLEncoder.