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

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