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

Вообще, Вы непосредственно не создаете a JRootPane объект. Вместо этого Вы получаете a JRootPane (хотите ли Вы это или нет!), когда Вы инстанцируете JInternalFrame или один из верхнего уровня контейнеры Swing, такой как JApplet, JDialog, и JFrame.

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

Поскольку предыдущие данные показывают, у корневой области есть четыре части:

Стеклянная область

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

Многоуровневая область

Подачи, чтобы расположить его содержание, которое состоит из области контента и дополнительной строки меню. Может также содержать другие компоненты в указанном порядке Z. Для получения информации см. Многоуровневую Область.

Область контента

Контейнер видимых компонентов корневой области, исключая строку меню. Для получения информации об использовании области контента см. Используя Высокоуровневые Контейнеры.

Дополнительная строка меню

Дом для меню контейнера корневой области. Если у контейнера есть строка меню, Вы обычно используете контейнер setJMenuBar метод, чтобы поместить строку меню в соответствующее место. Для получения дополнительной информации об использовании меню и строк меню, см., Как Использовать Меню.

Стеклянная Область

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

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

Следующий код от GlassPaneDemo.java шоу и скрывают стеклянную область. Эта программа, оказывается, создает свою собственную стеклянную область. Однако, если стеклянная область не делает никакого рисования, программа могла бы просто присоединить слушателей области стекла значения по умолчанию, как возвращено getGlassPane.

myGlassPane = new MyGlassPane(...);
changeButton.addItemListener(myGlassPane);
frame.setGlassPane(myGlassPane);
...
class MyGlassPane extends JComponent
                  implements ItemListener {
    ...
    //React to change button clicks.
    public void itemStateChanged(ItemEvent e) {
        setVisible(e.getStateChange() == ItemEvent.SELECTED);
    }
...
}

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

...//In the implementation of the glass pane's mouse listener:
public void mouseMoved(MouseEvent e) {
    redispatchMouseEvent(e, false);
}

.../* The mouseDragged, mouseClicked, mouseEntered,
    * mouseExited, and mousePressed methods have the same
    * implementation as mouseMoved. */...

public void mouseReleased(MouseEvent e) {
    redispatchMouseEvent(e, true);
}

private void redispatchMouseEvent(MouseEvent e,
                                  boolean repaint) {
    Point glassPanePoint = e.getPoint();
    Container container = contentPane;
    Point containerPoint = SwingUtilities.convertPoint(
                                    glassPane,
                                    glassPanePoint,
                                    contentPane);

    if (containerPoint.y < 0) { //we're not in the content pane
        //Could have special code to handle mouse events over
        //the menu bar or non-system window decorations, such as
        //the ones provided by the Java look and feel.
    } else {
        //The mouse event is probably over the content pane.
        //Find out exactly which component it's over.
        Component component =
            SwingUtilities.getDeepestComponentAt(
                                    container,
                                    containerPoint.x,
                                    containerPoint.y);

        if ((component != null)
            && (component.equals(liveButton))) {
            //Forward events over the check box.
            Point componentPoint = SwingUtilities.convertPoint(
                                        glassPane,
                                        glassPanePoint,
                                        component);
            component.dispatchEvent(new MouseEvent(component,
                                                 e.getID(),
                                                 e.getWhen(),
                                                 e.getModifiers(),
                                                 componentPoint.x,
                                                 componentPoint.y,
                                                 e.getClickCount(),
                                                 e.isPopupTrigger()));
        }
    }

    //Update the glass pane if requested.
    if (repaint) {
        glassPane.setPoint(glassPanePoint);
        glassPane.repaint();
    }
}

Вот код в MyGlassPane это реализует рисование.

protected void paintComponent(Graphics g) {
    if (point != null) {
        g.setColor(Color.red);
        g.fillOval(point.x - 10, point.y - 10, 20, 20);
    }
}

Многоуровневая Область

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

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

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

Таблица ниже описывает намеченное использование для каждого уровня и приводит JLayeredPane постоянный, который соответствует каждому уровню:

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

Корневой API Области

Таблицы, которые следуют за списком API для того, чтобы использовать корневые области, стеклянные области, и области контента. Для получения дополнительной информации об использовании областей контента пойдите в Использование Высокоуровневых Контейнеров. Вот таблицы в этом разделе:

• Используя Корневую Область
• Установка или Получение Содержания Корневой Области

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

• Многоуровневый API Области
• API Меню

Примеры тот Корень Использования Области

У каждой программы Swing есть корневая область, но немногие ссылаются на нее непосредственно. Примеры в следующем списке иллюстрируют, как использовать функции JRootPane или стеклянная область. Также см. эти списки:

• Примеры, который Использование Многоуровневые Области
• Примеры то Использование Меню
• Примеры то Использование Фреймы (для примеров использования областей контента)