Qt 4

4 статичних відкритих члена, успадкованих від QWidget

4 статичних відкритих члена, успадкованих від QObject

39 захищених функцій, успадкованих від QWidget

7 захищених функцій, успадкованих отQObject

Докладний опис

Клас QDialog є базовим класом для діалогових вікон.

Діалогове вікно - це вікно верхнього рівня, призначене, головним чином, для виконання коротких завдань і нетривалих взаємодій з користувачем. QDialogs може бути модальним або НЕ модальним. QDialogs підтримує розширюваність і може надавати значення, що повертається. Діалогові вікна мають кнопку за замовчуванням. QDialog також може мати QSizeGrip в правому-нижньому кутку (налаштовується за використанням setSizeGripEnabled ()).

Зверніть увагу, що QDialog використовує батьківський віджет трохи інакше, ніж інші класи Qt. Діалог - завжди віджет верхнього рівня, але якщо він має батька, то за замовчуванням він розташований поверх і по центру батьківського віджета (якщо він сам не віджет верхнього рівня). Він також доступний через панель задач батька.

модальні Діалоги

Модальний діалог - це діалог, який блокує введення в інші вікна свого додатка. Користувач повинен завершити роботу з діалогом і закрити його перш, ніж отримає доступ до інших вікон програми. Діалоги, що запитують вказівку користувачем імені файлу і встановлюють налаштування програми, зазвичай модальності.

Зазвичай, модальний діалог відображається за допомогою виклику функції exec (). При закритті користувачем діалогу, exec () для зручності надає значення, що повертається. Зазвичай, для закриття діалогу і отримання відповідного вначенія, з'єднують сигнал кнопки по умовчання, наприклад, "OK", зі слотом accept (), а кнопки "Cancel" зі слотом reject (). В якості альтернативи, Ви можете викликати слот done () з Accepted або Rejected.

Також можна викликати setModal (true) або setWindowModality (), а потім show (). На відміну від exec (), show () негайно повертає управління викликає. Виклик setModal (true) особливо корисний для діалогів, що містять смугу прогресу, діалогів, які повинні саме можливість взаємодії з користувачем (наприклад, для скасування довгої операції). Якщо Ви використовуєте show () спільно з setModal (true) то періодично, протягом обробки, повинні викликати QApplication :: processEvents () для забезпечення можливості взаємодії з користувачем. (Див. QProgressDialog.)

немодальні Діалоги

Немодальні діалоги відображаються з використанням функції show (), яка негайно повертає керування викликає.

Кнопка по Замовчуванням

Кнопка діалогу за замовчуванням - це кнопка, яка натискається при натисканні користувачем клавіші клавіатури Enter (Return). Дана кнопка використовується для вказівки того, що користувач приймає установки діалогу і хоче закрити діалог. Для налаштування за замовчуванням використовуються QPushButton :: setDefault (), QPushButton :: isDefault () і QPushButton :: autoDefault ().

клавіша Escape

Якщо користувач натискає клавішу Esc в діалозі, то викликається QDialog :: reject (). Це змушує вікно закритися: Повідомлення про закриття може бути проігноровано.

Можливість розширення

Можливість розширення - це можливість відобразити діалог двома способами: відображення частини діалогу, що містить найбільш часто використовувані опції, і отораженіе повного діалогу, що містить всі опції. Зазвичай, спершу відображається частина розширюваного діалогу, що містить фіксується кнопку "More". Якщо користувач натискає кнопку "More", то відображається повний діалог. Розширюваний віджет змінює розміри в своєму sizeHint (). Якщо його орієнтація дорівнює Qt :: Horizontal то height () расширяемого віджета збільшиться до height () діалогу. Якщо орієнтація дорівнює Qt :: Vertical. то width () расширяемого віджета збільшиться до width () діалогу. Можливість розширення управляється за допомогою setExtension (), setOrientation () і showExtension ().

Що повертається Значення (Модальні Діалоги)

Модальні діалоги частини використовуються в ситуаціях, коли потрібно повертається значення, наприклад, щоб знати, натиснув користувач "OK" або "Cancel". Діалог може бути закритий за допомогою виклику слота accept () або reject (), і тоді exec () поверне Accepted або Rejected відповідно. Виклик exec () повертає результат роботи діалогу. У разі, якщо діалог не був закритий, результат також доступний через result ().