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