Qt Reference Documentation

# Qt 3 Support Members for QMenuBar

The following class members are part of the Qt 3 support layer. They are provided to help you port old code to Qt 4. We advise against using them in new code.

- QMenuBar class reference

## Public Types

enum | Separator { Never, InWindowsStyle }

## Public Functions

| QMenuBar ( QWidget * parent, const char * name )
QKeySequence | accel ( int id ) const
void | activateItemAt ( int index )
bool | autoGeometry () const
void | changeItem ( int id, const QString & text )
void | changeItem ( int id, const QPixmap & pixmap )
void | changeItem ( int id, const QIcon & icon, const QString & text )
bool | connectItem ( int id, const QObject * receiver, const char * member )
uint | count () const
bool | disconnectItem ( int id, const QObject * receiver, const char * member )
QMenuItem * | findItem ( int id ) const
int | frameWidth () const
QIcon | iconSet ( int id ) const
int | idAt ( int index ) const
int | indexOf ( int id ) const
int | insertItem ( const QString & text, const QObject * receiver, const char * member, const QKeySequence & shortcut = 0, int id = -1, int index = -1 )
int | insertItem ( const QIcon & icon, const QString & text, const QObject * receiver, const char * member, const QKeySequence & shortcut = 0, int id = -1, int index = -1 )
int | insertItem ( const QPixmap & pixmap, const QObject * receiver, const char * member, const QKeySequence & shortcut = 0, int id = -1, int index = -1 )
int | insertItem ( const QString & text, int id = -1, int index = -1 )
int | insertItem ( const QIcon & icon, const QString & text, int id = -1, int index = -1 )
int | insertItem ( const QString & text, QMenu * popup, int id = -1, int index = -1 )
int | insertItem ( const QIcon & icon, const QString & text, QMenu * popup, int id = -1, int index = -1 )
int | insertItem ( const QPixmap & pixmap, int id = -1, int index = -1 )
int | insertItem ( const QPixmap & pixmap, QMenu * popup, int id = -1, int index = -1 )
int | insertSeparator ( int index = -1 )
bool | isItemActive ( int id ) const
bool | isItemChecked ( int id ) const
bool | isItemEnabled ( int id ) const
bool | isItemVisible ( int id ) const
int | itemParameter ( int id ) const
int | margin () const
QPixmap | pixmap ( int id ) const
void | removeItem ( int id )
void | removeItemAt ( int index )
Separator | separator () const
void | setAccel ( const QKeySequence & key, int id )
void | setAutoGeometry ( bool b )
void | setItemChecked ( int id, bool check )
void | setItemEnabled ( int id, bool enable )
bool | setItemParameter ( int id, int param )
void | setItemVisible ( int id, bool visible )
void | setMargin ( int margin )
void | setSeparator ( Separator sep )
void | setWhatsThis ( int id, const QString & w )
QString | text ( int id ) const
QString | whatsThis ( int id ) const

- 60 public functions inherited from QWidget
- 8 public functions inherited from QObject
- 8 public functions inherited from QPaintDevice

## Signals

void | activated ( int itemId )
void | highlighted ( int itemId )

## Protected Functions

int | itemAtPos ( const QPoint & p )
QRect | itemRect ( int index )

- 1 protected function inherited from QObject

## Member Type Documentation

### enum QMenuBar::Separator

Constant | Value
--- | ---
`QMenuBar::Never` | `0`
`QMenuBar::InWindowsStyle` | `1`

## Member Function Documentation

### QMenuBar::QMenuBar ( QWidget * parent, const char * name )

Use one of the constructors that doesn't take the name argument and then use setObjectName() instead.

### QKeySequence QMenuBar::accel ( int id ) const

Use shortcut() on the relevant QAction instead.

See also setAccel().

### void QMenuBar::activateItemAt ( int index )

Use activate() on the relevant QAction instead.

### void QMenuBar::activated ( int itemId )`[signal]`

Use triggered() instead.

### bool QMenuBar::autoGeometry () const

Returns true if the menu bar automatically resizes itself when its parent widget is resized; otherwise returns false.

This feature is provided to help porting to Qt 4. We recommend against using it in new code.

See also setAutoGeometry().

### void QMenuBar::changeItem ( int id, const QString & text )

Use setText() on the relevant QAction instead.

### void QMenuBar::changeItem ( int id, const QPixmap & pixmap )

Use setText() on the relevant QAction instead.

### void QMenuBar::changeItem ( int id, const QIcon & icon, const QString & text )

Use setIcon() and setText() on the relevant QAction instead.

### bool QMenuBar::connectItem ( int id, const QObject * receiver, const char * member )

Use connect() on the relevant QAction instead.

### uint QMenuBar::count () const

Use actions().count() instead.

### bool QMenuBar::disconnectItem ( int id, const QObject * receiver, const char * member )

Use disconnect() on the relevant QAction instead.

### QMenuItem * QMenuBar::findItem ( int id ) const

Use actions instead.

### int QMenuBar::frameWidth () const

Use style()->pixelMetric(QStyle::PM_MenuBarPanelWidth, this) instead.

### void QMenuBar::highlighted ( int itemId )`[signal]`

Use hovered() instead.

### QIcon QMenuBar::iconSet ( int id ) const

Use icon() on the relevant QAction instead.

### int QMenuBar::idAt ( int index ) const

Use actions instead.

### int QMenuBar::indexOf ( int id ) const

Use actions().indexOf(action) on the relevant QAction instead.

### int QMenuBar::insertItem ( const QString & text, const QObject * receiver, const char * member, const QKeySequence & shortcut = 0, int id = -1, int index = -1 )

Use one of the insertAction() or addAction() overloads instead.

### int QMenuBar::insertItem ( const QIcon & icon, const QString & text, const QObject * receiver, const char * member, const QKeySequence & shortcut = 0, int id = -1, int index = -1 )

Use one of the insertAction() or addAction() overloads instead.

### int QMenuBar::insertItem ( const QPixmap & pixmap, const QObject * receiver, const char * member, const QKeySequence & shortcut = 0, int id = -1, int index = -1 )

Use one of the insertAction(), addAction(), insertMenu(), or addMenu() overloads instead.

### int QMenuBar::insertItem ( const QString & text, int id = -1, int index = -1 )

Use one of the insertAction() or addAction() overloads instead.

### int QMenuBar::insertItem ( const QIcon & icon, const QString & text, int id = -1, int index = -1 )

Use one of the insertAction(), addAction(), insertMenu(), or addMenu() overloads instead.

### int QMenuBar::insertItem ( const QString & text, QMenu * popup, int id = -1, int index = -1 )

Use one of the insertMenu(), or addMenu() overloads instead.

### int QMenuBar::insertItem ( const QIcon & icon, const QString & text, QMenu * popup, int id = -1, int index = -1 )

Use one of the insertMenu(), or addMenu() overloads instead.

### int QMenuBar::insertItem ( const QPixmap & pixmap, int id = -1, int index = -1 )

Use one of the insertAction(), addAction(), insertMenu(), or addMenu() overloads instead.

### int QMenuBar::insertItem ( const QPixmap & pixmap, QMenu * popup, int id = -1, int index = -1 )

Use one of the insertMenu(), or addMenu() overloads instead.

### int QMenuBar::insertSeparator ( int index = -1 )

Use addSeparator() or insertAction() instead.

For example, if you have code like

     menuBar->insertSeparator();

you can rewrite it as

     menuBar->addSeparator();

This function was introduced in Qt 4.2.

### bool QMenuBar::isItemActive ( int id ) const

Use activeAction() instead.

### bool QMenuBar::isItemChecked ( int id ) const

Use isChecked() on the relevant QAction instead.

### bool QMenuBar::isItemEnabled ( int id ) const

Use isEnabled() on the relevant QAction instead.

### bool QMenuBar::isItemVisible ( int id ) const

Use isVisible() on the relevant QAction instead.

### int QMenuBar::itemAtPos ( const QPoint & p )`[protected]`

There is no equivalent way to achieve this in Qt 4.

### int QMenuBar::itemParameter ( int id ) const

Use QAction::data() instead.

See also setItemParameter().

### QRect QMenuBar::itemRect ( int index )`[protected]`

Use actionGeometry() on the relevant QAction instead.

### int QMenuBar::margin () const

Returns the width of the margin around the contents of the widget.

Use QWidget::getContentsMargins() instead.

See also setMargin() and QWidget::getContentsMargins().

### QPixmap QMenuBar::pixmap ( int id ) const

Use QPixmap(icon()) on the relevant QAction instead.

### void QMenuBar::removeItem ( int id )

Use removeAction() instead.

### void QMenuBar::removeItemAt ( int index )

Use removeAction() instead.

### Separator QMenuBar::separator () const

This function is provided only to make old code compile.

See also setSeparator().

### void QMenuBar::setAccel ( const QKeySequence & key, int id )

Use setShortcut() on the relevant QAction instead.

See also accel().

### void QMenuBar::setAutoGeometry ( bool b )

Sets whether the menu bar should automatically resize itself when its parent widget is resized.

This feature is provided to help porting to Qt 4. We recommend against using it in new code.

See also autoGeometry().

### void QMenuBar::setItemChecked ( int id, bool check )

Use setChecked() on the relevant QAction instead.

See also isItemChecked().

### void QMenuBar::setItemEnabled ( int id, bool enable )

Use setEnabled() on the relevant QAction instead.

See also isItemEnabled().

### bool QMenuBar::setItemParameter ( int id, int param )

Use QAction::setData() instead.

See also itemParameter().

### void QMenuBar::setItemVisible ( int id, bool visible )

Use setVisible() on the relevant QAction instead.

See also isItemVisible().

### void QMenuBar::setMargin ( int margin )

Sets the width of the margin around the contents of the widget to margin.

Use QWidget::setContentsMargins() instead.

See also margin() and QWidget::setContentsMargins().

### void QMenuBar::setSeparator ( Separator sep )

This function is provided only to make old code compile.

See also separator().

### void QMenuBar::setWhatsThis ( int id, const QString & w )

Use setWhatsThis() on the relevant QAction instead.

See also whatsThis().

### QString QMenuBar::text ( int id ) const

Use text() on the relevant QAction instead.

### QString QMenuBar::whatsThis ( int id ) const

Use whatsThis() on the relevant QAction instead.

See also setWhatsThis().