Класс 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);