Как Использовать Разделенные области

A JSplitPane дисплеи два компонента, или рядом или один сверху другого. Перетаскивая делитель, который появляется между компонентами, пользователь может определить, сколько из общей площади разделенной области идет в каждый компонент. Можно разделить экранное пространство среди трех или больше компонентов, вставляя разделенные области разделенных областей, как описано в Разделенных областях Вложения.

Если Вы хотите создать разделенную область с произвольным числом компонентов, следует проверить статью Ганса Мюллера, MultiSplitPane: Разделение Без Вложения.

Вместо того, чтобы добавить компоненты интереса непосредственно для разделенной области, Вы часто помещаете каждый компонент в область прокрутки. Вы тогда помещаете области прокрутки в разделенную область. Это позволяет пользователю просматривать любую часть компонента интереса, не требуя, чтобы компонент, чтобы привести много в рабочее состояние экрана расположил с интервалами или адаптировался к отображению в переменном количестве экранного пространства.

Вот изображение приложения, которое использует разделенную область, чтобы вывести на экран список и изображение рядом:

Ниже код от SplitPaneDemo это создает и устанавливает разделенную область.

//Create a split pane with the two scroll panes in it.
splitPane = new JSplitPane(JSplitPane.HORIZONTAL_SPLIT,
                           listScrollPane, pictureScrollPane);
splitPane.setOneTouchExpandable(true);
splitPane.setDividerLocation(150);

//Provide minimum sizes for the two components in the split pane
Dimension minimumSize = new Dimension(100, 50);
listScrollPane.setMinimumSize(minimumSize);
pictureScrollPane.setMinimumSize(minimumSize);

Конструктор, используемый этим примером, берет три параметра. Первое указывает на направление разделения. Другими параметрами являются эти два компонента, чтобы вставить разделенную область. Обратитесь к Установке Компонентов в Разделенной области для информации о JSplitPane методы, которые устанавливают компоненты динамически.

Разделенная область в этом примере разделяется горизонтально — эти два компонента появляются рядом — как определено JSplitPane.HORIZONTAL_SPLIT параметр конструктору. Разделенная область предоставляет одну другую возможность, определенную с JSplitPane.VERTICAL_SPLIT, это помещает один компонент выше другого. Можно изменить направление разделения после того, как разделенная область была создана с setOrientation метод.

Две маленьких стрелки появляются наверху делителя в разделенной области примера. Эти стрелки, которым позволяют пользователь выйти из строя (и затем развернуть) любой из компонентов одним щелчком. Текущий стиль определяет, появляются ли эти средства управления по умолчанию. В стили Java они выключаются по умолчанию. (Отметьте, что не весь взгляд и чувства поддерживают это.) Пример, превращенный их при использовании setOneTouchExpandable метод.

Диапазон делителя разделенной области определяется частично минимальными размерами компонентов в пределах разделенной области. См. Расположение Делителя и Ограничение его Диапазона для деталей.

Остальная часть этого раздела затрагивает эти темы:

• Установка Компонентов в Разделенной области
• Расположение Делителя и Ограничение его Диапазона
• Разделенные области вложения
• API Разделенной области
• Примеры то Использование Разделенные области

Установка Компонентов в Разделенной области

Программа может установить два компонента разделенной области динамически с этими четырьмя методами:

• setLeftComponent
• setRightComponent
• setTopComponent
• setBottomComponent

Можно использовать любой из этих методов в любое время независимо от текущего направления разделения разделенной области. Звонки setLeftComponent и setTopComponent эквивалентны и устанавливает указанный компонент в главной или левой позиции, в зависимости от текущей ориентации разделения разделенной области. Точно так же звонки setRightComponent и setBottomComponent эквивалентны. Эта замена методов любой компонент уже находится в той позиции с новой.

Как другие контейнеры, JSplitPane поддерживает add метод. Разделенная область помещает первый компонент, добавленный в покинутых или ключевую позицию. Опасность использовать add это, Вы можете inadvertantly вызывать это слишком много раз, когда менеджер по расположению разделенной области выдаст довольно тайно выглядящее исключение. Если Вы используете add метод и разделенная область уже заполняются, Вы сначала должны удалить существующие компоненты с remove.

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

Расположение Делителя и Ограничение Его Диапазона

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

Теперь, когда Вы видели поведение значения по умолчанию разделенных областей, мы можем сказать Вам, что происходит негласно и как можно влиять на него. В этом обсуждении, когда мы обращаемся к привилегированному или минимальному размеру компонента, мы часто имеем в виду привилегированный или минимальный width компонента, если разделенная область является горизонталью, или ее привилегированным или минимальным height, если разделенная область является вертикалью.

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

Разделенная область изменяет размеры веса, имеет значение между 0.0 и 1.0 и определяет, как пространство распределяется между двумя содержавшими компонентами, когда размер разделенной области устанавливается — или программно или пользователем, изменяющим размеры разделенной области (увеличение ее содержания окна, например). Изменять размеры вес разделенной области 0.0 по умолчанию, указывая, что покинутые или размер главного компонента фиксируются, и компонент права или нижней части корректирует свой размер, чтобы соответствовать остающемуся пространству. Установка изменять размеры вес к 0.5 разделениям любое дополнительное или недостающее пространство равномерно между этими двумя компонентами. Установка изменять размеры вес к 1.0 делает право или нижний компонентный размер, остается фиксированной. Изменять размеры вес не имеет никакого эффекта, однако, когда пользователь перетаскивает делитель.

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

Теперь, когда Вы знаете факторы, которые влияют на размер разделенной области и расположение делителя, вот немного правил для того, чтобы заставить их работать хорошо:

• Чтобы гарантировать, что делитель может быть перетащен, когда разделенная область в ее привилегированном размере, удостоверьтесь, что минимальный размер одного или обоих содержавших компонентов меньше чем привилегированный размер содержавшего компонента. Можно установить минимальный размер компонента любой, вызывая setMinimumSize на этом или переопределяя getMinimumSize метод. Например, если Вы хотите, чтобы пользователь был в состоянии перетащить делитель полностью обеим сторонам:

  Dimension minimumSize = new Dimension(0, 0);
  leftComponent.setMinimumSize(minimumSize);
  rightComponent.setMinimumSize(minimumSize);
  

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

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

• Если Вы хотите, чтобы нижняя часть или правильный компонент остались тот же самый размер и главный или левый компонент, чтобы быть гибкими, когда разделенная область становится больше, набор изменять размеры вес к 1.0. Можно сделать это, вызывая setResizeWeight:

  splitPane.setResizeWeight(1.0);
  

• Если Вы хотите, чтобы обе половины разделенной области совместно использовали в дополнительном или удаленном пространстве разделенной области, установите изменять размеры вес в 0.5:

  splitPane.setResizeWeight(0.5);
  

• Удостоверьтесь, что у каждого компонента, содержавшего разделенной областью, есть разумный привилегированный размер. Если компонент является панелью, которая использует менеджера по расположению, можно обычно только использовать значение, которое он возвращает. Если компонент является областью прокрутки, у Вас есть несколько вариантов. Можно вызвать setPreferredSize метод на области прокрутки, вызовите соответствующий метод на компонент в области прокрутки (такой как setVisibleRowCount метод для JList или JTree).
• Удостоверьтесь, что каждый компонент, содержавший разделенной областью, может вывести на экран себя разумно в переменном количестве пространства. Например, панели, которые содержат многократные компоненты, должны использовать менеджеров по расположению, которые используют дополнительное пространство разумным способом.
• Если Вы хотите установить размер содержавших компонентов к чему-то другому чем их привилегированные размеры, используйте setDividerLocation метод. Например, чтобы сделать левый компонент 150 широкими пикселями:

  splitPane.setDividerLocation(150 + splitPane.getInsets().left);
  

  Хотя разделенная область прилагает все усилия, чтобы соблюдать начальное расположение делителя (150 в этом случае), как только пользователь перетаскивает делитель, больше, возможно, не возможно перетащить к программно указанному размеру.

  Сделать правильный компонент 150 пикселями широкий:

  splitPane.setDividerLocation(splitPane.getSize().width
                               - splitPane.getInsets().right
                               - splitPane.getDividerSize()
                               - 150);
  

  Если разделенная область уже видима, можно установить расположение делителя как процент разделенной области. Например, чтобы заставить 25 % пространства пойти в левый/главный:

  splitPane.setDividerLocation(0.25);
  

  Отметьте, что это реализуется с точки зрения текущего размера и поэтому действительно ony полезно, если разделенная область видима.

• Чтобы разметить разделенную область, как будто это только подходило, вероятно повторно располагая делитель в процессе, вызывают resetToPreferredSizes() на разделенной области.

  ---

  Отметьте: Только изменяя привилегированные размеры содержавших компонентов — даже если Вы вызываете revalidate впоследствии — недостаточно, чтобы заставить разделенную область размечать себя снова. Следует вызвать resetToPreferredSizes также.

  ---

Следующий снимок показывает пример под названием SplitPaneDividerDemo, который демонстрирует компонентные размеры разделенной области и размещение делителя.

Как SplitPaneDemo, SplitPaneDividerDemo обладает горизонтальной разделенной областью с кнопками с одним касанием. У SplitPaneDividerDemo есть следующие дополнительные функции:

• Разделенная область изменяет размеры веса, явно устанавливается (в 0.5).
• Разделенная область выводится на экран в ее значении по умолчанию предпочтенный размер.
• Кнопка сброса у основания окна вызывает resetToPreferredSizes на разделенной области.
• Компоненты в разделенной области являются экземплярами пользовательского JComponent подкласс вызывают SizeDisplayer. A SizeDisplayer выводит на экран дополнительный текст на фоне увядшего (и также дополнительный) изображение. Что еще более важно у этого есть прямоугольники, которые показывают его привилегированные и минимальные размеры.
• SplitPaneDividerDemo устанавливает SizeDisplayers, чтобы иметь равные привилегированные размеры (из-за одинаково больших изображений они показывают), но неравные минимальные размеры.

Вот код, который создает GUI для SplitPaneDividerDemo:

public class SplitPaneDividerDemo extends JPanel ... {

    private JSplitPane splitPane;
   
    public SplitPaneDividerDemo() {
        super(new BorderLayout());

        Font font = new Font("Serif", Font.ITALIC, 24);

        ImageIcon icon = createImageIcon("images/Cat.gif");
        SizeDisplayer sd1 = new SizeDisplayer("left", icon);
        sd1.setMinimumSize(new Dimension(30,30));
        sd1.setFont(font);
        
        icon = createImageIcon("images/Dog.gif");
        SizeDisplayer sd2 = new SizeDisplayer("right", icon);
        sd2.setMinimumSize(new Dimension(60,60));
        sd2.setFont(font);
        
        splitPane = new JSplitPane(JSplitPane.HORIZONTAL_SPLIT,
                                   sd1, sd2);
        splitPane.setResizeWeight(0.5);
        splitPane.setOneTouchExpandable(true);
        splitPane.setContinuousLayout(true);

        add(splitPane, BorderLayout.CENTER);
        add(createControlPanel(), BorderLayout.PAGE_END);
    }
    ...
}

Код справедливо сам объяснительный, кроме, возможно, для звонка setContinuousLayout. Установка continuousLayout свойства к истине заставляет содержание разделенной области быть нарисованным непрерывно, в то время как пользователь перемещает делитель. Непрерывное расположение не включено, по умолчанию, потому что оно может оказать отрицательное влияние производительности. Однако, имеет смысл использовать это в этом демонстрационном примере, когда наличие компонентов разделенной области, настолько актуальных насколько возможно, может улучшить пользовательский опыт.

Разделенные области вложения

Вот изображение программы, которая достигает разделения с тремя путями вложением одна разделенная область в другом:

Если главная часть разделенной области выглядит знакомой Вам, это - потому что программа помещает разделенную область, создаваемую SplitPaneDemo во второй разделенной области. Простое JLabel другой компонент во второй разделенной области. Это не наиболее практическое применение вложенной разделенной области, но оно понимает через.

• Нажмите кнопку Launch, чтобы работать, SplitPaneDemo2, используя Сеть Java™ Запускаются (загрузите JDK 6 или позже). Альтернативно, чтобы скомпилировать и выполнить пример самостоятельно, консультируйтесь, пример индексируют.

Вот интересная часть кода, в котором можно найти SplitPaneDemo2.java:

//Create an instance of SplitPaneDemo
SplitPaneDemo splitPaneDemo = new SplitPaneDemo();
JSplitPane top = splitPaneDemo.getSplitPane();

...
//Create a regular old label
label = new JLabel("Click on an image name in the list.",
                   JLabel.CENTER);

//Create a split pane and put "top" (a split pane)
//and JLabel instance in it.
JSplitPane splitPane = new JSplitPane(JSplitPane.VERTICAL_SPLIT,
                                      top, label);

Обратитесь к Решению Общих Компонентных проблем для информации о решении проблемы границы, которая может появиться когда разделенные области вложения.

API Разделенной области

Следующие таблицы приводят обычно используемый JSplitPane конструкторы и методы. Другие методы Вы, наиболее вероятно, вызовете на a JSplitPane объект - те такой как setPreferredSize то, что его суперклассы обеспечивают. См. API JComponent для таблиц обычно используемых наследованных методов.

API для того, чтобы использовать списки попадает в эти категории:

• Установка Разделенной области
• Управление Содержанием Разделенной области
• Расположение Делителя

Примеры то Использование Разделенные области

Эта таблица показывает некоторые примеры то использование JSplitPane и где те примеры описываются.