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 )

This is an overloaded member function, provided for convenience.

Use setText() on the relevant QAction instead.

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

This is an overloaded member function, provided for convenience.

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 )

This is an overloaded member function, provided for convenience.

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 )

This is an overloaded member function, provided for convenience.

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

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

This is an overloaded member function, provided for convenience.

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

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

This is an overloaded member function, provided for convenience.

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 )

This is an overloaded member function, provided for convenience.

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 )

This is an overloaded member function, provided for convenience.

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

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

This is an overloaded member function, provided for convenience.

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 )

This is an overloaded member function, provided for convenience.

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

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

This is an overloaded member function, provided for convenience.

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 with of the 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().