qmenudata.3qt

linux下GUI编程工具qt的在线连接帮助手册

'\" t
.TH QMenuData 3qt "11 October 2001" "Trolltech AS" \" -*- nroff -*-
.\" Copyright 1992-2001 Trolltech AS.  All rights reserved.  See the
.\" license file included in the distribution for a complete license
.\" statement.
.\"
.ad l
.nh
.SH NAME
QMenuData \- Base class for QMenuBar and QPopupMenu
.PP
\fC#include <qmenudata.h>\fR
.PP
Inherited by QMenuBar and QPopupMenu.
.PP
.SS "Public Members"
.in +1c
.ti -1c
.BI "\fBQMenuData\fR ()"
.br
.ti -1c
.BI "virtual \fB~QMenuData\fR ()"
.br
.ti -1c
.BI "uint \fBcount\fR () const"
.br
.ti -1c
.BI "int \fBinsertItem\fR ( const QString & text, const QObject * receiver, const char * member, const QKeySequence & accel = 0, int id = -1, int index = -1 )"
.br
.ti -1c
.BI "int \fBinsertItem\fR ( const QIconSet & icon, const QString & text, const QObject * receiver, const char * member, const QKeySequence & accel = 0, int id = -1, int index = -1 )"
.br
.ti -1c
.BI "int \fBinsertItem\fR ( const QPixmap & pixmap, const QObject * receiver, const char * member, const QKeySequence & accel = 0, int id = -1, int index = -1 )"
.br
.ti -1c
.BI "int \fBinsertItem\fR ( const QIconSet & icon, const QPixmap & pixmap, const QObject * receiver, const char * member, const QKeySequence & accel = 0, int id = -1, int index = -1 )"
.br
.ti -1c
.BI "int \fBinsertItem\fR ( const QString & text, int id = -1, int index = -1 )"
.br
.ti -1c
.BI "int \fBinsertItem\fR ( const QIconSet & icon, const QString & text, int id = -1, int index = -1 )"
.br
.ti -1c
.BI "int \fBinsertItem\fR ( const QString & text, QPopupMenu * popup, int id = -1, int index = -1 )"
.br
.ti -1c
.BI "int \fBinsertItem\fR ( const QIconSet & icon, const QString & text, QPopupMenu * popup, int id = -1, int index = -1 )"
.br
.ti -1c
.BI "int \fBinsertItem\fR ( const QPixmap & pixmap, int id = -1, int index = -1 )"
.br
.ti -1c
.BI "int \fBinsertItem\fR ( const QIconSet & icon, const QPixmap & pixmap, int id = -1, int index = -1 )"
.br
.ti -1c
.BI "int \fBinsertItem\fR ( const QPixmap & pixmap, QPopupMenu * popup, int id = -1, int index = -1 )"
.br
.ti -1c
.BI "int \fBinsertItem\fR ( const QIconSet & icon, const QPixmap & pixmap, QPopupMenu * popup, int id = -1, int index = -1 )"
.br
.ti -1c
.BI "int \fBinsertItem\fR ( QWidget * widget, int id = -1, int index = -1 )"
.br
.ti -1c
.BI "int \fBinsertItem\fR ( const QIconSet & icon, QCustomMenuItem * custom, int id = -1, int index = -1 )"
.br
.ti -1c
.BI "int \fBinsertItem\fR ( QCustomMenuItem * custom, int id = -1, int index = -1 )"
.br
.ti -1c
.BI "int \fBinsertSeparator\fR ( int index = -1 )"
.br
.ti -1c
.BI "void \fBremoveItem\fR ( int id )"
.br
.ti -1c
.BI "void \fBremoveItemAt\fR ( int index )"
.br
.ti -1c
.BI "void \fBclear\fR ()"
.br
.ti -1c
.BI "QKeySequence \fBaccel\fR ( int id ) const"
.br
.ti -1c
.BI "void \fBsetAccel\fR ( const QKeySequence & key, int id )"
.br
.ti -1c
.BI "QIconSet * \fBiconSet\fR ( int id ) const"
.br
.ti -1c
.BI "QString \fBtext\fR ( int id ) const"
.br
.ti -1c
.BI "QPixmap * \fBpixmap\fR ( int id ) const"
.br
.ti -1c
.BI "void \fBsetWhatsThis\fR ( int id, const QString & text )"
.br
.ti -1c
.BI "QString \fBwhatsThis\fR ( int id ) const"
.br
.ti -1c
.BI "void \fBchangeItem\fR ( int id, const QString & text )"
.br
.ti -1c
.BI "void \fBchangeItem\fR ( int id, const QPixmap & pixmap )"
.br
.ti -1c
.BI "void \fBchangeItem\fR ( int id, const QIconSet & icon, const QString & text )"
.br
.ti -1c
.BI "void \fBchangeItem\fR ( int id, const QIconSet & icon, const QPixmap & pixmap )"
.br
.ti -1c
.BI "void changeItem ( const QString & text, int id )  \fI(obsolete)\fR"
.br
.ti -1c
.BI "void changeItem ( const QPixmap & pixmap, int id )  \fI(obsolete)\fR"
.br
.ti -1c
.BI "void changeItem ( const QIconSet & icon, const QString & text, int id )  \fI(obsolete)\fR"
.br
.ti -1c
.BI "bool \fBisItemActive\fR ( int id ) const"
.br
.ti -1c
.BI "bool \fBisItemEnabled\fR ( int id ) const"
.br
.ti -1c
.BI "void \fBsetItemEnabled\fR ( int id, bool enable )"
.br
.ti -1c
.BI "bool \fBisItemChecked\fR ( int id ) const"
.br
.ti -1c
.BI "void \fBsetItemChecked\fR ( int id, bool check )"
.br
.ti -1c
.BI "virtual void \fBupdateItem\fR ( int id )"
.br
.ti -1c
.BI "int \fBindexOf\fR ( int id ) const"
.br
.ti -1c
.BI "int \fBidAt\fR ( int index ) const"
.br
.ti -1c
.BI "virtual void \fBsetId\fR ( int index, int id )"
.br
.ti -1c
.BI "bool \fBconnectItem\fR ( int id, const QObject * receiver, const char * member )"
.br
.ti -1c
.BI "bool \fBdisconnectItem\fR ( int id, const QObject * receiver, const char * member )"
.br
.ti -1c
.BI "bool \fBsetItemParameter\fR ( int id, int param )"
.br
.ti -1c
.BI "int \fBitemParameter\fR ( int id ) const"
.br
.ti -1c
.BI "QMenuItem * \fBfindItem\fR ( int id ) const"
.br
.ti -1c
.BI "QMenuItem * \fBfindItem\fR ( int id, QMenuData ** parent ) const"
.br
.ti -1c
.BI "virtual void \fBactivateItemAt\fR ( int index )"
.br
.in -1c
.SS "Protected Members"
.in +1c
.ti -1c
.BI "virtual void \fBmenuContentsChanged\fR ()"
.br
.ti -1c
.BI "virtual void \fBmenuStateChanged\fR ()"
.br
.ti -1c
.BI "virtual void \fBmenuInsPopup\fR ( QPopupMenu * )"
.br
.ti -1c
.BI "virtual void \fBmenuDelPopup\fR ( QPopupMenu * )"
.br
.in -1c
.SH DESCRIPTION
The QMenuData class is a base class for QMenuBar and QPopupMenu.
.PP
QMenuData has an internal list of menu items. A menu item is a text, pixmap or separator, and may also have a popup menu (separators have no popup menus).
.PP
The menu item sends out an activated() signal when it is selected and a highlighted() signal when it receives the user input focus.
.PP

.PP
Menu items are assigned the menu identifier \fIid\fR that is passed in insertItem() or an automatically generated identifier if \fIid\fR is < 0 (the default). The generated identifiers (negative integers) are guaranteed to be unique within the entire application. The identifier is used to access the menu item in other functions.
.PP
Menu items can be removed with removeItem() or changed with changeItem(). Accelerators can be changed or set with setAccel(). Checkable items can be checked or unchecked with setItemChecked(). Items can be enabled or disabled using setItemEnabled() and connected and disconnected with connectItem() and disconnectItem() respectively.
.PP
Menu items are stored in a list. Use findItem() to find an item by its list position or by its menu identifier.
.PP
See also QAccel, QPopupMenu, QAction and Miscellaneous Classes.
.SH MEMBER FUNCTION DOCUMENTATION
.SH "QMenuData::QMenuData ()"
Constructs an empty menu data list.
.SH "QMenuData::~QMenuData ()\fC [virtual]\fR"
Removes all menu items and disconnects any signals that have been connected.
.SH "QKeySequence QMenuData::accel ( int id ) const"
Returns the accelerator key that has been defined for the menu item \fIid\fR, or 0 if it has no accelerator key.
.PP
See also setAccel(), QAccel and qnamespace.h.
.SH "void QMenuData::activateItemAt ( int index )\fC [virtual]\fR"
Activates the menu item at position \fIindex\fR.
.PP
If the index is invalid (for example, -1), the object itself is deactivated.
.SH "void QMenuData::changeItem ( int id, const QString & text )"
Changes the text of the menu item \fIid\fR to \fItext\fR. If the item has an icon, the icon remains unchanged.
.PP
See also text().
.SH "void QMenuData::changeItem ( int id, const QPixmap & pixmap )"
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
.PP
Changes the pixmap of the menu item \fIid\fR to the pixmap \fIpixmap\fR. If the item has an icon, the icon is unchanged.
.PP
See also pixmap().