Класс Pane

@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.

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

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

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

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

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

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

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

     pane.setPrefSize(500,400);
 

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

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