qmenudata.3qt

Linux下的基于X11的图形开发环境。

'\" t
.TH QMenuData 3qt "9 December 2002" "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
.SH SYNOPSIS
\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 "bool \fBisItemVisible\fR ( int id ) const"
.br
.ti -1c
.BI "void \fBsetItemVisible\fR ( int id, bool visible )"
.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 can have a text(), an accelerator, a pixmap(), an iconSet(), a whatsThis() text and a popup menu (unless it is a separator). Menu items may optionally be checked (except for separators).
.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() and removeItemAt(), or changed with changeItem(). All menu items can be removed with clear(). 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. By default, newly created menu items are visible. They can be hidden (and shown again) with setItemVisible().
.PP
Menu items are stored in a list. Use findItem() to find an item by its list position or by its menu identifier. (See also indexOf() and idAt().)
.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 or if there is no such menu item.
.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().