Класс SplitPane

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

Nodes могут располагаться рядом друг с другом по горизонтали или стопкой по вертикали. Это можно контролировать, установив orientationProperty().

Разделители в SplitPane ведут себя следующим образом

• Разделители не могут перекрывать друг друга
• Разделители не могут перекрывать узел.
• Разделители, перемещающиеся влево/вверх, остановятся, когда будет достигнут минимальный размер узла.
• Разделители, перемещающиеся вправо/вниз, остановятся, когда будет достигнут максимальный размер узла.

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

Положение разделителя находится в диапазоне от 0 до 1.0 (включительно). Положение 0 поместит разделитель на самый левый/верхний край SplitPane плюс минимальный размер узла. Положение 1.0 поместит разделитель на самый правый/нижний край SplitPane минус минимальный размер узла. Положение разделителя 0.5 поместит разделитель по центру SplitPane. Установка положения разделителя больше, чем максимальное положение размера узла, приведет к установке разделителя в максимальном положении размера узла. Установка положения разделителя меньше, чем минимальное положение размера узла, приведет к установке разделителя в минимальном положении размера узла. Следовательно, значение, установленное в setDividerPosition(int, double) и setDividerPositions(double...), может не совпадать со значением, возвращаемым getDividerPositions().

Если в SplitPane более двух узлов и позиции разделителей установлены таким образом, что разделители не могут поместиться в узлы, разделители будут автоматически скорректированы SplitPane.

Например, у нас есть три узла, размеры и позиции разделителей которых

 Node 1: min 25 max 100
 Node 2: min 100 max 200
 Node 3: min 25 max 50
 divider 1: 0.40
 divider 2: 0.45
 

Результат: размер узла 1 будет его предпочтительным размером, положение разделителя 1 будет 0.40, размер узла 2 будет его минимальным размером, положение разделителя 2 будет минимальным размером узла 2 плюс положение разделителя 1, а оставшееся пространство будет предоставлено узлу 3.

SplitPane устанавливает focusTraversable в false.

Пример:

 SplitPane sp = new SplitPane();
 final StackPane sp1 = new StackPane();
 sp1.getChildren().add(new Button("Button One"));
 final StackPane sp2 = new StackPane();
 sp2.getChildren().add(new Button("Button Two"));
 final StackPane sp3 = new StackPane();
 sp3.getChildren().add(new Button("Button Three"));
 sp.getItems().addAll(sp1, sp2, sp3);
 sp.setDividerPositions(0.3f, 0.6f, 0.9f);