На этом шаге мы рассмотрим назначение этого класса, иерархию наследования, форматы конструктора.
Класс QMessageBox реализует стандартные окна-предупреждения для вывода сообщений. Иерархия наследования:
(QObject, QPaintDevice) - QWidget - QDialog - QMessageBox
Форматы конструктора класса QMessageBox:
<Объект> = QMessageBox([parent=None]) <Объект> = QMessageBox(<Иконка>, <Текст заголовка>, <Текст сообщения>[, buttons=NoButton][, parent=None][, flags=Dialog | MSWindowsFixedSizeDialogHint])
Если в параметре parent указана ссылка на родительское окно, диалоговое окно будет центрироваться относительно родительского окна, а не относительно экрана. Параметр flags задает тип окна (см. 25 шаг). В параметре <Иконка> могут быть указаны следующие атрибуты класса QMessageBox:
- NoIcon (или 0) - нет значка;
- Question (или 4) - значок со знаком вопроса;
- Information (или 1) - значок информационного сообщения;
- Warning (или 2) - значок предупреждающего сообщения;
- Critical (или 3) - значок критического сообщения.
В параметре buttons указываются следующие атрибуты (или их комбинация через оператор |) класса QMessageBox:
- NoButton - кнопки не установлены;
- Ok - кнопка ОК с ролью AcceptRole;
- Cancel - кнопка Cancel с ролью RejectRole;
- Yes - кнопка Yes с ролью YesRole;
- YesToAll - кнопка Yes to All с ролью YesRole;
- No - кнопка No с ролью NoRole;
- NoToAll - кнопка No to All с ролью NoRole;
- Open - кнопка Open с ролью AcceptRole;
- Close - кнопка Close с ролью RejectRole;
- Save - кнопка Save с ролью AcceptRole;
- SaveAll - кнопка Save All с ролью AcceptRole;
- Discard - кнопка Discard или Don't Save (надпись на кнопке зависит от операционной системы) с ролью DestructiveRole;
- Apply - кнопка Apply с ролью ApplyRole;
- Reset - кнопка Reset с ролью ResetRole;
- RestoreDefaults - кнопка Restore Defaults с ролью ResetRole;
- Help - кнопка Help с ролью HelpRole;
- Abort - кнопка Abort с ролью RejectRole;
- Retry - кнопка Retry с ролью AcceptRole;
- Ignore - кнопка Ignore с ролью AcceptRole.
После создания экземпляра класса следует вызвать метод exec() (или оставленный для совместимости со старыми версиями PyQt метод ехес_(), чтобы вывести окно на экран. Метод возвращает числовое обозначение нажатой кнопки. Пример:
dialog = QtWidgets.QMessageBox(QtWidgets.QMessageBox.Critical,
"Текст заголовка",
"Текст сообщения",
buttons=QtWidgets.QMessageBox.Ok QtWidgets.QMessageBox.Cancel,
parent=window)
result = dialog.exec()
На следующем шаге мы рассмотрим основные методы и сигналы.
