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().