Класс QWinTaskbarButton

Класс QWinTaskbarButton представляет собой кнопку панели задач Windows для окна верхнего уровня (Windows 7 и новее). Подробнее...

Этот класс был представлен в Qt 5.2.

• Список всех членов, включая унаследованные

Свойства

• overlayAccessibleDescription : QString
• overlayIcon : QIcon
• progress : QWinTaskbarProgress* const
• window : QWindow*

Открытые функции

Открытые слоты

Подробное описание

Класс QWinTaskbarButton позволяет устанавливать наложения иконок на кнопку панели задач и обеспечивает доступ к его индикатору прогресса.

Наложение значка указывает на изменение состояния приложения, а индикатор прогресса показывает, как продвигаются трудоемкие задачи.

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

    QWinTaskbarButton *button = new QWinTaskbarButton(widget);
    button->setWindow(widget->windowHandle());
    button->setOverlayIcon(QIcon(":/loading.png"));

    QWinTaskbarProgress *progress = button->progress();
    progress->setVisible(true);
    progress->setValue(50);

Примечание: QWidget::windowHandle() возвращает допустимый экземпляр QWindow только после отображения виджета. Поэтому рекомендуется отложить инициализацию экземпляров QWinTaskbarButton до QWidget::showEvent().

Примечание: Класс оборачивает API, доступный только начиная с Windows 7. Его создание в Windows XP или Windows Vista вызывает предупреждение во время выполнения.

См. также QWinTaskbarProgress.

Документация по функциям-членам

QWinTaskbarButton::QWinTaskbarButton(QObject *parent = nullptr)

Конструирует QWinTaskbarButton со указанным parent.

Если parent является экземпляром QWindow, он автоматически назначается как окно кнопки панели задач window.

[virtual] QWinTaskbarButton::~QWinTaskbarButton()

Удаляет QWinTaskbarButton.