| /**************************************************************************** |
| ** |
| ** Copyright (C) 2016 The Qt Company Ltd. |
| ** Copyright (C) 2012 Klarälvdalens Datakonsult AB, a KDAB Group company, info@kdab.com, author James Turner <james.turner@kdab.com> |
| ** Contact: https://www.qt.io/licensing/ |
| ** |
| ** This file is part of the QtGui module of the Qt Toolkit. |
| ** |
| ** $QT_BEGIN_LICENSE:LGPL$ |
| ** 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 https://www.qt.io/terms-conditions. For further |
| ** information use the contact form at https://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.LGPL3 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-3.0.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 (at your option) the GNU General |
| ** Public license version 3 or any later version approved by the KDE Free |
| ** Qt Foundation. The licenses are as published by the Free Software |
| ** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3 |
| ** included in the packaging of this file. Please review the following |
| ** information to ensure the GNU General Public License requirements will |
| ** be met: https://www.gnu.org/licenses/gpl-2.0.html and |
| ** https://www.gnu.org/licenses/gpl-3.0.html. |
| ** |
| ** $QT_END_LICENSE$ |
| ** |
| ****************************************************************************/ |
| |
| #ifndef QPLATFORMMENU_H |
| #define QPLATFORMMENU_H |
| // |
| // W A R N I N G |
| // ------------- |
| // |
| // This file is part of the QPA API and is not meant to be used |
| // in applications. Usage of this API may make your code |
| // source and binary incompatible with future versions of Qt. |
| // |
| |
| #include <QtGui/qtguiglobal.h> |
| #include <QtCore/qpointer.h> |
| #include <QtGui/QFont> |
| #include <QtGui/QKeySequence> |
| #include <QtGui/QIcon> |
| |
| QT_BEGIN_NAMESPACE |
| |
| class QPlatformMenu; |
| class Q_GUI_EXPORT QPlatformMenuItem : public QObject |
| { |
| Q_OBJECT |
| public: |
| QPlatformMenuItem(); |
| |
| // copied from, and must stay in sync with, QAction menu roles. |
| enum MenuRole { NoRole = 0, TextHeuristicRole, ApplicationSpecificRole, AboutQtRole, |
| AboutRole, PreferencesRole, QuitRole, |
| // However these roles are private, perhaps temporarily. |
| // They could be added as public QAction roles if necessary. |
| CutRole, CopyRole, PasteRole, SelectAllRole, |
| RoleCount }; |
| Q_ENUM(MenuRole) |
| |
| virtual void setTag(quintptr tag); |
| virtual quintptr tag() const; |
| |
| virtual void setText(const QString &text) = 0; |
| virtual void setIcon(const QIcon &icon) = 0; |
| virtual void setMenu(QPlatformMenu *menu) = 0; |
| virtual void setVisible(bool isVisible) = 0; |
| virtual void setIsSeparator(bool isSeparator) = 0; |
| virtual void setFont(const QFont &font) = 0; |
| virtual void setRole(MenuRole role) = 0; |
| virtual void setCheckable(bool checkable) = 0; |
| virtual void setChecked(bool isChecked) = 0; |
| #ifndef QT_NO_SHORTCUT |
| virtual void setShortcut(const QKeySequence& shortcut) = 0; |
| #endif |
| virtual void setEnabled(bool enabled) = 0; |
| virtual void setIconSize(int size) = 0; |
| virtual void setNativeContents(WId item) { Q_UNUSED(item); } |
| virtual void setHasExclusiveGroup(bool hasExclusiveGroup) { Q_UNUSED(hasExclusiveGroup); } |
| |
| Q_SIGNALS: |
| void activated(); |
| void hovered(); |
| |
| private: |
| quintptr m_tag; |
| }; |
| |
| class Q_GUI_EXPORT QPlatformMenu : public QObject |
| { |
| Q_OBJECT |
| public: |
| QPlatformMenu(); |
| |
| enum MenuType { DefaultMenu = 0, EditMenu }; |
| Q_ENUM(MenuType) |
| |
| virtual void insertMenuItem(QPlatformMenuItem *menuItem, QPlatformMenuItem *before) = 0; |
| virtual void removeMenuItem(QPlatformMenuItem *menuItem) = 0; |
| virtual void syncMenuItem(QPlatformMenuItem *menuItem) = 0; |
| virtual void syncSeparatorsCollapsible(bool enable) = 0; |
| |
| virtual void setTag(quintptr tag); |
| virtual quintptr tag() const; |
| |
| virtual void setText(const QString &text) = 0; |
| virtual void setIcon(const QIcon &icon) = 0; |
| virtual void setEnabled(bool enabled) = 0; |
| virtual bool isEnabled() const { return true; } |
| virtual void setVisible(bool visible) = 0; |
| virtual void setMinimumWidth(int width) { Q_UNUSED(width); } |
| virtual void setFont(const QFont &font) { Q_UNUSED(font); } |
| virtual void setMenuType(MenuType type) { Q_UNUSED(type); } |
| |
| virtual void showPopup(const QWindow *parentWindow, const QRect &targetRect, const QPlatformMenuItem *item) |
| { |
| Q_UNUSED(parentWindow); |
| Q_UNUSED(targetRect); |
| Q_UNUSED(item); |
| setVisible(true); |
| } |
| |
| virtual void dismiss() { } // Closes this and all its related menu popups |
| |
| virtual QPlatformMenuItem *menuItemAt(int position) const = 0; |
| virtual QPlatformMenuItem *menuItemForTag(quintptr tag) const = 0; |
| |
| virtual QPlatformMenuItem *createMenuItem() const; |
| virtual QPlatformMenu *createSubMenu() const; |
| Q_SIGNALS: |
| void aboutToShow(); |
| void aboutToHide(); |
| |
| private: |
| quintptr m_tag; |
| }; |
| |
| class Q_GUI_EXPORT QPlatformMenuBar : public QObject |
| { |
| Q_OBJECT |
| public: |
| virtual void insertMenu(QPlatformMenu *menu, QPlatformMenu *before) = 0; |
| virtual void removeMenu(QPlatformMenu *menu) = 0; |
| virtual void syncMenu(QPlatformMenu *menuItem) = 0; |
| virtual void handleReparent(QWindow *newParentWindow) = 0; |
| virtual QWindow *parentWindow() const { return nullptr; } |
| |
| virtual QPlatformMenu *menuForTag(quintptr tag) const = 0; |
| virtual QPlatformMenu *createMenu() const; |
| }; |
| |
| QT_END_NAMESPACE |
| |
| #endif |
| |