Класс QWinTaskbarButton
Класс QWinTaskbarButton представляет собой кнопку панели задач Windows для окна верхнего уровня (Windows 7 и новее). Подробнее...
| Заголовок: | #include <QWinTaskbarButton> |
| qmake: | QT += winextras |
| С момента: | Qt 5.2 |
| Наследует: | QObject |
Этот класс был представлен в Qt 5.2.
Свойства
- overlayAccessibleDescription : QString
- overlayIcon : QIcon
- progress : QWinTaskbarProgress* const
- window : QWindow*
Открытые функции
| QWinTaskbarButton(QObject *parent = nullptr) | |
| virtual | ~QWinTaskbarButton() |
| QString | overlayAccessibleDescription() const |
| QIcon | overlayIcon() const |
| QWinTaskbarProgress * | progress() const |
| void | setWindow(QWindow *window) |
| QWindow * | window() const |
Открытые слоты
| void | clearOverlayIcon() |
| void | setOverlayAccessibleDescription(const QString &description) |
| void | setOverlayIcon(const QIcon &icon) |
Подробное описание
Класс 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.
Документация свойств
overlayAccessibleDescription : QString
Это свойство содержит описание наложения для целей доступности
Функции доступа:
| QString | overlayAccessibleDescription() const |
| void | setOverlayAccessibleDescription(const QString &description) |
См. также overlayIcon.
overlayIcon : QIcon
Это свойство содержит значок наложения кнопки панели задач
Функции доступа:
| QIcon | overlayIcon() const |
| void | setOverlayIcon(const QIcon &icon) |
| void | clearOverlayIcon() |
progress : QWinTaskbarProgress* const
Это свойство содержит индикатор выполнения кнопки панели задач
Примечание: Индикатор выполнения по умолчанию не видим.
Функции доступа:
| QWinTaskbarProgress * | progress() const |
window : QWindow*
Это свойство содержит окно, кнопка панели задач которого изменяется
Функции доступа:
| QWindow * | window() const |
| void | setWindow(QWindow *window) |
Документация по функциям-членам
QWinTaskbarButton::QWinTaskbarButton(QObject *parent = nullptr)
Создает QWinTaskbarButton со заданным parent.
Если parent является экземпляром QWindow, он автоматически назначается как window кнопки панели задач.
[virtual] QWinTaskbarButton::~QWinTaskbarButton()
Удаляет QWinTaskbarButton.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.14/qwintaskbarbutton.html