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

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