内容

• 特性
• 公共函数
• 公共槽
• 静态公共成员
• 详细描述

QWinTaskbarButton 类

The QWinTaskbarButton class represents the Windows taskbar button for a top-level window (Windows 7 and newer). 更多...

头：	#include <QWinTaskbarButton>
qmake:	QT += winextras
Since:	Qt 5.2
继承：	QObject

• 所有成员列表，包括继承成员
• 过时成员

特性

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

• 1 特性继承自 QObject

公共函数

	QWinTaskbarButton (QObject * parent = nullptr)
virtual	~QWinTaskbarButton ()
QString	overlayAccessibleDescription () const
QIcon	overlayIcon () const
QWinTaskbarProgress *	progress () const
void	setWindow (QWindow * window )
QWindow *	window () const

• 31 公共函数继承自 QObject

公共槽

void	clearOverlayIcon ()
void	setOverlayAccessibleDescription (const QString & description )
void	setOverlayIcon (const QIcon & icon )

• 1 公共槽继承自 QObject

静态公共成员

const QMetaObject

staticMetaObject

• 9 静态公共成员继承自 QObject

额外继承成员

• 2 信号继承自 QObject
• 9 保护函数继承自 QObject

详细描述

The QWinTaskbarButton class represents the Windows taskbar button for a top-level window (Windows 7 and newer).

The QWinTaskbarButton class enables you to set overlay icons on a taskbar button, and provides access to its progress indicator.

An overlay icon indicates change in the state of an application, whereas a progress indicator shows how time-consuming tasks are progressing.

以下范例代码阐明如何使用 QWinTaskbarButton and 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 () returns a valid instance of a QWindow only after the widget has been shown. It is therefore recommended to delay the initialization of the QWinTaskbarButton instances until QWidget::showEvent ().

注意： The class wraps API only available since Windows 7. Instantiating it on Windows XP or Windows Vista causes a runtime warning.

另请参阅 QWinTaskbarProgress .

特性文档编制

overlayAccessibleDescription : QString

This property holds the description of the overlay for accessibility purposes

访问函数：

QString	overlayAccessibleDescription () const
void	setOverlayAccessibleDescription (const QString & description )

另请参阅 overlayIcon .

overlayIcon : QIcon

This property holds the overlay icon of the taskbar button

访问函数：

QIcon	overlayIcon () const
void	setOverlayIcon (const QIcon & icon )
void	clearOverlayIcon ()

progress : QWinTaskbarProgress * const

此特性保持任务栏按钮的进度指示器

注意： 进度指示器不 visible 在默认情况下。

访问函数：

QWinTaskbarProgress *

progress () const

window : QWindow *

此特性保持操纵任务栏按钮的窗口

访问函数：

QWindow *	window () const
void	setWindow (QWindow * window )

成员函数文档编制

QWinTaskbarButton:: QWinTaskbarButton ( QObject * parent = nullptr)

构造 QWinTaskbarButton 采用指定 parent .

若 parent 是实例 QWindow ，将被自动赋值作为任务栏按钮的 window .

[虚拟] QWinTaskbarButton:: ~QWinTaskbarButton ()

销毁 QWinTaskbarButton .