/**************************************************************************** | |
** | |
** Copyright (C) 2011 Nokia Corporation and/or its subsidiary(-ies). | |
** All rights reserved. | |
** Contact: Nokia Corporation (qt-info@nokia.com) | |
** | |
** This file is part of the QtGui module of the Qt Toolkit. | |
** | |
** $QT_BEGIN_LICENSE:LGPL$ | |
** GNU Lesser General Public License Usage | |
** This file may be used under the terms of the GNU Lesser General Public | |
** License version 2.1 as published by the Free Software Foundation and | |
** appearing in the file LICENSE.LGPL included in the packaging of this | |
** file. Please review the following information to ensure the GNU Lesser | |
** General Public License version 2.1 requirements will be met: | |
** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html. | |
** | |
** In addition, as a special exception, Nokia gives you certain additional | |
** rights. These rights are described in the Nokia Qt LGPL Exception | |
** version 1.1, included in the file LGPL_EXCEPTION.txt in this package. | |
** | |
** GNU General Public License Usage | |
** Alternatively, this file may be used under the terms of the GNU General | |
** Public License version 3.0 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 3.0 requirements will be met: | |
** http://www.gnu.org/copyleft/gpl.html. | |
** | |
** Other Usage | |
** Alternatively, this file may be used in accordance with the terms and | |
** conditions contained in a signed written agreement between you and Nokia. | |
** | |
** | |
** | |
** | |
** | |
** $QT_END_LICENSE$ | |
** | |
****************************************************************************/ | |
#ifndef QMENU_H | |
#define QMENU_H | |
#include <QtGui/qwidget.h> | |
#include <QtCore/qstring.h> | |
#include <QtGui/qicon.h> | |
#include <QtGui/qaction.h> | |
#ifdef QT3_SUPPORT | |
#include <QtGui/qpixmap.h> | |
#endif | |
QT_BEGIN_HEADER | |
QT_BEGIN_NAMESPACE | |
QT_MODULE(Gui) | |
#ifndef QT_NO_MENU | |
class QMenuPrivate; | |
class QStyleOptionMenuItem; | |
#ifdef QT3_SUPPORT | |
class QMenuItem; | |
#endif | |
class Q_GUI_EXPORT QMenu : public QWidget | |
{ | |
private: | |
Q_OBJECT | |
Q_DECLARE_PRIVATE(QMenu) | |
Q_PROPERTY(bool tearOffEnabled READ isTearOffEnabled WRITE setTearOffEnabled) | |
Q_PROPERTY(QString title READ title WRITE setTitle) | |
Q_PROPERTY(QIcon icon READ icon WRITE setIcon) | |
Q_PROPERTY(bool separatorsCollapsible READ separatorsCollapsible WRITE setSeparatorsCollapsible) | |
public: | |
explicit QMenu(QWidget *parent = 0); | |
explicit QMenu(const QString &title, QWidget *parent = 0); | |
~QMenu(); | |
#ifdef Q_NO_USING_KEYWORD | |
inline void addAction(QAction *action) { QWidget::addAction(action); } | |
#else | |
using QWidget::addAction; | |
#endif | |
QAction *addAction(const QString &text); | |
QAction *addAction(const QIcon &icon, const QString &text); | |
QAction *addAction(const QString &text, const QObject *receiver, const char* member, const QKeySequence &shortcut = 0); | |
QAction *addAction(const QIcon &icon, const QString &text, const QObject *receiver, const char* member, const QKeySequence &shortcut = 0); | |
QAction *addMenu(QMenu *menu); | |
QMenu *addMenu(const QString &title); | |
QMenu *addMenu(const QIcon &icon, const QString &title); | |
QAction *addSeparator(); | |
QAction *insertMenu(QAction *before, QMenu *menu); | |
QAction *insertSeparator(QAction *before); | |
bool isEmpty() const; | |
void clear(); | |
void setTearOffEnabled(bool); | |
bool isTearOffEnabled() const; | |
bool isTearOffMenuVisible() const; | |
void hideTearOffMenu(); | |
void setDefaultAction(QAction *); | |
QAction *defaultAction() const; | |
void setActiveAction(QAction *act); | |
QAction *activeAction() const; | |
void popup(const QPoint &pos, QAction *at=0); | |
QAction *exec(); | |
QAction *exec(const QPoint &pos, QAction *at=0); | |
// ### Qt 5: merge | |
static QAction *exec(QList<QAction*> actions, const QPoint &pos, QAction *at=0); | |
static QAction *exec(QList<QAction*> actions, const QPoint &pos, QAction *at, QWidget *parent); | |
QSize sizeHint() const; | |
QRect actionGeometry(QAction *) const; | |
QAction *actionAt(const QPoint &) const; | |
QAction *menuAction() const; | |
QString title() const; | |
void setTitle(const QString &title); | |
QIcon icon() const; | |
void setIcon(const QIcon &icon); | |
void setNoReplayFor(QWidget *widget); | |
#ifdef Q_WS_MAC | |
OSMenuRef macMenu(OSMenuRef merge=0); | |
#endif | |
#ifdef Q_WS_WINCE | |
HMENU wceMenu(); | |
#endif | |
bool separatorsCollapsible() const; | |
void setSeparatorsCollapsible(bool collapse); | |
Q_SIGNALS: | |
void aboutToShow(); | |
void aboutToHide(); | |
void triggered(QAction *action); | |
void hovered(QAction *action); | |
protected: | |
int columnCount() const; | |
void changeEvent(QEvent *); | |
void keyPressEvent(QKeyEvent *); | |
void mouseReleaseEvent(QMouseEvent *); | |
void mousePressEvent(QMouseEvent *); | |
void mouseMoveEvent(QMouseEvent *); | |
#ifndef QT_NO_WHEELEVENT | |
void wheelEvent(QWheelEvent *); | |
#endif | |
void enterEvent(QEvent *); | |
void leaveEvent(QEvent *); | |
void hideEvent(QHideEvent *); | |
void paintEvent(QPaintEvent *); | |
void actionEvent(QActionEvent *); | |
void timerEvent(QTimerEvent *); | |
bool event(QEvent *); | |
bool focusNextPrevChild(bool next); | |
void initStyleOption(QStyleOptionMenuItem *option, const QAction *action) const; | |
#ifdef Q_WS_WINCE | |
QAction* wceCommands(uint command); | |
#endif | |
private Q_SLOTS: | |
void internalSetSloppyAction(); | |
void internalDelayedPopup(); | |
private: | |
Q_PRIVATE_SLOT(d_func(), void _q_actionTriggered()) | |
Q_PRIVATE_SLOT(d_func(), void _q_actionHovered()) | |
Q_PRIVATE_SLOT(d_func(), void _q_overrideMenuActionDestroyed()) | |
#ifdef QT3_SUPPORT | |
public: | |
//menudata | |
inline QT3_SUPPORT uint count() const { return actions().count(); } | |
inline QT3_SUPPORT int insertItem(const QString &text, const QObject *receiver, const char* member, | |
const QKeySequence& shortcut = 0, int id = -1, int index = -1) { | |
return insertAny(0, &text, receiver, member, &shortcut, 0, id, index); | |
} | |
inline QT3_SUPPORT int insertItem(const QIcon& icon, const QString &text, | |
const QObject *receiver, const char* member, | |
const QKeySequence& shortcut = 0, int id = -1, int index = -1) { | |
return insertAny(&icon, &text, receiver, member, &shortcut, 0, id, index); | |
} | |
inline QT3_SUPPORT int insertItem(const QPixmap &pixmap, const QObject *receiver, const char* member, | |
const QKeySequence& shortcut = 0, int id = -1, int index = -1) { | |
QIcon icon(pixmap); | |
return insertAny(&icon, 0, receiver, member, &shortcut, 0, id, index); | |
} | |
inline QT3_SUPPORT int insertItem(const QString &text, int id=-1, int index=-1) { | |
return insertAny(0, &text, 0, 0, 0, 0, id, index); | |
} | |
inline QT3_SUPPORT int insertItem(const QIcon& icon, const QString &text, int id=-1, int index=-1) { | |
return insertAny(&icon, &text, 0, 0, 0, 0, id, index); | |
} | |
inline QT3_SUPPORT int insertItem(const QString &text, QMenu *popup, int id=-1, int index=-1) { | |
return insertAny(0, &text, 0, 0, 0, popup, id, index); | |
} | |
inline QT3_SUPPORT int insertItem(const QIcon& icon, const QString &text, QMenu *popup, int id=-1, int index=-1) { | |
return insertAny(&icon, &text, 0, 0, 0, popup, id, index); | |
} | |
inline QT3_SUPPORT int insertItem(const QPixmap &pixmap, int id=-1, int index=-1) { | |
QIcon icon(pixmap); | |
return insertAny(&icon, 0, 0, 0, 0, 0, id, index); | |
} | |
inline QT3_SUPPORT int insertItem(const QPixmap &pixmap, QMenu *popup, int id=-1, int index=-1) { | |
QIcon icon(pixmap); | |
return insertAny(&icon, 0, 0, 0, 0, popup, id, index); | |
} | |
QT3_SUPPORT int insertItem(QMenuItem *item, int id=-1, int index=-1); | |
QT3_SUPPORT int insertSeparator(int index=-1); | |
inline QT3_SUPPORT void removeItem(int id) { | |
if(QAction *act = findActionForId(id)) | |
removeAction(act); } | |
inline QT3_SUPPORT void removeItemAt(int index) { | |
if(QAction *act = actions().value(index)) | |
removeAction(act); } | |
#ifndef QT_NO_SHORTCUT | |
inline QT3_SUPPORT QKeySequence accel(int id) const { | |
if(QAction *act = findActionForId(id)) | |
return act->shortcut(); | |
return QKeySequence(); } | |
inline QT3_SUPPORT void setAccel(const QKeySequence& key, int id) { | |
if(QAction *act = findActionForId(id)) | |
act->setShortcut(key); | |
} | |
#endif | |
inline QT3_SUPPORT QIcon iconSet(int id) const { | |
if(QAction *act = findActionForId(id)) | |
return act->icon(); | |
return QIcon(); } | |
inline QT3_SUPPORT QString text(int id) const { | |
if(QAction *act = findActionForId(id)) | |
return act->text(); | |
return QString(); } | |
inline QT3_SUPPORT QPixmap pixmap(int id) const { | |
if(QAction *act = findActionForId(id)) | |
return act->icon().pixmap(QSize(22, 22)); | |
return QPixmap(); } | |
inline QT3_SUPPORT void setWhatsThis(int id, const QString &w) { | |
if(QAction *act = findActionForId(id)) | |
act->setWhatsThis(w); } | |
inline QT3_SUPPORT QString whatsThis(int id) const { | |
if(QAction *act = findActionForId(id)) | |
return act->whatsThis(); | |
return QString(); } | |
inline QT3_SUPPORT void changeItem(int id, const QString &text) { | |
if(QAction *act = findActionForId(id)) | |
act->setText(text); } | |
inline QT3_SUPPORT void changeItem(int id, const QPixmap &pixmap) { | |
if(QAction *act = findActionForId(id)) | |
act->setIcon(QIcon(pixmap)); } | |
inline QT3_SUPPORT void changeItem(int id, const QIcon &icon, const QString &text) { | |
if(QAction *act = findActionForId(id)) { | |
act->setIcon(icon); | |
act->setText(text); | |
} | |
} | |
inline QT3_SUPPORT void setActiveItem(int id) { | |
setActiveAction(findActionForId(id)); | |
} | |
inline QT3_SUPPORT bool isItemActive(int id) const { | |
return findActionForId(id) == activeAction(); | |
} | |
inline QT3_SUPPORT bool isItemEnabled(int id) const { | |
if(QAction *act = findActionForId(id)) | |
return act->isEnabled(); | |
return false; } | |
inline QT3_SUPPORT void setItemEnabled(int id, bool enable) { | |
if(QAction *act = findActionForId(id)) | |
act->setEnabled(enable); | |
} | |
inline QT3_SUPPORT bool isItemChecked(int id) const { | |
if(QAction *act = findActionForId(id)) | |
return act->isChecked(); | |
return false; | |
} | |
inline QT3_SUPPORT void setItemChecked(int id, bool check) { | |
if(QAction *act = findActionForId(id)) { | |
act->setCheckable(true); | |
act->setChecked(check); | |
} | |
} | |
inline QT3_SUPPORT bool isItemVisible(int id) const { | |
if(QAction *act = findActionForId(id)) | |
return act->isVisible(); | |
return false; | |
} | |
inline QT3_SUPPORT void setItemVisible(int id, bool visible) { | |
if(QAction *act = findActionForId(id)) | |
act->setVisible(visible); | |
} | |
inline QT3_SUPPORT QRect itemGeometry(int index) { | |
if(QAction *act = actions().value(index)) | |
return actionGeometry(act); | |
return QRect(); | |
} | |
inline QT3_SUPPORT QFont itemFont(int id) const { | |
if(QAction *act = findActionForId(id)) | |
return act->font(); | |
return QFont(); | |
} | |
inline QT3_SUPPORT void setItemFont(int id, const QFont &font) { | |
if(QAction *act = findActionForId(id)) | |
act->setFont(font); | |
} | |
inline QT3_SUPPORT int indexOf(int id) const { | |
return actions().indexOf(findActionForId(id)); | |
} | |
inline QT3_SUPPORT int idAt(int index) const { | |
return findIdForAction(actions().value(index)); | |
} | |
QT3_SUPPORT void setId (int index, int id); | |
inline QT3_SUPPORT void activateItemAt(int index) { | |
if(QAction *ret = actions().value(index)) | |
ret->activate(QAction::Trigger); | |
} | |
inline QT3_SUPPORT bool connectItem(int id, const QObject *receiver, const char* member) { | |
if(QAction *act = findActionForId(id)) { | |
QObject::connect(act, SIGNAL(activated(int)), receiver, member); | |
return true; | |
} | |
return false; | |
} | |
inline QT3_SUPPORT bool disconnectItem(int id,const QObject *receiver, const char* member) { | |
if(QAction *act = findActionForId(id)) { | |
QObject::disconnect(act, SIGNAL(triggered()), receiver, member); | |
return true; | |
} | |
return false; | |
} | |
inline QT3_SUPPORT QMenuItem *findItem(int id) const { | |
return reinterpret_cast<QMenuItem*>(findActionForId(id)); | |
} | |
inline QT3_SUPPORT void setCheckable(bool){} | |
inline QT3_SUPPORT bool isCheckable() const {return true;} | |
QT3_SUPPORT QMenuItem *findPopup( QMenu *popup, int *index ); | |
QT3_SUPPORT bool setItemParameter(int id, int param); | |
QT3_SUPPORT int itemParameter(int id) const; | |
//frame | |
QT3_SUPPORT int frameWidth() const; | |
//popupmenu | |
inline QT3_SUPPORT void popup(const QPoint & pos, int indexAtPoint) { popup(pos, actions().value(indexAtPoint)); } | |
inline QT3_SUPPORT int insertTearOffHandle(int = 0, int = 0) { | |
setTearOffEnabled(true); | |
return -1; | |
} | |
protected: | |
inline QT3_SUPPORT int itemAtPos(const QPoint &p, bool ignoreSeparator = true) { | |
QAction *ret = actionAt(p); | |
if(ignoreSeparator && ret && ret->isSeparator()) | |
return -1; | |
return findIdForAction(ret); | |
} | |
inline QT3_SUPPORT int columns() const { return columnCount(); } | |
inline QT3_SUPPORT int itemHeight(int index) { | |
return actionGeometry(actions().value(index)).height(); | |
} | |
inline QT3_SUPPORT int itemHeight(QMenuItem *mi) { | |
return actionGeometry(reinterpret_cast<QAction *>(mi)).height(); | |
} | |
Q_SIGNALS: | |
QT_MOC_COMPAT void activated(int itemId); | |
QT_MOC_COMPAT void highlighted(int itemId); | |
private: | |
int insertAny(const QIcon *icon, const QString *text, const QObject *receiver, const char *member, | |
const QKeySequence *shorcut, const QMenu *popup, int id, int index); | |
QAction *findActionForId(int id) const; | |
int findIdForAction(QAction*) const; | |
#endif | |
protected: | |
QMenu(QMenuPrivate &dd, QWidget* parent = 0); | |
private: | |
Q_DISABLE_COPY(QMenu) | |
friend class QMenuBar; | |
friend class QMenuBarPrivate; | |
friend class QTornOffMenu; | |
friend class Q3PopupMenu; | |
friend class QComboBox; | |
friend class QAction; | |
friend class QToolButtonPrivate; | |
#ifdef Q_WS_MAC | |
friend void qt_mac_trayicon_activate_action(QMenu *, QAction *action); | |
friend bool qt_mac_watchingAboutToShow(QMenu *); | |
friend OSStatus qt_mac_menu_event(EventHandlerCallRef, EventRef, void *); | |
friend bool qt_mac_activate_action(OSMenuRef, uint, QAction::ActionEvent, bool); | |
friend void qt_mac_emit_menuSignals(QMenu *, bool); | |
friend void qt_mac_menu_emit_hovered(QMenu *menu, QAction *action); | |
#endif | |
}; | |
#endif // QT_NO_MENU | |
QT_END_NAMESPACE | |
QT_END_HEADER | |
#endif // QMENU_H |