/**************************************************************************** ** ** Copyright (C) 2017 The Qt Company Ltd. ** Contact: http://www.qt.io/licensing/ ** ** This file is part of the Qt Labs Platform module of the Qt Toolkit. ** ** $QT_BEGIN_LICENSE:LGPL3$ ** 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 3 as published by the Free Software ** Foundation and appearing in the file LICENSE.LGPLv3 included in the ** packaging of this file. Please review the following information to ** ensure the GNU Lesser General Public License version 3 requirements ** will be met: https://www.gnu.org/licenses/lgpl.html. ** ** GNU General Public License Usage ** Alternatively, this file may be used under the terms of the GNU ** General Public License version 2.0 or later as published by the Free ** Software Foundation and appearing in the file LICENSE.GPL included in ** the packaging of this file. Please review the following information to ** ensure the GNU General Public License version 2.0 requirements will be ** met: http://www.gnu.org/licenses/gpl-2.0.html. ** ** $QT_END_LICENSE$ ** ****************************************************************************/ #include "qquickplatformmenubar_p.h" #include "qquickplatformmenu_p.h" #include #include #include #include #include #include QT_BEGIN_NAMESPACE /*! \qmltype MenuBar \inherits QtObject \instantiates QQuickPlatformMenuBar \inqmlmodule Qt.labs.platform \since 5.8 \brief A native menubar. The MenuBar type provides a QML API for native platform menubars. \image qtlabsplatform-menubar.png A menubar consists of a list of drop-down menus. \code MenuBar { id: menuBar Menu { id: fileMenu title: qsTr("File") // ... } Menu { id: editMenu title: qsTr("&Edit") // ... } Menu { id: viewMenu title: qsTr("&View") // ... } Menu { id: helpMenu title: qsTr("&Help") // ... } } \endcode MenuBar is currently available on the following platforms: \list \li macOS \li Android \li Linux (only available on desktop environments that provide a global D-Bus menu bar) \endlist \labs \sa Menu */ Q_DECLARE_LOGGING_CATEGORY(qtLabsPlatformMenus) QQuickPlatformMenuBar::QQuickPlatformMenuBar(QObject *parent) : QObject(parent), m_complete(false), m_window(nullptr), m_handle(nullptr) { m_handle = QGuiApplicationPrivate::platformTheme()->createPlatformMenuBar(); qCDebug(qtLabsPlatformMenus) << "MenuBar ->" << m_handle; } QQuickPlatformMenuBar::~QQuickPlatformMenuBar() { for (QQuickPlatformMenu *menu : m_menus) menu->setMenuBar(nullptr); delete m_handle; m_handle = nullptr; } QPlatformMenuBar *QQuickPlatformMenuBar::handle() const { return m_handle; } /*! \default \qmlproperty list Qt.labs.platform::MenuBar::data This default property holds the list of all objects declared as children of the menubar. The data property includes objects that are not \l Menu instances, such as \l Timer and \l QtObject. \sa menus */ QQmlListProperty QQuickPlatformMenuBar::data() { return QQmlListProperty(this, nullptr, data_append, data_count, data_at, data_clear); } /*! \qmlproperty list Qt.labs.platform::MenuBar::menus This property holds the list of menus in the menubar. */ QQmlListProperty QQuickPlatformMenuBar::menus() { return QQmlListProperty(this, nullptr, menus_append, menus_count, menus_at, menus_clear); } /*! \qmlproperty Window Qt.labs.platform::MenuBar::window This property holds the menubar's window. Unless explicitly set, the window is automatically resolved by iterating the QML parent objects until a \l Window or an \l Item that has a window is found. */ QWindow *QQuickPlatformMenuBar::window() const { return m_window; } void QQuickPlatformMenuBar::setWindow(QWindow *window) { if (m_window == window) return; if (m_handle) m_handle->handleReparent(window); m_window = window; emit windowChanged(); } /*! \qmlmethod void Qt.labs.platform::MenuBar::addMenu(Menu menu) Adds a \a menu to end of the menubar. */ void QQuickPlatformMenuBar::addMenu(QQuickPlatformMenu *menu) { insertMenu(m_menus.count(), menu); } /*! \qmlmethod void Qt.labs.platform::MenuBar::insertMenu(int index, Menu menu) Inserts a \a menu at the specified \a index in the menubar. */ void QQuickPlatformMenuBar::insertMenu(int index, QQuickPlatformMenu *menu) { if (!menu || m_menus.contains(menu)) return; QQuickPlatformMenu *before = m_menus.value(index); m_menus.insert(index, menu); m_data.append(menu); menu->setMenuBar(this); if (m_handle) m_handle->insertMenu(menu->create(), before ? before->handle() : nullptr); emit menusChanged(); } /*! \qmlmethod void Qt.labs.platform::MenuBar::removeMenu(Menu menu) Removes a \a menu from the menubar. */ void QQuickPlatformMenuBar::removeMenu(QQuickPlatformMenu *menu) { if (!menu || !m_menus.removeOne(menu)) return; m_data.removeOne(menu); if (m_handle) m_handle->removeMenu(menu->handle()); menu->setMenuBar(nullptr); emit menusChanged(); } /*! \qmlmethod void Qt.labs.platform::MenuBar::clear() Removes all menus from the menubar. */ void QQuickPlatformMenuBar::clear() { if (m_menus.isEmpty()) return; for (QQuickPlatformMenu *menu : m_menus) { m_data.removeOne(menu); if (m_handle) m_handle->removeMenu(menu->handle()); menu->setMenuBar(nullptr); delete menu; } m_menus.clear(); emit menusChanged(); } void QQuickPlatformMenuBar::classBegin() { } void QQuickPlatformMenuBar::componentComplete() { m_complete = true; for (QQuickPlatformMenu *menu : m_menus) menu->sync(); if (!m_window) setWindow(findWindow()); } QWindow *QQuickPlatformMenuBar::findWindow() const { QObject *obj = parent(); while (obj) { QWindow *window = qobject_cast(obj); if (window) return window; QQuickItem *item = qobject_cast(obj); if (item && item->window()) return item->window(); obj = obj->parent(); } return nullptr; } void QQuickPlatformMenuBar::data_append(QQmlListProperty *property, QObject *object) { QQuickPlatformMenuBar *menuBar = static_cast(property->object); QQuickPlatformMenu *menu = qobject_cast(object); if (menu) menuBar->addMenu(menu); else menuBar->m_data.append(object); } int QQuickPlatformMenuBar::data_count(QQmlListProperty *property) { QQuickPlatformMenuBar *menuBar = static_cast(property->object); return menuBar->m_data.count(); } QObject *QQuickPlatformMenuBar::data_at(QQmlListProperty *property, int index) { QQuickPlatformMenuBar *menuBar = static_cast(property->object); return menuBar->m_data.value(index); } void QQuickPlatformMenuBar::data_clear(QQmlListProperty *property) { QQuickPlatformMenuBar *menuBar = static_cast(property->object); menuBar->m_data.clear(); } void QQuickPlatformMenuBar::menus_append(QQmlListProperty *property, QQuickPlatformMenu *menu) { QQuickPlatformMenuBar *menuBar = static_cast(property->object); menuBar->addMenu(menu); } int QQuickPlatformMenuBar::menus_count(QQmlListProperty *property) { QQuickPlatformMenuBar *menuBar = static_cast(property->object); return menuBar->m_menus.count(); } QQuickPlatformMenu *QQuickPlatformMenuBar::menus_at(QQmlListProperty *property, int index) { QQuickPlatformMenuBar *menuBar = static_cast(property->object); return menuBar->m_menus.value(index); } void QQuickPlatformMenuBar::menus_clear(QQmlListProperty *property) { QQuickPlatformMenuBar *menuBar = static_cast(property->object); menuBar->clear(); } QT_END_NAMESPACE