Qt logo

QMenuBar Class Reference


The QMenuBar class provides a horizontal menu bar. More...

#include <qmenubar.h>

Inherits QFrame and QMenuData.

List of all member functions.

Public Members

Signals

Protected Members


Detailed Description

The QMenuBar class provides a horizontal menu bar.

It automatically sets its own geometry to the top of the parent widget and changes appropriately it when the parent widget is resized.

menu/menu.cpp is a typical example of QMenuBar and QPopupMenu use.

See also: QPopupMenu and GUI Design Handbook: Menu Bar

Examples: grapher/grapher.cpp layout/layout.cpp menu/menu.cpp progress/progress.cpp scrollview/scrollview.cpp


Member Type Documentation

QMenuBar::Separator

This enum type is used to decide whether QMenuBar should draw a separator line at its bottom. The possible values are:

Member Function Documentation

QMenuBar::QMenuBar(QWidget*parent=0, constchar*name=0)

Creates a menu bar with a parent and a name.

QMenuBar::~QMenuBar()

Destroys the menu bar.

voidQMenuBar::activated(intid) [signal]

This signal is emitted when a menu item is selected; id is the id of the selected item.

Normally, you will connect each menu item to a single slot using QMenuData::insertItem(), but sometimes you will want to connect several items to a single slot (most often if the user selects from an array). This signal is handy in such cases.

See also: highlighted() and QMenuData::insertItem().

boolQMenuBar::customWhatsThis()const [virtual]

Reimplemented for internal reasons; the API is not affected.

Reimplemented from QWidget.

voidQMenuBar::drawContents(QPainter*p) [virtualprotected]

Called from QFrame::paintEvent().

Reimplemented from QFrame.

boolQMenuBar::eventFilter(QObject*object, QEvent*event) [virtual]

This function is used to adjust the menu bar's geometry to the parent widget's. Note that this is not part of the public interface - the function is public only because QObject::eventFilter() is.

Reimplemented from QObject.

voidQMenuBar::focusOutEvent(QFocusEvent*) [virtualprotected]

Reimplemented for internal reasons; the API is not affected.

Reimplemented from QWidget.

voidQMenuBar::fontChange(constQFont&f) [virtualprotected]

For internal use only.

Reimplemented from QWidget.

intQMenuBar::heightForWidth(intmax_width)const [virtual]

Returns the height that the menu would resize itself to if its parent (and hence itself) resized to the given width. This can be useful for simple layout tasks where the height of the menubar is needed after items have been inserted. See examples/showimg/showimg.cpp for an example of the usage.

Reimplemented from QWidget.

voidQMenuBar::hide() [virtual]

Reimplements QWidget::hide() in order to deselect any selected item.

Examples: grapher/grapher.cpp

Reimplemented from QWidget.

voidQMenuBar::highlighted(intid) [signal]

This signal is emitted when a menu item is highlighted; id is the id of the highlighted item.

Normally, you will connect each menu item to a single slot using QMenuData::insertItem(), but sometimes you will want to connect several items to a single slot (most often if the user selects from an array). This signal is handy in such cases.

See also: activated() and QMenuData::insertItem().

voidQMenuBar::keyPressEvent(QKeyEvent*e) [virtualprotected]

Handles key press events for the menu bar.

Reimplemented from QWidget.

voidQMenuBar::leaveEvent(QEvent*e) [virtualprotected]

Handles leave events for the menu bar.

Reimplemented from QWidget.

voidQMenuBar::menuContentsChanged() [virtualprotected]

Recomputes the menu bar's display data according to the new contents.

You should never need to call this, it is called automatically by QMenuData whenever it needs to be called.

Reimplemented from QMenuData.

voidQMenuBar::menuStateChanged() [virtualprotected]

Recomputes the menu bar's display data according to the new state.

You should never need to call this, it is called automatically by QMenuData whenever it needs to be called.

Reimplemented from QMenuData.

voidQMenuBar::mouseMoveEvent(QMouseEvent*e) [virtualprotected]

Handles mouse move events for the menu bar.

Reimplemented from QWidget.

voidQMenuBar::mousePressEvent(QMouseEvent*e) [virtualprotected]

Handles mouse press events for the menu bar.

Reimplemented from QWidget.

voidQMenuBar::mouseReleaseEvent(QMouseEvent*e) [virtualprotected]

Handles mouse release events for the menu bar.

Reimplemented from QWidget.

voidQMenuBar::resizeEvent(QResizeEvent*) [virtualprotected]

Handles resize events for the menu bar.

Reimplemented from QWidget.

QMenuBar::SeparatorQMenuBar::separator()const

Returns the currently set Separator usage.

See also: Separator and setSeparator().

voidQMenuBar::setSeparator(Separatorwhen) [virtual]

When a menubar is used above an unframed widget, it may look better with a separating line when displayed with WindowsStyle.

This function sets the usage of such a separator to appear either QMenuBar::Never, or QMenuBar::InWindowsStyle.

The default is QMenuBar::Never.

See also: Separator and separator().

Examples: layout/layout.cpp scrollview/scrollview.cpp

voidQMenuBar::show() [virtual]

Reimplements QWidget::show() in order to set up the correct keyboard accelerators and raise itself to the top of the widget stack.

Examples: grapher/grapher.cpp

Reimplemented from QWidget.

voidQMenuBar::styleChange(QStyle&old) [virtualprotected]

Reimplemented for internal reasons; the API is not affected.

Reimplemented from QWidget.

voidQMenuBar::updateItem(int) [virtual]

For internal use only.

Reimplemented from QMenuData.


Search the documentation, FAQ, qt-interest archive and more (uses www.troll.no):


This file is part of the Qt toolkit, copyright © 1995-99 Troll Tech, all rights reserved.


Copyright 1999 Troll TechTrademarks
Qt version 2.0.2