Как Использовать Модальность в Диалоговых окнах

Java™ SE 6 решил вопросы модальности, которые возникли в более ранних версиях платформы. Новая модель модальности включает разработчику к контексту, или пределу, блокированию модальности диалогового окна.

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

• Диалоговое окно — высокоуровневое всплывающее окно с title и границей, которая обычно принимает некоторую форму ввода от пользователя. Диалоговое окно может быть модальным или немодальным. Для получения дополнительной информации о диалоговых окнах, см. Краткий обзор Диалоговых окон в, Как Сделать Диалоговую страницу.
• Модальное диалоговое окно — диалоговое окно, которое блокирует ввод к некоторым другим высокоуровневым окнам в приложении, за исключением окон, создаваемых с диалоговым окном как их владелец. Модальное диалоговое окно получает фокус окна, пока это не закрывается, обычно в ответ на нажатие кнопки.
• Немодальное диалоговое окно — диалоговое окно, которое позволяет Вам работать с другими окнами, в то время как это диалоговое окно показывают.

В Java SE 6 было изменено поведение и модальных и немодальных диалоговых окон так, чтобы они всегда появились и сверху не только их родительских окон и всех блокированных окон также.

Следующие типы модальности поддерживаются в Java SE 6:

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

Дополнительно, можно установить режим исключения модальности:

• Режим исключения — Любое высокоуровневое окно может быть отмечено, чтобы не быть блокированным модальными диалоговыми окнами. Это свойство позволяет Вам установить модальный режим исключения. Dialog.ModalExclusionType перечисление определяет возможные модальные типы исключения.

Пример ModalityDemo демонстрирует первые три из четырех упомянутых выше типов модальности.

Это число было уменьшено, чтобы соответствовать на странице.
Нажмите на изображение, чтобы просмотреть это в его естественном размере.

Следующий фрагмент кода показывает, как создать диалоговые окна различных типов модальности:

//The Book 1 parent frame
f1 = new JFrame("Book 1 (parent frame)");

...

//The modeless dialog box
d2 = new JDialog(f1);

...
        
//The document-modal dialog box
d3 = new JDialog(d2, "", Dialog.ModalityType.DOCUMENT_MODAL);

...

        //The Book2 parent frame
f4 = new JFrame("Book 2 (parent frame)");

...

//The modeless dialog box
d5 = new JDialog(f4);

...

//The document-modality dialog box
d6 = new JDialog(d5, "", Dialog.ModalityType.DOCUMENT_MODAL);
        
...

//The excluded frame
f7 = new JFrame("Classics (excluded frame)");
f7.setModalityExclusionType(Dialog.ModalExclusionType.APPLICATION_EXCLUDED);
        
...

//The Feedback parent frame and Confirm Dialog box
f8 = new JFrame("Feedback (parent frame)");
...

JButton b8 = new JButton("Rate yourself");
b8.addActionListener(new ActionListener() {
    public void actionPerformed(ActionEvent e) {
        JOptionPane.showConfirmationDialog(null,
                                           "I really like my book",
                                           "Question (application-modal dialog)", 
                                           JOptionPane.Yes_NO_OPTION,
                                           JOptionPane.QUESTION_MESSAGE); 
    }
});

Найдите полный код демонстрационного примера в ModalityDemo.java файл.

В Java SE 6 можно создать модальное диалоговое окно документа без родителя. Поскольку Dialog class является подклассом Window class, a Dialog экземпляр автоматически становится корнем документа, если у этого нет никакого владельца. Таким образом, если такое диалоговое окно модально документом, его контекст блокирования пуст, и это ведет себя, как будто это было немодальное диалоговое окно.

API Модальности

JDialog Конструкторы class позволяют Вам создать диалоговые окна различных типов модальности.

Следующая таблица приводит методы, наследованные от java.awt.Dialog class.

Примеры Тот API Модальности Использования

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