/**************************************************************************** ** ** Copyright (C) 2013 Ivan Vizir ** Copyright (C) 2015 The Qt Company Ltd. ** Contact: http://www.qt.io/licensing/ ** ** This file is part of the QtWinExtras module of the Qt Toolkit. ** ** $QT_BEGIN_LICENSE:LGPL21$ ** Commercial License Usage ** Licensees holding valid commercial Qt licenses may use this file in ** accordance with the commercial license agreement provided with the ** Software or, alternatively, in accordance with the terms contained in ** a written agreement between you and The Qt Company. For licensing terms ** and conditions see http://www.qt.io/terms-conditions. For further ** information use the contact form at http://www.qt.io/contact-us. ** ** GNU Lesser General Public License Usage ** Alternatively, this file may be used under the terms of the GNU Lesser ** General Public License version 2.1 or version 3 as published by the Free ** Software Foundation and appearing in the file LICENSE.LGPLv21 and ** LICENSE.LGPLv3 included in the packaging of this file. Please review the ** following information to ensure the GNU Lesser General Public License ** requirements will be met: https://www.gnu.org/licenses/lgpl.html and ** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html. ** ** As a special exception, The Qt Company gives you certain additional ** rights. These rights are described in The Qt Company LGPL Exception ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package. ** ** $QT_END_LICENSE$ ** ****************************************************************************/ #include "qquickthumbnailtoolbar_p.h" #include "qquickthumbnailtoolbutton_p.h" #include "qquickiconloader_p.h" #include #include QT_BEGIN_NAMESPACE /*! \qmltype ThumbnailToolBar \instantiates QQuickThumbnailToolBar \inqmlmodule QtWinExtras \brief Allows manipulating the window's thumbnail toolbar. This class allows an application to embed a toolbar in the thumbnail of a window, which is shown when hovering over its taskbar icon. It provides quick access to the window's commands without requiring the user to restore or activate the window. \image thumbbar.png Media player thumbnail toolbar \section3 Example \snippet code/thumbbar.qml thumbbar_qml \since QtWinExtras 1.0 */ QQuickThumbnailToolBar::QQuickThumbnailToolBar(QQuickItem *parent) : QQuickItem(parent) { connect(&m_toolbar, &QWinThumbnailToolBar::iconicThumbnailPixmapRequested, this, &QQuickThumbnailToolBar::iconicThumbnailRequested); connect(&m_toolbar, &QWinThumbnailToolBar::iconicLivePreviewPixmapRequested, this, &QQuickThumbnailToolBar::iconicLivePreviewRequested); } QQuickThumbnailToolBar::~QQuickThumbnailToolBar() { } int QQuickThumbnailToolBar::count() const { return m_toolbar.count(); } QQmlListProperty QQuickThumbnailToolBar::data() { return QQmlListProperty(this, 0, &QQuickThumbnailToolBar::addData, 0, 0, 0); } QQmlListProperty QQuickThumbnailToolBar::buttons() { return QQmlListProperty(this, 0, &QQuickThumbnailToolBar::buttonCount, &QQuickThumbnailToolBar::buttonAt); } void QQuickThumbnailToolBar::addButton(QQuickThumbnailToolButton *button) { if (!m_buttons.contains(button)) { m_toolbar.addButton(button->m_button); m_buttons.append(button); emit countChanged(); emit buttonsChanged(); } } void QQuickThumbnailToolBar::removeButton(QQuickThumbnailToolButton *button) { if (m_buttons.removeOne(button)) { m_toolbar.removeButton(button->m_button); emit countChanged(); emit buttonsChanged(); } } void QQuickThumbnailToolBar::clear() { m_toolbar.clear(); foreach (QQuickThumbnailToolButton *button, m_buttons) button->deleteLater(); m_buttons.clear(); emit countChanged(); emit buttonsChanged(); } /*! \qmlsignal ThumbnailToolBar::iconicThumbnailRequested() This signal is emitted when the operating system requests a new iconic thumbnail pixmap, typically when the thumbnail is shown. \since 5.4 */ /*! \qmlsignal ThumbnailToolBar::iconicLivePreviewRequested() This signal is emitted when the operating system requests a new iconic live preview pixmap, typically when the user ALT-tabs to the application. \since 5.4 */ /*! \qmlproperty bool ThumbnailToolBar::iconicNotificationsEnabled This property holds whether the signals iconicThumbnailRequested() or iconicLivePreviewRequested() will be emitted. \since 5.4 */ bool QQuickThumbnailToolBar::iconicNotificationsEnabled() const { return m_toolbar.iconicPixmapNotificationsEnabled(); } void QQuickThumbnailToolBar::setIconicNotificationsEnabled(bool enabled) { if (enabled != m_toolbar.iconicPixmapNotificationsEnabled()) { m_toolbar.setIconicPixmapNotificationsEnabled(enabled); emit iconicNotificationsEnabledChanged(); } } void QQuickThumbnailToolBar::iconicThumbnailLoaded(const QVariant &value) { m_toolbar.setIconicThumbnailPixmap(value.value()); } /*! \qmlproperty url ThumbnailToolBar::iconicThumbnailSource The pixmap for use as a thumbnail representation \since 5.4 */ void QQuickThumbnailToolBar::setIconicThumbnailSource(const QUrl &source) { if (source == m_iconicThumbnailSource) return; if (source.isEmpty()) { m_toolbar.setIconicThumbnailPixmap(QPixmap()); m_iconicThumbnailSource = source; emit iconicThumbnailSourceChanged(); } if (QQuickIconLoader::load(source, qmlEngine(this), QVariant::Pixmap, QSize(), this, &QQuickThumbnailToolBar::iconicThumbnailLoaded) != QQuickIconLoader::LoadError) { m_iconicThumbnailSource = source; emit iconicThumbnailSourceChanged(); } } void QQuickThumbnailToolBar::iconicLivePreviewLoaded(const QVariant &value) { m_toolbar.setIconicLivePreviewPixmap(value.value()); } /*! \qmlproperty url ThumbnailToolBar::iconicLivePreviewSource The pixmap for use as a live (peek) preview when tabbing into the application. \since 5.4 */ void QQuickThumbnailToolBar::setIconicLivePreviewSource(const QUrl &source) { if (source == m_iconicLivePreviewSource) return; if (source.isEmpty()) { m_toolbar.setIconicLivePreviewPixmap(QPixmap()); m_iconicLivePreviewSource = source; emit iconicLivePreviewSourceChanged(); } if (QQuickIconLoader::load(source, qmlEngine(this), QVariant::Pixmap, QSize(), this, &QQuickThumbnailToolBar::iconicLivePreviewLoaded) != QQuickIconLoader::LoadError) { m_iconicLivePreviewSource = source; emit iconicLivePreviewSourceChanged(); } } void QQuickThumbnailToolBar::itemChange(QQuickItem::ItemChange change, const QQuickItem::ItemChangeData &data) { if (change == ItemSceneChange) m_toolbar.setWindow(data.window); QQuickItem::itemChange(change, data); } void QQuickThumbnailToolBar::addData(QQmlListProperty *property, QObject *object) { if (QQuickThumbnailToolButton *button = qobject_cast(object)) { QQuickThumbnailToolBar *quickThumbbar = static_cast(property->object); quickThumbbar->m_toolbar.addButton(button->m_button); quickThumbbar->m_buttons.append(button); emit quickThumbbar->countChanged(); emit quickThumbbar->buttonsChanged(); } } int QQuickThumbnailToolBar::buttonCount(QQmlListProperty *property) { return static_cast(property->object)->count(); } QQuickThumbnailToolButton *QQuickThumbnailToolBar::buttonAt(QQmlListProperty *property, int index) { return static_cast(property->object)->m_buttons.value(index); } QT_END_NAMESPACE