<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<!-- /home/espenr/tmp/qt - 3.3.8 - espenr - 2499/qt - x11 - free - 3.3.8/src/widgets/qmenudata.cpp:61 -->
< html >
< head >
< meta http-equiv = "Content-Type" content = "text/html; charset=ISO-8859-1" >
< title > TQMenuData Class< / title >
< style type = "text/css" > < ! - -
fn { margin-left: 1cm; text-indent: -1cm; }
a:link { color: #004faf; text-decoration: none }
a:visited { color: #672967; text-decoration: none }
body { background: #ffffff; color: black; }
-->< / style >
< / head >
< body >
< table border = "0" cellpadding = "0" cellspacing = "0" width = "100%" >
< tr bgcolor = "#E5E5E5" >
< td valign = center >
< a href = "index.html" >
< font color = "#004faf" > Home< / font > < / a >
| < a href = "classes.html" >
< font color = "#004faf" > All Classes< / font > < / a >
| < a href = "mainclasses.html" >
< font color = "#004faf" > Main Classes< / font > < / a >
| < a href = "annotated.html" >
< font color = "#004faf" > Annotated< / font > < / a >
| < a href = "groups.html" >
< font color = "#004faf" > Grouped Classes< / font > < / a >
| < a href = "functions.html" >
< font color = "#004faf" > Functions< / font > < / a >
< / td >
< td align = "right" valign = "center" > < img src = "logo32.png" align = "right" width = "64" height = "32" border = "0" > < / td > < / tr > < / table > < h1 align = center > TQMenuData Class Reference< / h1 >
< p > The TQMenuData class is a base class for TQMenuBar and TQPopupMenu.
< a href = "#details" > More...< / a >
< p > < tt > #include < < a href = "qmenudata-h.html" > ntqmenudata.h< / a > > < / tt >
< p > Inherited by < a href = "ntqmenubar.html" > TQMenuBar< / a > and < a href = "ntqpopupmenu.html" > TQPopupMenu< / a > .
< p > < a href = "qmenudata-members.html" > List of all member functions.< / a >
< h2 > Public Members< / h2 >
< ul >
< li class = fn > < a href = "#TQMenuData" > < b > TQMenuData< / b > < / a > ()< / li >
< li class = fn > virtual < a href = "#~TQMenuData" > < b > ~TQMenuData< / b > < / a > ()< / li >
< li class = fn > uint < a href = "#count" > < b > count< / b > < / a > () const< / li >
< li class = fn > int < a href = "#insertItem" > < b > insertItem< / b > < / a > ( const TQString & text, const TQObject * receiver, const char * member, const TQKeySequence & accel = 0, int id = -1, int index = -1 )< / li >
< li class = fn > int < a href = "#insertItem-2" > < b > insertItem< / b > < / a > ( const TQIconSet & icon, const TQString & text, const TQObject * receiver, const char * member, const TQKeySequence & accel = 0, int id = -1, int index = -1 )< / li >
< li class = fn > int < a href = "#insertItem-3" > < b > insertItem< / b > < / a > ( const TQPixmap & pixmap, const TQObject * receiver, const char * member, const TQKeySequence & accel = 0, int id = -1, int index = -1 )< / li >
< li class = fn > int < a href = "#insertItem-4" > < b > insertItem< / b > < / a > ( const TQIconSet & icon, const TQPixmap & pixmap, const TQObject * receiver, const char * member, const TQKeySequence & accel = 0, int id = -1, int index = -1 )< / li >
< li class = fn > int < a href = "#insertItem-5" > < b > insertItem< / b > < / a > ( const TQString & text, int id = -1, int index = -1 )< / li >
< li class = fn > int < a href = "#insertItem-6" > < b > insertItem< / b > < / a > ( const TQIconSet & icon, const TQString & text, int id = -1, int index = -1 )< / li >
< li class = fn > int < a href = "#insertItem-7" > < b > insertItem< / b > < / a > ( const TQString & text, TQPopupMenu * popup, int id = -1, int index = -1 )< / li >
< li class = fn > int < a href = "#insertItem-8" > < b > insertItem< / b > < / a > ( const TQIconSet & icon, const TQString & text, TQPopupMenu * popup, int id = -1, int index = -1 )< / li >
< li class = fn > int < a href = "#insertItem-9" > < b > insertItem< / b > < / a > ( const TQPixmap & pixmap, int id = -1, int index = -1 )< / li >
< li class = fn > int < a href = "#insertItem-a" > < b > insertItem< / b > < / a > ( const TQIconSet & icon, const TQPixmap & pixmap, int id = -1, int index = -1 )< / li >
< li class = fn > int < a href = "#insertItem-b" > < b > insertItem< / b > < / a > ( const TQPixmap & pixmap, TQPopupMenu * popup, int id = -1, int index = -1 )< / li >
< li class = fn > int < a href = "#insertItem-c" > < b > insertItem< / b > < / a > ( const TQIconSet & icon, const TQPixmap & pixmap, TQPopupMenu * popup, int id = -1, int index = -1 )< / li >
< li class = fn > int < a href = "#insertItem-d" > < b > insertItem< / b > < / a > ( TQWidget * widget, int id = -1, int index = -1 )< / li >
< li class = fn > int < a href = "#insertItem-e" > < b > insertItem< / b > < / a > ( const TQIconSet & icon, TQCustomMenuItem * custom, int id = -1, int index = -1 )< / li >
< li class = fn > int < a href = "#insertItem-f" > < b > insertItem< / b > < / a > ( TQCustomMenuItem * custom, int id = -1, int index = -1 )< / li >
< li class = fn > int < a href = "#insertSeparator" > < b > insertSeparator< / b > < / a > ( int index = -1 )< / li >
< li class = fn > void < a href = "#removeItem" > < b > removeItem< / b > < / a > ( int id )< / li >
< li class = fn > void < a href = "#removeItemAt" > < b > removeItemAt< / b > < / a > ( int index )< / li >
< li class = fn > void < a href = "#clear" > < b > clear< / b > < / a > ()< / li >
< li class = fn > TQKeySequence < a href = "#accel" > < b > accel< / b > < / a > ( int id ) const< / li >
< li class = fn > void < a href = "#setAccel" > < b > setAccel< / b > < / a > ( const TQKeySequence & key, int id )< / li >
< li class = fn > TQIconSet * < a href = "#iconSet" > < b > iconSet< / b > < / a > ( int id ) const< / li >
< li class = fn > TQString < a href = "#text" > < b > text< / b > < / a > ( int id ) const< / li >
< li class = fn > TQPixmap * < a href = "#pixmap" > < b > pixmap< / b > < / a > ( int id ) const< / li >
< li class = fn > void < a href = "#setWhatsThis" > < b > setWhatsThis< / b > < / a > ( int id, const TQString & text )< / li >
< li class = fn > TQString < a href = "#whatsThis" > < b > whatsThis< / b > < / a > ( int id ) const< / li >
< li class = fn > void < a href = "#changeItem" > < b > changeItem< / b > < / a > ( int id, const TQString & text )< / li >
< li class = fn > void < a href = "#changeItem-2" > < b > changeItem< / b > < / a > ( int id, const TQPixmap & pixmap )< / li >
< li class = fn > void < a href = "#changeItem-3" > < b > changeItem< / b > < / a > ( int id, const TQIconSet & icon, const TQString & text )< / li >
< li class = fn > void < a href = "#changeItem-4" > < b > changeItem< / b > < / a > ( int id, const TQIconSet & icon, const TQPixmap & pixmap )< / li >
< li class = fn > void changeItem ( const TQString & text, int id ) < em > (obsolete)< / em > < / li >
< li class = fn > void changeItem ( const TQPixmap & pixmap, int id ) < em > (obsolete)< / em > < / li >
< li class = fn > void changeItem ( const TQIconSet & icon, const TQString & text, int id ) < em > (obsolete)< / em > < / li >
< li class = fn > bool < a href = "#isItemActive" > < b > isItemActive< / b > < / a > ( int id ) const< / li >
< li class = fn > bool < a href = "#isItemEnabled" > < b > isItemEnabled< / b > < / a > ( int id ) const< / li >
< li class = fn > void < a href = "#setItemEnabled" > < b > setItemEnabled< / b > < / a > ( int id, bool enable )< / li >
< li class = fn > bool < a href = "#isItemChecked" > < b > isItemChecked< / b > < / a > ( int id ) const< / li >
< li class = fn > void < a href = "#setItemChecked" > < b > setItemChecked< / b > < / a > ( int id, bool check )< / li >
< li class = fn > bool < a href = "#isItemVisible" > < b > isItemVisible< / b > < / a > ( int id ) const< / li >
< li class = fn > void < a href = "#setItemVisible" > < b > setItemVisible< / b > < / a > ( int id, bool visible )< / li >
< li class = fn > virtual void < a href = "#updateItem" > < b > updateItem< / b > < / a > ( int id )< / li >
< li class = fn > int < a href = "#indexOf" > < b > indexOf< / b > < / a > ( int id ) const< / li >
< li class = fn > int < a href = "#idAt" > < b > idAt< / b > < / a > ( int index ) const< / li >
< li class = fn > virtual void < a href = "#setId" > < b > setId< / b > < / a > ( int index, int id )< / li >
< li class = fn > bool < a href = "#connectItem" > < b > connectItem< / b > < / a > ( int id, const TQObject * receiver, const char * member )< / li >
< li class = fn > bool < a href = "#disconnectItem" > < b > disconnectItem< / b > < / a > ( int id, const TQObject * receiver, const char * member )< / li >
< li class = fn > bool < a href = "#setItemParameter" > < b > setItemParameter< / b > < / a > ( int id, int param )< / li >
< li class = fn > int < a href = "#itemParameter" > < b > itemParameter< / b > < / a > ( int id ) const< / li >
< li class = fn > TQMenuItem * < a href = "#findItem" > < b > findItem< / b > < / a > ( int id ) const< / li >
< li class = fn > TQMenuItem * < a href = "#findItem-2" > < b > findItem< / b > < / a > ( int id, TQMenuData ** parent ) const< / li >
< li class = fn > virtual void < a href = "#activateItemAt" > < b > activateItemAt< / b > < / a > ( int index )< / li >
< / ul >
< h2 > Protected Members< / h2 >
< ul >
< li class = fn > virtual void < a href = "#menuContentsChanged" > < b > menuContentsChanged< / b > < / a > ()< / li >
< li class = fn > virtual void < a href = "#menuStateChanged" > < b > menuStateChanged< / b > < / a > ()< / li >
< li class = fn > virtual void < a href = "#menuInsPopup" > < b > menuInsPopup< / b > < / a > ( TQPopupMenu * )< / li >
< li class = fn > virtual void < a href = "#menuDelPopup" > < b > menuDelPopup< / b > < / a > ( TQPopupMenu * )< / li >
< / ul >
< hr > < a name = "details" > < / a > < h2 > Detailed Description< / h2 >
The TQMenuData class is a base class for < a href = "ntqmenubar.html" > TQMenuBar< / a > and < a href = "ntqpopupmenu.html" > TQPopupMenu< / a > .
< p >
< p > TQMenuData has an internal list of menu items. A menu item can have
a < a href = "#text" > text< / a > (), an < a href = "#accel" > accelerator< / a > , a < a href = "#pixmap" > pixmap< / a > (), an
< a href = "#iconSet" > iconSet< / a > (), a < a href = "#whatsThis" > whatsThis< / a > () text and a popup menu (unless it is a
separator). Menu items may optionally be < a href = "#setItemChecked" > checked< / a > (except for separators).
< p > The menu item sends out an < a href = "ntqmenubar.html#activated" > activated()< / a > signal when it is chosen and a < a href = "ntqmenubar.html#highlighted" > highlighted()< / a > signal when it
receives the user input focus.
< p > <!-- index menu identifier --> < a name = "menu-identifier" > < / a >
< p > Menu items are assigned the menu identifier < em > id< / em > that is passed
in < a href = "#insertItem" > insertItem< / a > () or an automatically generated identifier if < em > id< / em >
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.
< p > Menu items can be removed with < a href = "#removeItem" > removeItem< / a > () and < a href = "#removeItemAt" > removeItemAt< / a > (), or
changed with < a href = "#changeItem" > changeItem< / a > (). All menu items can be removed with
< a href = "#clear" > clear< / a > (). Accelerators can be changed or set with < a href = "#setAccel" > setAccel< / a > ().
Checkable items can be checked or unchecked with < a href = "#setItemChecked" > setItemChecked< / a > ().
Items can be enabled or disabled using < a href = "#setItemEnabled" > setItemEnabled< / a > () and
connected and disconnected with < a href = "#connectItem" > connectItem< / a > () and < a href = "#disconnectItem" > disconnectItem< / a > ()
respectively. By default, newly created menu items are visible.
They can be hidden (and shown again) with < a href = "#setItemVisible" > setItemVisible< / a > ().
< p > Menu items are stored in a list. Use < a href = "#findItem" > findItem< / a > () to find an item by
its list position or by its menu identifier. (See also < a href = "#indexOf" > indexOf< / a > ()
and < a href = "#idAt" > idAt< / a > ().)
< p > < p > See also < a href = "ntqaccel.html" > TQAccel< / a > , < a href = "ntqpopupmenu.html" > TQPopupMenu< / a > , < a href = "ntqaction.html" > TQAction< / a > , and < a href = "misc.html" > Miscellaneous Classes< / a > .
< hr > < h2 > Member Function Documentation< / h2 >
< h3 class = fn > < a name = "TQMenuData" > < / a > TQMenuData::TQMenuData ()
< / h3 >
Constructs an empty menu data list.
< h3 class = fn > < a name = "~TQMenuData" > < / a > TQMenuData::~TQMenuData ()< tt > [virtual]< / tt >
< / h3 >
Removes all menu items and disconnects any signals that have been
connected.
< h3 class = fn > < a href = "ntqkeysequence.html" > TQKeySequence< / a > < a name = "accel" > < / a > TQMenuData::accel ( int id ) const
< / h3 >
Returns the accelerator key that has been defined for the menu
item < em > id< / em > , or 0 if it has no accelerator key or if there is no
such menu item.
< p > < p > See also < a href = "#setAccel" > setAccel< / a > (), < a href = "ntqaccel.html" > TQAccel< / a > , and < a href = "qnamespace-h.html" > ntqnamespace.h< / a > .
< h3 class = fn > void < a name = "activateItemAt" > < / a > TQMenuData::activateItemAt ( int index )< tt > [virtual]< / tt >
< / h3 >
Activates the menu item at position < em > index< / em > .
< p > If the index is invalid (for example, -1), the object itself is
deactivated.
< h3 class = fn > void < a name = "changeItem" > < / a > TQMenuData::changeItem ( int id, const < a href = "ntqstring.html" > TQString< / a > & text )
< / h3 >
Changes the text of the menu item < em > id< / em > to < em > text< / em > . If the item
has an icon, the icon remains unchanged.
< p > < p > See also < a href = "#text" > text< / a > ().
< h3 class = fn > void < a name = "changeItem-2" > < / a > TQMenuData::changeItem ( int id, const < a href = "ntqpixmap.html" > TQPixmap< / a > & pixmap )
< / h3 >
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
< p > Changes the pixmap of the menu item < em > id< / em > to the pixmap < em > pixmap< / em > .
If the item has an icon, the icon is unchanged.
< p > < p > See also < a href = "#pixmap" > pixmap< / a > ().
< h3 class = fn > void < a name = "changeItem-3" > < / a > TQMenuData::changeItem ( int id, const < a href = "ntqiconset.html" > TQIconSet< / a > & icon, const < a href = "ntqstring.html" > TQString< / a > & text )
< / h3 >
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
< p > Changes the iconset and text of the menu item < em > id< / em > to the < em > icon< / em >
and < em > text< / em > respectively.
< p > < p > See also < a href = "#pixmap" > pixmap< / a > ().
< h3 class = fn > void < a name = "changeItem-4" > < / a > TQMenuData::changeItem ( int id, const < a href = "ntqiconset.html" > TQIconSet< / a > & icon, const < a href = "ntqpixmap.html" > TQPixmap< / a > & pixmap )
< / h3 >
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
< p > Changes the iconset and pixmap of the menu item < em > id< / em > to < em > icon< / em >
and < em > pixmap< / em > respectively.
< p > < p > See also < a href = "#pixmap" > pixmap< / a > ().
< h3 class = fn > void < a name = "changeItem-5" > < / a > TQMenuData::changeItem ( const < a href = "ntqstring.html" > TQString< / a > & text, int id )
< / h3 >
< b > This function is obsolete.< / b > It is provided to keep old source working. We strongly advise against using it in new code.
< p > Changes the text of the menu item < em > id< / em > . If the item has an icon,
the icon remains unchanged.
< p > < p > See also < a href = "#text" > text< / a > ().
< h3 class = fn > void < a name = "changeItem-6" > < / a > TQMenuData::changeItem ( const < a href = "ntqpixmap.html" > TQPixmap< / a > & pixmap, int id )
< / h3 >
< b > This function is obsolete.< / b > It is provided to keep old source working. We strongly advise against using it in new code.
< p > Changes the pixmap of the menu item < em > id< / em > . If the item has an icon,
the icon remains unchanged.
< p > < p > See also < a href = "#pixmap" > pixmap< / a > ().
< h3 class = fn > void < a name = "changeItem-7" > < / a > TQMenuData::changeItem ( const < a href = "ntqiconset.html" > TQIconSet< / a > & icon, const < a href = "ntqstring.html" > TQString< / a > & text, int id )
< / h3 >
< b > This function is obsolete.< / b > It is provided to keep old source working. We strongly advise against using it in new code.
< p > Changes the icon and text of the menu item < em > id< / em > .
< p > < p > See also < a href = "#pixmap" > pixmap< / a > ().
< h3 class = fn > void < a name = "clear" > < / a > TQMenuData::clear ()
< / h3 >
Removes all menu items.
< p > < p > See also < a href = "#removeItem" > removeItem< / a > () and < a href = "#removeItemAt" > removeItemAt< / a > ().
< p > Examples: < a href = "mdi-example.html#x2029" > mdi/application.cpp< / a > and < a href = "qwerty-example.html#x370" > qwerty/qwerty.cpp< / a > .
< h3 class = fn > bool < a name = "connectItem" > < / a > TQMenuData::connectItem ( int id, const < a href = "tqobject.html" > TQObject< / a > * receiver, const char * member )
< / h3 >
Connects the menu item with identifier < em > id< / em > to < em > receiver< / em > 's < em > member< / em > slot or signal.
< p > The receiver's slot (or signal) is activated when the menu item is
activated.
< p > < p > See also < a href = "#disconnectItem" > disconnectItem< / a > () and < a href = "#setItemParameter" > setItemParameter< / a > ().
< p > Example: < a href = "menu-example.html#x1868" > menu/menu.cpp< / a > .
< h3 class = fn > uint < a name = "count" > < / a > TQMenuData::count () const
< / h3 >
Returns the number of items in the menu.
< h3 class = fn > bool < a name = "disconnectItem" > < / a > TQMenuData::disconnectItem ( int id, const < a href = "tqobject.html" > TQObject< / a > * receiver, const char * member )
< / h3 >
Disconnects the < em > receiver< / em > 's < em > member< / em > from the menu item with
identifier < em > id< / em > .
< p > All connections are removed when the menu data object is
destroyed.
< p > < p > See also < a href = "#connectItem" > connectItem< / a > () and < a href = "#setItemParameter" > setItemParameter< / a > ().
< h3 class = fn > TQMenuItem * < a name = "findItem" > < / a > TQMenuData::findItem ( int id ) const
< / h3 >
Returns the menu item with identifier < em > id< / em > , or 0 if there is no
item with this identifier.
< p > Note that TQMenuItem is an internal class, and that you should not
need to call this function. Use the higher level functions like
< a href = "#text" > text< / a > (), < a href = "#pixmap" > pixmap< / a > () and < a href = "#changeItem" > changeItem< / a > () to get and modify menu item
attributes instead.
< p > < p > See also < a href = "#indexOf" > indexOf< / a > ().
< p > Example: < a href = "canvas-chart-example.html#x2882" > chart/chartform.cpp< / a > .
< h3 class = fn > TQMenuItem * < a name = "findItem-2" > < / a > TQMenuData::findItem ( int id, < a href = "ntqmenudata.html" > TQMenuData< / a > ** parent ) const
< / h3 >
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
< p > Returns the menu item with identifier < em > id< / em > , or 0 if there is no
item with this identifier. Changes < em > *parent< / em > to point to the
parent of the return value.
< p > Note that TQMenuItem is an internal class, and that you should not
need to call this function. Use the higher level functions like
< a href = "#text" > text< / a > (), < a href = "#pixmap" > pixmap< / a > () and < a href = "#changeItem" > changeItem< / a > () to get and modify menu item
attributes instead.
< p > < p > See also < a href = "#indexOf" > indexOf< / a > ().
< h3 class = fn > < a href = "ntqiconset.html" > TQIconSet< / a > * < a name = "iconSet" > < / a > TQMenuData::iconSet ( int id ) const
< / h3 >
Returns the icon set that has been set for menu item < em > id< / em > , or 0
if no icon set has been set.
< p > < p > See also < a href = "#changeItem" > changeItem< / a > (), < a href = "#text" > text< / a > (), and < a href = "#pixmap" > pixmap< / a > ().
< h3 class = fn > int < a name = "idAt" > < / a > TQMenuData::idAt ( int index ) const
< / h3 >
Returns the identifier of the menu item at position < em > index< / em > in
the internal list, or -1 if < em > index< / em > is out of range.
< p > < p > See also < a href = "#setId" > setId< / a > () and < a href = "#indexOf" > indexOf< / a > ().
< h3 class = fn > int < a name = "indexOf" > < / a > TQMenuData::indexOf ( int id ) const
< / h3 >
Returns the index of the menu item with identifier < em > id< / em > , or -1 if
there is no item with this identifier.
< p > < p > See also < a href = "#idAt" > idAt< / a > () and < a href = "#findItem" > findItem< / a > ().
< p > Example: < a href = "scrollview-example.html#x633" > scrollview/scrollview.cpp< / a > .
< h3 class = fn > int < a name = "insertItem" > < / a > TQMenuData::insertItem ( const < a href = "ntqstring.html" > TQString< / a > & text, const < a href = "tqobject.html" > TQObject< / a > * receiver, const char * member, const < a href = "ntqkeysequence.html" > TQKeySequence< / a > & accel = 0, int id = -1, int index = -1 )
< / h3 >
The family of < a href = "#insertItem" > insertItem< / a > () functions inserts menu items into a
popup menu or a menu bar.
< p > A menu item is usually either a text string or a pixmap, both with
an optional icon or keyboard accelerator. For special cases it is
also possible to insert custom items (see < a href = "qcustommenuitem.html" > TQCustomMenuItem< / a > ) or
even widgets into popup menus.
< p > Some insertItem() members take a popup menu as an additional
argument. Use this to insert submenus into existing menus or
pulldown menus into a menu bar.
< p > The number of insert functions may look confusing, but they are
actually quite simple to use.
< p > This default version inserts a menu item with the text < em > text< / em > ,
the accelerator key < em > accel< / em > , an id and an optional index and
connects it to the slot < em > member< / em > in the object < em > receiver< / em > .
< p > Example:
< pre >
< a href = "ntqmenubar.html" > TQMenuBar< / a > *mainMenu = new < a href = "ntqmenubar.html" > TQMenuBar< / a > ;
< a href = "ntqpopupmenu.html" > TQPopupMenu< / a > *fileMenu = new < a href = "ntqpopupmenu.html" > TQPopupMenu< / a > ;
fileMenu-> < a href = "#insertItem" > insertItem< / a > ( "New", myView, TQ_SLOT(newFile()), CTRL+Key_N );
fileMenu-> < a href = "#insertItem" > insertItem< / a > ( "Open", myView, TQ_SLOT(open()), CTRL+Key_O );
mainMenu-> < a href = "#insertItem" > insertItem< / a > ( "File", fileMenu );
< / pre >
< p > Not all insert functions take an object/slot parameter or an
accelerator key. Use < a href = "#connectItem" > connectItem< / a > () and < a href = "#setAccel" > setAccel< / a > () on those items.
< p > If you need to translate accelerators, use tr() with the text and
accelerator. (For translations use a string < a href = "ntqkeysequence.html" > key
sequence< / a > .):
< pre >
fileMenu-> insertItem( tr("Open"), myView, TQ_SLOT(open()),
tr("Ctrl+O") );
< / pre >
< p > In the example above, pressing Ctrl+O or selecting "Open" from the
menu activates the myView->open() function.
< p > Some insert functions take a < a href = "ntqiconset.html" > TQIconSet< / a > parameter to specify the
little menu item icon. Note that you can always pass a < a href = "ntqpixmap.html" > TQPixmap< / a >
object instead.
< p > The < em > id< / em > specifies the identification number associated with the
menu item. Note that only positive values are valid, as a negative
value will make TQt select a unique id for the item.
< p > The < em > index< / em > specifies the position in the menu. The menu item is
appended at the end of the list if < em > index< / em > is negative.
< p > Note that keyboard accelerators in TQt are not application-global,
instead they are bound to a certain top-level window. For example,
accelerators in < a href = "ntqpopupmenu.html" > TQPopupMenu< / a > items only work for menus that are
associated with a certain window. This is true for popup menus
that live in a menu bar since their accelerators will then be
installed in the menu bar itself. This also applies to stand-alone
popup menus that have a top-level widget in their parentWidget()
chain. The menu will then install its accelerator object on that
top-level widget. For all other cases use an independent < a href = "ntqaccel.html" > TQAccel< / a >
object.
< p > < b > Warning:< / b > Be careful when passing a literal 0 to < a href = "#insertItem" > insertItem< / a > ()
because some C++ compilers choose the wrong overloaded function.
Cast the 0 to what you mean, e.g. < tt > (TQObject*)0< / tt > .
< p > < b > Warning:< / b > On Mac OS X, items that connect to a slot that are inserted into a
menubar will not function as we use the native menubar that knows nothing
about signals or slots. Instead insert the items into a popup menu and
insert the popup menu into the menubar. This may be fixed in a future TQt
version.
< p > Returns the allocated < a href = "ntqmenudata.html#menu-identifier" > menu identifier< / a > number (< em > id< / em > if < em > id< / em > >= 0).
< p > < p > See also < a href = "#removeItem" > removeItem< / a > (), < a href = "#changeItem" > changeItem< / a > (), < a href = "#setAccel" > setAccel< / a > (), < a href = "#connectItem" > connectItem< / a > (), < a href = "ntqaccel.html" > TQAccel< / a > , and < a href = "qnamespace-h.html" > ntqnamespace.h< / a > .
< p > Examples: < a href = "addressbook-example.html#x569" > addressbook/mainwindow.cpp< / a > , < a href = "canvas-example.html#x2936" > canvas/canvas.cpp< / a > , < a href = "menu-example.html#x1869" > menu/menu.cpp< / a > , < a href = "qwerty-example.html#x371" > qwerty/qwerty.cpp< / a > , < a href = "scrollview-example.html#x634" > scrollview/scrollview.cpp< / a > , < a href = "showimg-example.html#x1327" > showimg/showimg.cpp< / a > , and < a href = "sound-example.html#x2810" > sound/sound.cpp< / a > .
< h3 class = fn > int < a name = "insertItem-2" > < / a > TQMenuData::insertItem ( const < a href = "ntqiconset.html" > TQIconSet< / a > & icon, const < a href = "ntqstring.html" > TQString< / a > & text, const < a href = "tqobject.html" > TQObject< / a > * receiver, const char * member, const < a href = "ntqkeysequence.html" > TQKeySequence< / a > & accel = 0, int id = -1, int index = -1 )
< / h3 >
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
< p > Inserts a menu item with icon < em > icon< / em > , text < em > text< / em > , accelerator
< em > accel< / em > , optional id < em > id< / em > , and optional < em > index< / em > position. The
menu item is connected it to the < em > receiver< / em > 's < em > member< / em > slot. The
icon will be displayed to the left of the text in the item.
< p > Returns the allocated < a href = "ntqmenudata.html#menu-identifier" > menu identifier< / a > number (< em > id< / em > if < em > id< / em > >= 0).
< p > < p > See also < a href = "#removeItem" > removeItem< / a > (), < a href = "#changeItem" > changeItem< / a > (), < a href = "#setAccel" > setAccel< / a > (), < a href = "#connectItem" > connectItem< / a > (), < a href = "ntqaccel.html" > TQAccel< / a > , and < a href = "qnamespace-h.html" > ntqnamespace.h< / a > .
< h3 class = fn > int < a name = "insertItem-3" > < / a > TQMenuData::insertItem ( const < a href = "ntqpixmap.html" > TQPixmap< / a > & pixmap, const < a href = "tqobject.html" > TQObject< / a > * receiver, const char * member, const < a href = "ntqkeysequence.html" > TQKeySequence< / a > & accel = 0, int id = -1, int index = -1 )
< / h3 >
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
< p > Inserts a menu item with pixmap < em > pixmap< / em > , accelerator < em > accel< / em > ,
optional id < em > id< / em > , and optional < em > index< / em > position. The menu item
is connected it to the < em > receiver< / em > 's < em > member< / em > slot. The icon will
be displayed to the left of the text in the item.
< p > To look best when being highlighted as a menu item, the pixmap
should provide a mask (see < a href = "ntqpixmap.html#mask" > TQPixmap::mask< / a > ()).
< p > Returns the allocated < a href = "ntqmenudata.html#menu-identifier" > menu identifier< / a > number (< em > id< / em > if < em > id< / em > >= 0).
< p > < p > See also < a href = "#removeItem" > removeItem< / a > (), < a href = "#changeItem" > changeItem< / a > (), < a href = "#setAccel" > setAccel< / a > (), and < a href = "#connectItem" > connectItem< / a > ().
< h3 class = fn > int < a name = "insertItem-4" > < / a > TQMenuData::insertItem ( const < a href = "ntqiconset.html" > TQIconSet< / a > & icon, const < a href = "ntqpixmap.html" > TQPixmap< / a > & pixmap, const < a href = "tqobject.html" > TQObject< / a > * receiver, const char * member, const < a href = "ntqkeysequence.html" > TQKeySequence< / a > & accel = 0, int id = -1, int index = -1 )
< / h3 >
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
< p > Inserts a menu item with icon < em > icon< / em > , pixmap < em > pixmap< / em > ,
accelerator < em > accel< / em > , optional id < em > id< / em > , and optional < em > index< / em >
position. The icon will be displayed to the left of the pixmap in
the item. The item is connected to the < em > member< / em > slot in the < em > receiver< / em > object.
< p > To look best when being highlighted as a menu item, the pixmap
should provide a mask (see < a href = "ntqpixmap.html#mask" > TQPixmap::mask< / a > ()).
< p > Returns the allocated < a href = "ntqmenudata.html#menu-identifier" > menu identifier< / a > number (< em > id< / em > if < em > id< / em > >= 0).
< p > < p > See also < a href = "#removeItem" > removeItem< / a > (), < a href = "#changeItem" > changeItem< / a > (), < a href = "#setAccel" > setAccel< / a > (), < a href = "#connectItem" > connectItem< / a > (), < a href = "ntqaccel.html" > TQAccel< / a > , and < a href = "qnamespace-h.html" > ntqnamespace.h< / a > .
< h3 class = fn > int < a name = "insertItem-5" > < / a > TQMenuData::insertItem ( const < a href = "ntqstring.html" > TQString< / a > & text, int id = -1, int index = -1 )
< / h3 >
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
< p > Inserts a menu item with text < em > text< / em > , optional id < em > id< / em > , and
optional < em > index< / em > position.
< p > Returns the allocated < a href = "ntqmenudata.html#menu-identifier" > menu identifier< / a > number (< em > id< / em > if < em > id< / em > >= 0).
< p > < p > See also < a href = "#removeItem" > removeItem< / a > (), < a href = "#changeItem" > changeItem< / a > (), < a href = "#setAccel" > setAccel< / a > (), and < a href = "#connectItem" > connectItem< / a > ().
< h3 class = fn > int < a name = "insertItem-6" > < / a > TQMenuData::insertItem ( const < a href = "ntqiconset.html" > TQIconSet< / a > & icon, const < a href = "ntqstring.html" > TQString< / a > & text, int id = -1, int index = -1 )
< / h3 >
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
< p > Inserts a menu item with icon < em > icon< / em > , text < em > text< / em > , optional id
< em > id< / em > , and optional < em > index< / em > position. The icon will be displayed
to the left of the text in the item.
< p > Returns the allocated < a href = "ntqmenudata.html#menu-identifier" > menu identifier< / a > number (< em > id< / em > if < em > id< / em > >= 0).
< p > < p > See also < a href = "#removeItem" > removeItem< / a > (), < a href = "#changeItem" > changeItem< / a > (), < a href = "#setAccel" > setAccel< / a > (), and < a href = "#connectItem" > connectItem< / a > ().
< h3 class = fn > int < a name = "insertItem-7" > < / a > TQMenuData::insertItem ( const < a href = "ntqstring.html" > TQString< / a > & text, < a href = "ntqpopupmenu.html" > TQPopupMenu< / a > * popup, int id = -1, int index = -1 )
< / h3 >
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
< p > Inserts a menu item with text < em > text< / em > , submenu < em > popup< / em > , optional
id < em > id< / em > , and optional < em > index< / em > position.
< p > The < em > popup< / em > must be deleted by the programmer or by its parent
widget. It is not deleted when this menu item is removed or when
the menu is deleted.
< p > Returns the allocated < a href = "ntqmenudata.html#menu-identifier" > menu identifier< / a > number (< em > id< / em > if < em > id< / em > >= 0).
< p > < p > See also < a href = "#removeItem" > removeItem< / a > (), < a href = "#changeItem" > changeItem< / a > (), < a href = "#setAccel" > setAccel< / a > (), and < a href = "#connectItem" > connectItem< / a > ().
< h3 class = fn > int < a name = "insertItem-8" > < / a > TQMenuData::insertItem ( const < a href = "ntqiconset.html" > TQIconSet< / a > & icon, const < a href = "ntqstring.html" > TQString< / a > & text, < a href = "ntqpopupmenu.html" > TQPopupMenu< / a > * popup, int id = -1, int index = -1 )
< / h3 >
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
< p > Inserts a menu item with icon < em > icon< / em > , text < em > text< / em > , submenu < em > popup< / em > , optional id < em > id< / em > , and optional < em > index< / em > position. The icon
will be displayed to the left of the text in the item.
< p > The < em > popup< / em > must be deleted by the programmer or by its parent
widget. It is not deleted when this menu item is removed or when
the menu is deleted.
< p > Returns the allocated < a href = "ntqmenudata.html#menu-identifier" > menu identifier< / a > number (< em > id< / em > if < em > id< / em > >= 0).
< p > < p > See also < a href = "#removeItem" > removeItem< / a > (), < a href = "#changeItem" > changeItem< / a > (), < a href = "#setAccel" > setAccel< / a > (), and < a href = "#connectItem" > connectItem< / a > ().
< h3 class = fn > int < a name = "insertItem-9" > < / a > TQMenuData::insertItem ( const < a href = "ntqpixmap.html" > TQPixmap< / a > & pixmap, int id = -1, int index = -1 )
< / h3 >
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
< p > Inserts a menu item with pixmap < em > pixmap< / em > , optional id < em > id< / em > , and
optional < em > index< / em > position.
< p > To look best when being highlighted as a menu item, the pixmap
should provide a mask (see < a href = "ntqpixmap.html#mask" > TQPixmap::mask< / a > ()).
< p > Returns the allocated < a href = "ntqmenudata.html#menu-identifier" > menu identifier< / a > number (< em > id< / em > if < em > id< / em > >= 0).
< p > < p > See also < a href = "#removeItem" > removeItem< / a > (), < a href = "#changeItem" > changeItem< / a > (), < a href = "#setAccel" > setAccel< / a > (), and < a href = "#connectItem" > connectItem< / a > ().
< h3 class = fn > int < a name = "insertItem-a" > < / a > TQMenuData::insertItem ( const < a href = "ntqiconset.html" > TQIconSet< / a > & icon, const < a href = "ntqpixmap.html" > TQPixmap< / a > & pixmap, int id = -1, int index = -1 )
< / h3 >
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
< p > Inserts a menu item with icon < em > icon< / em > , pixmap < em > pixmap< / em > , optional
id < em > id< / em > , and optional < em > index< / em > position. The icon will be
displayed to the left of the pixmap in the item.
< p > Returns the allocated < a href = "ntqmenudata.html#menu-identifier" > menu identifier< / a > number (< em > id< / em > if < em > id< / em > >= 0).
< p > < p > See also < a href = "#removeItem" > removeItem< / a > (), < a href = "#changeItem" > changeItem< / a > (), < a href = "#setAccel" > setAccel< / a > (), and < a href = "#connectItem" > connectItem< / a > ().
< h3 class = fn > int < a name = "insertItem-b" > < / a > TQMenuData::insertItem ( const < a href = "ntqpixmap.html" > TQPixmap< / a > & pixmap, < a href = "ntqpopupmenu.html" > TQPopupMenu< / a > * popup, int id = -1, int index = -1 )
< / h3 >
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
< p > Inserts a menu item with pixmap < em > pixmap< / em > , submenu < em > popup< / em > ,
optional id < em > id< / em > , and optional < em > index< / em > position.
< p > The < em > popup< / em > must be deleted by the programmer or by its parent
widget. It is not deleted when this menu item is removed or when
the menu is deleted.
< p > Returns the allocated < a href = "ntqmenudata.html#menu-identifier" > menu identifier< / a > number (< em > id< / em > if < em > id< / em > >= 0).
< p > < p > See also < a href = "#removeItem" > removeItem< / a > (), < a href = "#changeItem" > changeItem< / a > (), < a href = "#setAccel" > setAccel< / a > (), and < a href = "#connectItem" > connectItem< / a > ().
< h3 class = fn > int < a name = "insertItem-c" > < / a > TQMenuData::insertItem ( const < a href = "ntqiconset.html" > TQIconSet< / a > & icon, const < a href = "ntqpixmap.html" > TQPixmap< / a > & pixmap, < a href = "ntqpopupmenu.html" > TQPopupMenu< / a > * popup, int id = -1, int index = -1 )
< / h3 >
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
< p > Inserts a menu item with icon < em > icon< / em > , pixmap < em > pixmap< / em > submenu < em > popup< / em > , optional id < em > id< / em > , and optional < em > index< / em > position. The icon
will be displayed to the left of the pixmap in the item.
< p > The < em > popup< / em > must be deleted by the programmer or by its parent
widget. It is not deleted when this menu item is removed or when
the menu is deleted.
< p > Returns the allocated < a href = "ntqmenudata.html#menu-identifier" > menu identifier< / a > number (< em > id< / em > if < em > id< / em > >= 0).
< p > < p > See also < a href = "#removeItem" > removeItem< / a > (), < a href = "#changeItem" > changeItem< / a > (), < a href = "#setAccel" > setAccel< / a > (), and < a href = "#connectItem" > connectItem< / a > ().
< h3 class = fn > int < a name = "insertItem-d" > < / a > TQMenuData::insertItem ( < a href = "tqwidget.html" > TQWidget< / a > * widget, int id = -1, int index = -1 )
< / h3 >
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
< p > Inserts a menu item that consists of the widget < em > widget< / em > with
optional id < em > id< / em > , and optional < em > index< / em > position.
< p > Ownership of < em > widget< / em > is transferred to the popup menu or to the
menu bar.
< p > Theoretically, any widget can be inserted into a popup menu. In
practice, this only makes sense with certain widgets.
< p > If a widget is not focus-enabled (see
< a href = "tqwidget.html#isFocusEnabled" > TQWidget::isFocusEnabled< / a > ()), the menu treats it as a separator;
this means that the item is not selectable and will never get
focus. In this way you can, for example, simply insert a < a href = "ntqlabel.html" > TQLabel< / a > if
you need a popup menu with a title.
< p > If the widget is focus-enabled it will get focus when the user
traverses the popup menu with the arrow keys. If the widget does
not accept < tt > ArrowUp< / tt > and < tt > ArrowDown< / tt > in its key event handler,
the focus will move back to the menu when the respective arrow key
is hit one more time. This works with a < a href = "ntqlineedit.html" > TQLineEdit< / a > , for example. If
the widget accepts the arrow key itself, it must also provide the
possibility to put the focus back on the menu again by calling
< a href = "tqwidget.html#focusNextPrevChild" > TQWidget::focusNextPrevChild< / a > (). Futhermore, if the embedded widget
closes the menu when the user made a selection, this can be done
safely by calling:
< pre >
if ( isVisible() & &
parentWidget() & &
parentWidget()-> inherits("TQPopupMenu") )
parentWidget()-> close();
< / pre >
< p > Returns the allocated < a href = "ntqmenudata.html#menu-identifier" > menu identifier< / a > number (< em > id< / em > if < em > id< / em > >= 0).
< p > < p > See also < a href = "#removeItem" > removeItem< / a > ().
< h3 class = fn > int < a name = "insertItem-e" > < / a > TQMenuData::insertItem ( const < a href = "ntqiconset.html" > TQIconSet< / a > & icon, < a href = "qcustommenuitem.html" > TQCustomMenuItem< / a > * custom, int id = -1, int index = -1 )
< / h3 >
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
< p > Inserts a custom menu item < em > custom< / em > with an < em > icon< / em > and with
optional id < em > id< / em > , and optional < em > index< / em > position.
< p > This only works with popup menus. It is not supported for menu
bars. Ownership of < em > custom< / em > is transferred to the popup menu.
< p > If you want to connect a custom item to a slot, use < a href = "#connectItem" > connectItem< / a > ().
< p > Returns the allocated < a href = "ntqmenudata.html#menu-identifier" > menu identifier< / a > number (< em > id< / em > if < em > id< / em > >= 0).
< p > < p > See also < a href = "#connectItem" > connectItem< / a > (), < a href = "#removeItem" > removeItem< / a > (), and < a href = "qcustommenuitem.html" > TQCustomMenuItem< / a > .
< h3 class = fn > int < a name = "insertItem-f" > < / a > TQMenuData::insertItem ( < a href = "qcustommenuitem.html" > TQCustomMenuItem< / a > * custom, int id = -1, int index = -1 )
< / h3 >
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
< p > Inserts a custom menu item < em > custom< / em > with optional id < em > id< / em > , and
optional < em > index< / em > position.
< p > This only works with popup menus. It is not supported for menu
bars. Ownership of < em > custom< / em > is transferred to the popup menu.
< p > If you want to connect a custom item to a slot, use < a href = "#connectItem" > connectItem< / a > ().
< p > Returns the allocated < a href = "ntqmenudata.html#menu-identifier" > menu identifier< / a > number (< em > id< / em > if < em > id< / em > >= 0).
< p > < p > See also < a href = "#connectItem" > connectItem< / a > (), < a href = "#removeItem" > removeItem< / a > (), and < a href = "qcustommenuitem.html" > TQCustomMenuItem< / a > .
< h3 class = fn > int < a name = "insertSeparator" > < / a > TQMenuData::insertSeparator ( int index = -1 )
< / h3 >
Inserts a separator at position < em > index< / em > , and returns the < a href = "ntqmenudata.html#menu-identifier" > menu identifier< / a >
number allocated to it. The separator becomes the last menu item if
< em > index< / em > is negative.
< p > In a popup menu a separator is rendered as a horizontal line. In a
< a href = "motif-extension.html#Motif" > Motif< / a > menu bar a separator is spacing, so the rest of the items
(normally just "Help") are drawn right-justified. In a Windows
menu bar separators are ignored (to comply with the Windows style
guidelines).
< p > Examples: < a href = "addressbook-example.html#x570" > addressbook/mainwindow.cpp< / a > , < a href = "menu-example.html#x1870" > menu/menu.cpp< / a > , < a href = "progress-example.html#x69" > progress/progress.cpp< / a > , < a href = "qwerty-example.html#x372" > qwerty/qwerty.cpp< / a > , < a href = "scrollview-example.html#x635" > scrollview/scrollview.cpp< / a > , < a href = "showimg-example.html#x1328" > showimg/showimg.cpp< / a > , and < a href = "sound-example.html#x2811" > sound/sound.cpp< / a > .
< h3 class = fn > bool < a name = "isItemActive" > < / a > TQMenuData::isItemActive ( int id ) const
< / h3 >
Returns TRUE if the menu item with the id < em > id< / em > is currently
active; otherwise returns FALSE.
< h3 class = fn > bool < a name = "isItemChecked" > < / a > TQMenuData::isItemChecked ( int id ) const
< / h3 >
Returns TRUE if the menu item with the id < em > id< / em > has been checked;
otherwise returns FALSE.
< p > < p > See also < a href = "#setItemChecked" > setItemChecked< / a > ().
< p > Examples: < a href = "canvas-example.html#x2938" > canvas/canvas.cpp< / a > , < a href = "progress-example.html#x70" > progress/progress.cpp< / a > , and < a href = "showimg-example.html#x1329" > showimg/showimg.cpp< / a > .
< h3 class = fn > bool < a name = "isItemEnabled" > < / a > TQMenuData::isItemEnabled ( int id ) const
< / h3 >
Returns TRUE if the item with identifier < em > id< / em > is enabled;
otherwise returns FALSE
< p > < p > See also < a href = "#setItemEnabled" > setItemEnabled< / a > () and < a href = "#isItemVisible" > isItemVisible< / a > ().
< h3 class = fn > bool < a name = "isItemVisible" > < / a > TQMenuData::isItemVisible ( int id ) const
< / h3 >
Returns TRUE if the menu item with the id < em > id< / em > is visible;
otherwise returns FALSE.
< p > < p > See also < a href = "#setItemVisible" > setItemVisible< / a > ().
< h3 class = fn > int < a name = "itemParameter" > < / a > TQMenuData::itemParameter ( int id ) const
< / h3 >
Returns the parameter of the activation signal of item < em > id< / em > .
< p > If no parameter has been specified for this item with
< a href = "#setItemParameter" > setItemParameter< / a > (), the value defaults to < em > id< / em > .
< p > < p > See also < a href = "#connectItem" > connectItem< / a > (), < a href = "#disconnectItem" > disconnectItem< / a > (), and < a href = "#setItemParameter" > setItemParameter< / a > ().
< h3 class = fn > void < a name = "menuContentsChanged" > < / a > TQMenuData::menuContentsChanged ()< tt > [virtual protected]< / tt >
< / h3 >
Virtual function; notifies subclasses that one or more items have
been inserted or removed.
< p > Reimplemented in < a href = "ntqmenubar.html#menuContentsChanged" > TQMenuBar< / a > .
< h3 class = fn > void < a name = "menuDelPopup" > < / a > TQMenuData::menuDelPopup ( < a href = "ntqpopupmenu.html" > TQPopupMenu< / a > * )< tt > [virtual protected]< / tt >
< / h3 >
Virtual function; notifies subclasses that a popup menu item has
been removed.
< h3 class = fn > void < a name = "menuInsPopup" > < / a > TQMenuData::menuInsPopup ( < a href = "ntqpopupmenu.html" > TQPopupMenu< / a > * )< tt > [virtual protected]< / tt >
< / h3 >
Virtual function; notifies subclasses that a popup menu item has
been inserted.
< h3 class = fn > void < a name = "menuStateChanged" > < / a > TQMenuData::menuStateChanged ()< tt > [virtual protected]< / tt >
< / h3 >
Virtual function; notifies subclasses that one or more items have
changed state (enabled/disabled or checked/unchecked).
< p > Reimplemented in < a href = "ntqmenubar.html#menuStateChanged" > TQMenuBar< / a > .
< h3 class = fn > < a href = "ntqpixmap.html" > TQPixmap< / a > * < a name = "pixmap" > < / a > TQMenuData::pixmap ( int id ) const
< / h3 >
Returns the pixmap that has been set for menu item < em > id< / em > , or 0 if
no pixmap has been set.
< p > < p > See also < a href = "#changeItem" > changeItem< / a > (), < a href = "#text" > text< / a > (), and < a href = "#iconSet" > iconSet< / a > ().
< h3 class = fn > void < a name = "removeItem" > < / a > TQMenuData::removeItem ( int id )
< / h3 >
< p > Removes the menu item that has the identifier < em > id< / em > .
< p > < p > See also < a href = "#removeItemAt" > removeItemAt< / a > () and < a href = "#clear" > clear< / a > ().
< p > Example: < a href = "canvas-chart-example.html#x2885" > chart/chartform.cpp< / a > .
< h3 class = fn > void < a name = "removeItemAt" > < / a > TQMenuData::removeItemAt ( int index )
< / h3 >
Removes the menu item at position < em > index< / em > .
< p > < p > See also < a href = "#removeItem" > removeItem< / a > () and < a href = "#clear" > clear< / a > ().
< h3 class = fn > void < a name = "setAccel" > < / a > TQMenuData::setAccel ( const < a href = "ntqkeysequence.html" > TQKeySequence< / a > & key, int id )
< / h3 >
Sets the accelerator key for the menu item < em > id< / em > to < em > key< / em > .
< p > An accelerator key consists of a key code and a combination of the
modifiers < tt > SHIFT< / tt > , < tt > CTRL< / tt > , < tt > ALT< / tt > or < tt > UNICODE_ACCEL< / tt > (OR'ed or
added). The header file < a href = "qnamespace-h.html" > ntqnamespace.h< / a > contains a list of key
codes.
< p > Defining an accelerator key produces a text that is added to the
menu item; for instance, < tt > CTRL< / tt > + < tt > Key_O< / tt > produces "Ctrl+O". The
text is formatted differently for different platforms.
< p > Note that keyboard accelerators in TQt are not application-global,
instead they are bound to a certain top-level window. For example,
accelerators in < a href = "ntqpopupmenu.html" > TQPopupMenu< / a > items only work for menus that are
associated with a certain window. This is true for popup menus
that live in a menu bar since their accelerators will then be
installed in the menu bar itself. This also applies to stand-alone
popup menus that have a top-level widget in their parentWidget()
chain. The menu will then install its accelerator object on that
top-level widget. For all other cases use an independent < a href = "ntqaccel.html" > TQAccel< / a >
object.
< p > Example:
< pre >
< a href = "ntqmenubar.html" > TQMenuBar< / a > *mainMenu = new < a href = "ntqmenubar.html" > TQMenuBar< / a > ;
< a href = "ntqpopupmenu.html" > TQPopupMenu< / a > *fileMenu = new < a href = "ntqpopupmenu.html" > TQPopupMenu< / a > ; // file sub menu
fileMenu-> < a href = "#insertItem" > insertItem< / a > ( "Open Document", 67 ); // add "Open" item
fileMenu-> < a href = "#setAccel" > setAccel< / a > ( CTRL + Key_O, 67 ); // Ctrl+O to open
fileMenu-> < a href = "#insertItem" > insertItem< / a > ( "Quit", 69 ); // add "Quit" item
fileMenu-> < a href = "#setAccel" > setAccel< / a > ( CTRL + ALT + Key_Delete, 69 ); // add Alt+Del to quit
mainMenu-> < a href = "#insertItem" > insertItem< / a > ( "File", fileMenu ); // add the file menu
< / pre >
< p > If you need to translate accelerators, use tr() with a string:
< pre >
fileMenu-> setAccel( tr("Ctrl+O"), 67 );
< / pre >
< p > You can also specify the accelerator in the < a href = "#insertItem" > insertItem< / a > () function.
You may prefer to use < a href = "ntqaction.html" > TQAction< / a > to associate accelerators with menu
items.
< p > < p > See also < a href = "#accel" > accel< / a > (), < a href = "#insertItem" > insertItem< / a > (), < a href = "ntqaccel.html" > TQAccel< / a > , and < a href = "ntqaction.html" > TQAction< / a > .
< p > Example: < a href = "menu-example.html#x1871" > menu/menu.cpp< / a > .
< h3 class = fn > void < a name = "setId" > < / a > TQMenuData::setId ( int index, int id )< tt > [virtual]< / tt >
< / h3 >
Sets the < a href = "ntqmenudata.html#menu-identifier" > menu identifier< / a > of the item at < em > index< / em > to < em > id< / em > .
< p > If < em > index< / em > is out of range, the operation is ignored.
< p > < p > See also < a href = "#idAt" > idAt< / a > ().
< h3 class = fn > void < a name = "setItemChecked" > < / a > TQMenuData::setItemChecked ( int id, bool check )
< / h3 >
If < em > check< / em > is TRUE, checks the menu item with id < em > id< / em > ; otherwise
unchecks the menu item with id < em > id< / em > . Calls
< a href = "ntqpopupmenu.html#setCheckable" > TQPopupMenu::setCheckable< / a > ( TRUE ) if necessary.
< p > < p > See also < a href = "#isItemChecked" > isItemChecked< / a > ().
< p > Examples: < a href = "canvas-example.html#x2939" > canvas/canvas.cpp< / a > , < a href = "grapher-nsplugin-example.html#x2749" > grapher/grapher.cpp< / a > , < a href = "mdi-example.html#x2032" > mdi/application.cpp< / a > , < a href = "menu-example.html#x1872" > menu/menu.cpp< / a > , < a href = "progress-example.html#x71" > progress/progress.cpp< / a > , < a href = "scrollview-example.html#x636" > scrollview/scrollview.cpp< / a > , and < a href = "showimg-example.html#x1330" > showimg/showimg.cpp< / a > .
< h3 class = fn > void < a name = "setItemEnabled" > < / a > TQMenuData::setItemEnabled ( int id, bool enable )
< / h3 >
If < em > enable< / em > is TRUE, enables the menu item with identifier < em > id< / em > ;
otherwise disables the menu item with identifier < em > id< / em > .
< p > < p > See also < a href = "#isItemEnabled" > isItemEnabled< / a > ().
< p > Examples: < a href = "mdi-example.html#x2033" > mdi/application.cpp< / a > , < a href = "menu-example.html#x1873" > menu/menu.cpp< / a > , < a href = "progress-example.html#x72" > progress/progress.cpp< / a > , and < a href = "showimg-example.html#x1331" > showimg/showimg.cpp< / a > .
< h3 class = fn > bool < a name = "setItemParameter" > < / a > TQMenuData::setItemParameter ( int id, int param )
< / h3 >
Sets the parameter of the activation signal of item < em > id< / em > to < em > param< / em > .
< p > If any receiver takes an integer parameter, this value is passed.
< p > < p > See also < a href = "#connectItem" > connectItem< / a > (), < a href = "#disconnectItem" > disconnectItem< / a > (), and < a href = "#itemParameter" > itemParameter< / a > ().
< p > Example: < a href = "mdi-example.html#x2034" > mdi/application.cpp< / a > .
< h3 class = fn > void < a name = "setItemVisible" > < / a > TQMenuData::setItemVisible ( int id, bool visible )
< / h3 >
If < em > visible< / em > is TRUE, shows the menu item with id < em > id< / em > ; otherwise
hides the menu item with id < em > id< / em > .
< p > < p > See also < a href = "#isItemVisible" > isItemVisible< / a > () and < a href = "#isItemEnabled" > isItemEnabled< / a > ().
< h3 class = fn > void < a name = "setWhatsThis" > < / a > TQMenuData::setWhatsThis ( int id, const < a href = "ntqstring.html" > TQString< / a > & text )
< / h3 >
Sets < em > text< / em > as What's This help for the menu item with identifier
< em > id< / em > .
< p > < p > See also < a href = "#whatsThis" > whatsThis< / a > ().
< p > Examples: < a href = "simple-application-example.html#x1554" > application/application.cpp< / a > , < a href = "helpsystem-example.html#x2689" > helpsystem/mainwindow.cpp< / a > , and < a href = "mdi-example.html#x2035" > mdi/application.cpp< / a > .
< h3 class = fn > < a href = "ntqstring.html" > TQString< / a > < a name = "text" > < / a > TQMenuData::text ( int id ) const
< / h3 >
Returns the text that has been set for menu item < em > id< / em > , or
< a href = "ntqstring.html#TQString-null" > TQString::null< / a > if no text has been set.
< p > < p > See also < a href = "#changeItem" > changeItem< / a > (), < a href = "#pixmap" > pixmap< / a > (), and < a href = "#iconSet" > iconSet< / a > ().
< p > Examples: < a href = "qdir-example.html#x1831" > qdir/qdir.cpp< / a > and < a href = "showimg-example.html#x1332" > showimg/showimg.cpp< / a > .
< h3 class = fn > void < a name = "updateItem" > < / a > TQMenuData::updateItem ( int id )< tt > [virtual]< / tt >
< / h3 >
Virtual function; notifies subclasses about an item with < em > id< / em >
that has been changed.
< p > Reimplemented in < a href = "ntqpopupmenu.html#updateItem" > TQPopupMenu< / a > .
< h3 class = fn > < a href = "ntqstring.html" > TQString< / a > < a name = "whatsThis" > < / a > TQMenuData::whatsThis ( int id ) const
< / h3 >
Returns the What's This help text for the item with identifier < em > id< / em > or < a href = "ntqstring.html#TQString-null" > TQString::null< / a > if no text has yet been defined.
< p > < p > See also < a href = "#setWhatsThis" > setWhatsThis< / a > ().
<!-- eof -->
< hr > < p >
This file is part of the < a href = "index.html" > TQt toolkit< / a > .
Copyright © 1995-2007
< a href = "http://www.trolltech.com/" > Trolltech< / a > . All Rights Reserved.< p > < address > < hr > < div align = center >
< table width = 100% cellspacing = 0 border = 0 > < tr >
< td > Copyright © 2007
< a href = "troll.html" > Trolltech< / a > < td align = center > < a href = "trademarks.html" > Trademarks< / a >
< td align = right > < div align = right > TQt 3.3.8< / div >
< / table > < / div > < / address > < / body >
< / html >
