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

    Класс QIcon представляет значки в различных размерах, режимах и состояниях. Обратите внимание, что он не наследует класс QPaintDevice, - следовательно, мы не можем использовать его как поверхность для рисования. Форматы конструктора:

  <Объект> = QIcon()
  <Объект> = QIcon(<Путь к файлу>)
  <Объект> = QIcon(<QPixmap>)
  <Объект> = QIcon(<QIcon>)

    Первый конструктор создает пустой объект значка. Второй конструктор выполняет загрузку значка из файла, причем файл загружается при первой попытке использования, а не сразу. Третий конструктор создает значок на основе экземпляра класса QPixmap, а четвертый - создает копию значка.

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

• isNull () - возвращает значение True, если объект является пустым, и False - в противном случае;

• addFile (<Путь к файлу>[, size=QSize()][, mode=Normal][, state=Off]) - добавляет значок для указанного размера, режима и состояния. Можно добавить несколько значков, вызывая метод с разными значениями параметров. Параметр size задает размер значка в виде экземпляра класса QSize (так как загрузка значка производится при первой попытке использования, заранее размер значка неизвестен, и нам придется задать его явно). В параметре mode можно указать следующие атрибуты класса QIcon:
  • Normal (обычное состояние компонента),
  • Disabled (компонент недоступен),
  • Active (компонент активен) или
  • Selected (компонент выделен - обычно используется для элементов представлений).
  В параметре state указываются атрибуты Off (отключенное состояние) или On (включенное состояние) класса QIcon;

• addPixmap (<QPixmap>[, mode=Normal] [, state=Off]) - добавляет значок для указанного режима и состояния. Значок создается на основе экземпляра класса QPixmap;

• availableSizes ([mode=Normal] [, state=Off]) - возвращает доступные размеры (список с экземплярами класса QSize) значков для указанного режима и состояния;

• actuaisize (<QSize>[, mode=Normal] [, state=Off]) - возвращает фактический размер (экземпляр класса QSize) для указанного размера, режима и состояния. Фактический размер может быть меньше размера, указанного в первом параметре, но не больше;

• pixmap () - возвращает значок (экземпляр класса QPixmap), который примерно соответствует указанному размеру, режиму и состоянию. Форматы метода:

    pixmap(<Ширина>, <Высота>[, mode=Normal] [, state=Off]) 
    pixmap(<Ширина и высота>[, mode=Normal] [, state=Off]) 
    pixmap(<QSize>[, mode=Normal] [, state= Off])
  

      Во втором формате первый параметр задает и ширину, и высоту значка (предполагается, что значок имеет квадратную форму).

    Вместо загрузки значка из файла можно воспользоваться одним из встроенных в PyQt5 стандартных значков. Загрузить стандартный значок позволяет следующий код:

  ico = window.style().standardIcon(QtWidgets.QStyle.SP_MessageBoxCritical)

    Увидеть список всех встроенных значков можно в документации к классу QStyle по адресу: https://doc.qt.io/qt-5/qstyle.html#StandardPixmap-enum.

    Со следующего шага мы начнем рассматривать графическую сцену.

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