@DefaultProperty("children")
public class Pane
extends Region

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

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

     Pane canvas = new Pane();
     canvas.setStyle("-fx-background-color: black;");
     canvas.setPrefSize(200,200);
     Circle circle = new Circle(50,Color.BLUE);
     circle.relocate(20, 20);
     Rectangle rectangle = new Rectangle(100,100,Color.RED);
     rectangle.relocate(70,70);
     canvas.getChildren().addAll(circle,rectangle);
 

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

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

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

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

Таблица изменения размера Pane

	ширина	высота
минимальное	левый плюс правый отступы.	верхний плюс нижний отступы.
предпочтительное	ширина, необходимая для охвата каждого дочернего элемента в его текущем x-положении и предпочтительной ширине.	высота, необходимая для охвата каждого дочернего элемента в его текущем y-положении и предпочтительной высоте.
максимальное	Double.MAX_VALUE	Double.MAX_VALUE

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

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

     pane.setPrefSize(500,400);
 

Приложения могут восстановить вычисленные значения, установив эти свойства обратно в Region.USE_COMPUTED_SIZE.

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