Класс StackPane

Порядок z-индекса элементов определяется порядком в списке дочерних элементов, где 0-й элемент находится внизу, а последний — сверху. Если установлены отступ и/или отступы, дочерние элементы будут выстраиваться в этих отступах.

Stackpane попытается переразмерить каждый дочерний элемент так, чтобы он заполнил область содержимого. Если размер дочернего элемента нельзя изменить на размер Stackpane (из-за того, что он не изменяемый или его максимальный размер этого не позволяет), то он будет выровнен в области с использованием свойства выравнивания, которое по умолчанию равно Pos.CENTER.

Пример StackPane:

     StackPane stack = new StackPane();
     stack.getChildren().addAll(new Rectangle(100,100,Color.BLUE), new Label("Go!"));
 

StackPane выстраивает каждый управляемый дочерний элемент независимо от значения свойства visible дочернего элемента; неуправляемые элементы игнорируются.

StackPane может быть стилизован с помощью фонов и границ с использованием CSS. Подробности см. в Region.

Диапазон изменения размера

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

Неограниченная максимальная ширина и высота Stackpane — это указание для родительского элемента, что он может быть изменен размером, превышающим его предпочтительный размер, чтобы заполнить предоставленное ему пространство.

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

     // ensure stackpane is never resized beyond it's preferred size
     stackpane.setMaxSize(Region.USE_PREF_SIZE, Region.USE_PREF_SIZE);
 

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

Дополнительные ограничения макета

Приложение может установить ограничения на отдельные дочерние элементы для настройки макета StackPane. Для каждого ограничения StackPane предоставляет статический метод для его установки на дочерний элемент.

Примеры:

     // Align the title Label at the bottom-center of the stackpane
     Label title = new Label();
     StackPane.setAlignment(title, Pos.BOTTOM_CENTER);
     stackpane.getChildren.addAll(new ImageView(...), title);

     // Create an 8 pixel margin around a listview in the stackpane
     ListView list = new ListView();
     StackPane.setMargin(list, new Insets(8,8,8,8);
     stackpane.getChildren().add(list);