QWinThumbnailToolBar Class
The QWinThumbnailToolBar class allows manipulating the thumbnail toolbar of a window. More...
Header: | #include <QWinThumbnailToolBar> |
qmake: | QT += winextras |
Since: | Qt 5.2 |
Inherits: | QObject |
Properties
|
|
- 1 property inherited from QObject
Public Functions
QWinThumbnailToolBar(QObject *parent = Q_NULLPTR) | |
~QWinThumbnailToolBar() | |
void | addButton(QWinThumbnailToolButton *button) |
QList<QWinThumbnailToolButton *> | buttons() const |
int | count() const |
QPixmap | iconicLivePreviewPixmap() const |
bool | iconicPixmapNotificationsEnabled() const |
QPixmap | iconicThumbnailPixmap() const |
void | removeButton(QWinThumbnailToolButton *button) |
void | setButtons(const QList<QWinThumbnailToolButton *> &buttons) |
void | setIconicPixmapNotificationsEnabled(bool enabled) |
void | setWindow(QWindow *window) |
QWindow * | window() const |
- 31 public functions inherited from QObject
Public Slots
void | clear() |
void | setIconicLivePreviewPixmap(const QPixmap &) |
void | setIconicThumbnailPixmap(const QPixmap &) |
- 1 public slot inherited from QObject
Signals
- 2 signals inherited from QObject
Additional Inherited Members
Detailed Description
The QWinThumbnailToolBar class allows manipulating the thumbnail toolbar of a window.
Applications can embed a toolbar in the thumbnail of a window, which is shown when hovering over its taskbar icon. A thumbnail toolbar may provide quick access to the commands of a window without requiring the user to restore or activate the window.
The following example code illustrates how to use the functions in the QWinThumbnailToolBar and QWinThumbnailToolButton class to implement a thumbnail toolbar:
QWinThumbnailToolBar *thumbbar = new QWinThumbnailToolBar(widget); thumbbar->setWindow(widget->windowHandle()); QWinThumbnailToolButton *settings = new QWinThumbnailToolButton(thumbbar); settings->setToolTip("Settings"); settings->setIcon(":/settings.png"); settings->setDismissOnClick(true); connect(settings, SIGNAL(clicked()), settingsPage, SLOT(show())); QWinThumbnailToolButton *playPause = new QWinThumbnailToolButton(thumbbar); playPause->setToolTip("Play/Pause"); playPause->setIcon(":/play.png"); connect(playPause, SIGNAL(clicked()), mediaPlayer, SLOT(play())); thumbbar->addButton(settings); thumbbar->addButton(playPause);
See also QWinThumbnailToolButton.
Property Documentation
count : const int
This property holds the number of buttons in the thumbnail toolbar.
Note: The number of buttons is limited to 7
.
Access functions:
int | count() const |
iconicLivePreviewPixmap : QPixmap
This property holds the pixmap for use as a live (peek) preview when tabbing into the application.
This property was introduced in Qt 5.4.
Access functions:
QPixmap | iconicLivePreviewPixmap() const |
void | setIconicLivePreviewPixmap(const QPixmap &) |
iconicPixmapNotificationsEnabled : bool
This property holds whether signals iconicThumbnailPixmapRequested() and iconicLivePreviewPixmapRequested() will be emitted.
This property was introduced in Qt 5.4.
Access functions:
bool | iconicPixmapNotificationsEnabled() const |
void | setIconicPixmapNotificationsEnabled(bool enabled) |
See also QWinThumbnailToolBar::iconicThumbnailPixmap and QWinThumbnailToolBar::iconicLivePreviewPixmap.
iconicThumbnailPixmap : QPixmap
This property holds the pixmap for use as a thumbnail representation.
This property was introduced in Qt 5.4.
Access functions:
QPixmap | iconicThumbnailPixmap() const |
void | setIconicThumbnailPixmap(const QPixmap &) |
See also QWinThumbnailToolBar::iconicPixmapNotificationsEnabled.
window : QWindow *
This property holds the window whose thumbnail toolbar is manipulated.
Access functions:
QWindow * | window() const |
void | setWindow(QWindow *window) |
Member Function Documentation
QWinThumbnailToolBar::QWinThumbnailToolBar(QObject *parent = Q_NULLPTR)
Constructs a QWinThumbnailToolBar with the specified parent.
If parent is an instance of QWindow, it is automatically assigned as the thumbnail toolbar's window.
QWinThumbnailToolBar::~QWinThumbnailToolBar()
Destroys and clears the QWinThumbnailToolBar.
void QWinThumbnailToolBar::addButton(QWinThumbnailToolButton *button)
Adds a button to the thumbnail toolbar.
Note: The number of buttons is limited to 7
.
QList<QWinThumbnailToolButton *> QWinThumbnailToolBar::buttons() const
Returns the list of buttons in the thumbnail toolbar.
See also setButtons().
[slot]
void QWinThumbnailToolBar::clear()
Removes all buttons from the thumbnail toolbar.
[signal]
void QWinThumbnailToolBar::iconicLivePreviewPixmapRequested()
This signal is emitted when the operating system requests a new iconic live preview pixmap, typically when the user ALT-tabs to the application.
This function was introduced in Qt 5.4.
See also iconicLivePreviewPixmap.
[signal]
void QWinThumbnailToolBar::iconicThumbnailPixmapRequested()
This signal is emitted when the operating system requests a new iconic thumbnail pixmap, typically when the thumbnail is shown.
This function was introduced in Qt 5.4.
See also iconicThumbnailPixmap.
void QWinThumbnailToolBar::removeButton(QWinThumbnailToolButton *button)
Removes the button from the thumbnail toolbar.
void QWinThumbnailToolBar::setButtons(const QList<QWinThumbnailToolButton *> &buttons)
Sets the list of buttons in the thumbnail toolbar.
Note: Any existing buttons are replaced.
See also buttons().
© 2017 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.