Шаг 244.
Библиотека PyQt5.
Диалоговые окна. Класс QMessageBox. Основные методы и сигналы

    На этом шаге мы рассмотрим перечислим основные методы и сигналы этого класса.

    Класс QMessageBox наследует все методы базовых классов и поддерживает следующие дополнительные методы (полный их список приведен на странице https://doc.qt.io/qt-5/qmessagebox.html):

• setIcon (<Иконка>) - устанавливает стандартный значок;

• setIconPixmap (<QPixmap>) - устанавливает пользовательский значок. В качестве параметра указывается экземпляр класса QPixmap;

• setWindowTitle (<Teкст заголовка>) - задает текст заголовка окна;

• setText (<Текст сообщения>) - задает текст сообщения. Можно указать как обычный текст, так и текст в формате HTML. Перенос строки в обычной строке осуществляется с помощью символа \n, а в строке в формате HTML - с помощью тега <br>;

• setInformativeText (<Текст>) - задает дополнительный текст сообщения, который отображается под обычным текстом сообщения. Можно указать как обычный текст, так и HTML-код;

• setDetailedText (<Текст>) - задает текст подробного описания сообщения. Если он задан, в окно будет добавлена кнопка Show Details, с помощью которой можно отобразить скрытую панель с подробным описанием;

• setTextFormat (<Режим>) - задает режим отображения текста сообщения. Могут быть указаны следующие атрибуты класса QtCore.Qt:
  • PlainText (или 0) - простой текст;
  • RichText (или 1) - форматированный текст;
  • AutoText (или 2) - автоматическое определение (режим по умолчанию). Если текст содержит HTML-теги, то используется режим RichText, в противном случае - режим PlainText;

• setStandardButtons (<Стандартные кнопки>) - добавляет стандартные кнопки. Пример:

    dialog.setStandardButtons(QtWidgets.QMessageBox.Ok | 
       QtWidgets.QMessageBox.Cancel)
  

• addButton () - добавляет кнопку в окно. Форматы метода:

    addButton(<Стандартная кнопка>) 
    addButton(<Текст>, <Роль>) 
    addButton(<QAbstractButton>, <Роль>)
  

      Первый формат добавляет стандартную кнопку или кнопки - значение параметра должно быть одним из рассмотренных ранее атрибутов класса QMessageBox или их комбинацией через оператор |. Второй формат принимает в качестве первого параметра надпись для добавляемой кнопки, а в качестве второго - ее роль. Третий формат принимает добавляемую кнопку в виде экземпляра одного из классов-потомков класса QAbstractButton - как правило, класса QPushButton, представляющего обычную кнопку.

      В качестве роли указывается один из следующих атрибутов класса QMessageBox:

  • InvalidRole (или -1) - ошибочная роль;
  • AcceptRole (или 0) - нажатие кнопки устанавливает код возврата равным значению атрибута Accepted;
  • RejectRole (или 1) - нажатие кнопки устанавливает код возврата равным значению атрибута Rejected;
  • DestructiveRole (или 2) - кнопка для отказа от изменений;
  • ActionRole (или 3) - нажатие кнопки приводит к выполнению операции, которая не связана с закрытием окна;
  • HelpRole (или 4) - кнопка для отображения справки;
  • YesRole (или 5) - кнопка Yes;
  • NoRole (или 6) - кнопка No;
  • ResetRole (или 7) - кнопка для установки значений по умолчанию;
  • ApplyRole (или 8) - кнопка для принятия изменений.

      Если роль недействительна, кнопка добавлена не будет.

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

    btnYes = QtWidgets.QPushButton("&Да")
    dialog.addButton(btnYes, QtWidgets.QMessageBox.AcceptRole)
    btnNo = dialog.addButton("&Нет", QtWidgets.QMessageBox.RejectRole)
    btnCancel = dialog.addButton(QtWidgets.QMessageBox.Cancel)
  

• setDefaultButton () - задает кнопку по умолчанию, которая сработает при нажатии клавиши Enter. Форматы метода:

    setDefaultButton(<Стандартная кнопка>) 
    setDefaultButton(<QPushButton>)
  

• setEscapeButton () - задает кнопку, которая сработает при нажатии клавиши Esc. Форматы метода:

    setEscapeButton(<Стандартная кнопка>) 
    setEscapeButton(<QAbstractButton>)
  

• setCheckBox (<QCheckBox>) - задает флажок, который будет выводиться в окне. Чтобы убрать заданный ранее флажок, нужно передать значение None;

• checkBox () - возвращает заданный в методе setCheckBox() флажок или None, если такового нет;

• clickedButton () - возвращает ссылку на кнопку, которая была нажата, или значение None;

• button (<Стандартная кнопка>) - возвращает ссылку на стандартную кнопку, соответствующую указанному обозначению, или None, если такой стандартной кнопки нет;

• standardButton (<QAbstractButton>) - возвращает обозначение стандартной кнопки, переданной в качестве параметра, или значение атрибута NoButton, если такой кнопки в контейнере нет;

• buttonRole (<QAbstractButton>) - возвращает роль указанной в параметре кнопки. Если такая кнопка отсутствует, метод возвращает значение атрибута invalidRole;

• buttons () - возвращает список со ссылками на все кнопки, которые были добавлены в окно;

• standardButtons () - возвращает комбинацию обозначений всех стандартных кнопок, добавленных в окно;

• removeButton (<QAbstractButton>) - удаляет кнопку из окна, при этом не удаляя объект кнопки.

    Класс QMessageBox поддерживает сигнал buttonClicked(<QAbstractButton>), генерируемый при нажатии кнопки в окне. Внутри обработчика через параметр доступна ссылка на нажатую кнопку.

    На следующем шаге мы рассмотрим окно информационного сообщения.

Предыдущий шаг Содержание Следующий шаг