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