Qt 4.8
|
The QMainWindow class provides a main application window. More...
#include <qmainwindow.h>
Public Types | |
enum | DockOption { AnimatedDocks = 0x01, AllowNestedDocks = 0x02, AllowTabbedDocks = 0x04, ForceTabbedDocks = 0x08, VerticalTabs = 0x10 } |
This enum contains flags that specify the docking behavior of QMainWindow. More... | |
Public Types inherited from QWidget | |
enum | RenderFlag { DrawWindowBackground = 0x1, DrawChildren = 0x2, IgnoreMask = 0x4 } |
This enum describes how to render the widget when calling QWidget::render(). More... | |
Public Types inherited from QPaintDevice | |
enum | PaintDeviceMetric { PdmWidth = 1, PdmHeight, PdmWidthMM, PdmHeightMM, PdmNumColors, PdmDepth, PdmDpiX, PdmDpiY, PdmPhysicalDpiX, PdmPhysicalDpiY } |
Public Slots | |
void | setAnimated (bool enabled) |
void | setDockNestingEnabled (bool enabled) |
Public Slots inherited from QWidget | |
bool | close () |
Closes this widget. More... | |
void | hide () |
Hides the widget. More... | |
void | lower () |
Lowers the widget to the bottom of the parent widget's stack. More... | |
void | raise () |
Raises this widget to the top of the parent widget's stack. More... | |
void | repaint () |
Repaints the widget directly by calling paintEvent() immediately, unless updates are disabled or the widget is hidden. More... | |
void | setDisabled (bool) |
Disables widget input events if disable is true; otherwise enables input events. More... | |
void | setEnabled (bool) |
void | setFocus () |
Gives the keyboard input focus to this widget (or its focus proxy) if this widget or one of its parents is the active window. More... | |
void | setHidden (bool hidden) |
Convenience function, equivalent to setVisible(!hidden). More... | |
QT_MOC_COMPAT void | setShown (bool shown) |
Use setVisible(shown) instead. More... | |
void | setStyleSheet (const QString &styleSheet) |
virtual void | setVisible (bool visible) |
void | setWindowModified (bool) |
void | setWindowTitle (const QString &) |
void | show () |
Shows the widget and its child widgets. More... | |
void | showFullScreen () |
Shows the widget in full-screen mode. More... | |
void | showMaximized () |
Shows the widget maximized. More... | |
void | showMinimized () |
Shows the widget minimized, as an icon. More... | |
void | showNormal () |
Restores the widget after it has been maximized or minimized. More... | |
void | update () |
Updates the widget unless updates are disabled or the widget is hidden. More... | |
Public Slots inherited from QObject | |
void | deleteLater () |
Schedules this object for deletion. More... | |
Signals | |
void | iconSizeChanged (const QSize &iconSize) |
This signal is emitted when the size of the icons used in the window is changed. More... | |
void | toolButtonStyleChanged (Qt::ToolButtonStyle toolButtonStyle) |
This signal is emitted when the style used for tool buttons in the window is changed. More... | |
Signals inherited from QWidget | |
void | customContextMenuRequested (const QPoint &pos) |
This signal is emitted when the widget's contextMenuPolicy is Qt::CustomContextMenu, and the user has requested a context menu on the widget. More... | |
Signals inherited from QObject | |
void | destroyed (QObject *=0) |
This signal is emitted immediately before the object obj is destroyed, and can not be blocked. More... | |
Public Functions | |
void | addDockWidget (Qt::DockWidgetArea area, QDockWidget *dockwidget) |
Adds the given dockwidget to the specified area. More... | |
void | addDockWidget (Qt::DockWidgetArea area, QDockWidget *dockwidget, Qt::Orientation orientation) |
Adds dockwidget into the given area in the direction specified by the orientation. More... | |
void | addToolBar (Qt::ToolBarArea area, QToolBar *toolbar) |
Adds the toolbar into the specified area in this main window. More... | |
void | addToolBar (QToolBar *toolbar) |
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. Equivalent of calling addToolBar(Qt::TopToolBarArea, toolbar) More... | |
QToolBar * | addToolBar (const QString &title) |
Creates a QToolBar object, setting its window title to title, and inserts it into the top toolbar area. More... | |
void | addToolBarBreak (Qt::ToolBarArea area=Qt::TopToolBarArea) |
Adds a toolbar break to the given area after all the other objects that are present. More... | |
QWidget * | centralWidget () const |
Returns the central widget for the main window. More... | |
Qt::DockWidgetArea | corner (Qt::Corner corner) const |
Returns the dock widget area that occupies the specified corner. More... | |
virtual QMenu * | createPopupMenu () |
Returns a popup menu containing checkable entries for the toolbars and dock widgets present in the main window. More... | |
DockOptions | dockOptions () const |
Qt::DockWidgetArea | dockWidgetArea (QDockWidget *dockwidget) const |
Returns the Qt::DockWidgetArea for dockwidget. More... | |
bool | documentMode () const |
QSize | iconSize () const |
void | insertToolBar (QToolBar *before, QToolBar *toolbar) |
Inserts the toolbar into the area occupied by the before toolbar so that it appears before it. More... | |
void | insertToolBarBreak (QToolBar *before) |
Inserts a toolbar break before the toolbar specified by before. More... | |
bool | isAnimated () const |
bool | isDockNestingEnabled () const |
bool | isSeparator (const QPoint &pos) const |
QMenuBar * | menuBar () const |
Returns the menu bar for the main window. More... | |
QWidget * | menuWidget () const |
Returns the menu bar for the main window. More... | |
QMainWindow (QWidget *parent=0, Qt::WindowFlags flags=0) | |
Constructs a QMainWindow with the given parent and the specified widget flags. More... | |
void | removeDockWidget (QDockWidget *dockwidget) |
Removes the dockwidget from the main window layout and hides it. More... | |
void | removeToolBar (QToolBar *toolbar) |
Removes the toolbar from the main window layout and hides it. More... | |
void | removeToolBarBreak (QToolBar *before) |
Removes a toolbar break previously inserted before the toolbar specified by before. More... | |
bool | restoreDockWidget (QDockWidget *dockwidget) |
Restores the state of dockwidget if it is created after the call to restoreState(). More... | |
bool | restoreState (const QByteArray &state, int version=0) |
Restores the state of this mainwindow's toolbars and dockwidgets. More... | |
QByteArray | saveState (int version=0) const |
Saves the current state of this mainwindow's toolbars and dockwidgets. More... | |
void | setCentralWidget (QWidget *widget) |
Sets the given widget to be the main window's central widget. More... | |
void | setCorner (Qt::Corner corner, Qt::DockWidgetArea area) |
Sets the given dock widget area to occupy the specified corner. More... | |
void | setDockOptions (DockOptions options) |
void | setDocumentMode (bool enabled) |
void | setIconSize (const QSize &iconSize) |
void | setMenuBar (QMenuBar *menubar) |
Sets the menu bar for the main window to menuBar. More... | |
void | setMenuWidget (QWidget *menubar) |
Sets the menu bar for the main window to menuBar. More... | |
void | setStatusBar (QStatusBar *statusbar) |
Sets the status bar for the main window to statusbar. More... | |
void | setTabPosition (Qt::DockWidgetAreas areas, QTabWidget::TabPosition tabPosition) |
Sets the tab position for the given dock widget areas to the specified tabPosition. More... | |
void | setTabShape (QTabWidget::TabShape tabShape) |
void | setToolButtonStyle (Qt::ToolButtonStyle toolButtonStyle) |
void | setUnifiedTitleAndToolBarOnMac (bool set) |
void | splitDockWidget (QDockWidget *after, QDockWidget *dockwidget, Qt::Orientation orientation) |
Splits the space covered by the first dock widget into two parts, moves the first dock widget into the first part, and moves the second dock widget into the second part. More... | |
QStatusBar * | statusBar () const |
Returns the status bar for the main window. More... | |
QList< QDockWidget * > | tabifiedDockWidgets (QDockWidget *dockwidget) const |
Returns the dock widgets that are tabified together with dockwidget. More... | |
void | tabifyDockWidget (QDockWidget *first, QDockWidget *second) |
Moves second dock widget on top of first dock widget, creating a tabbed docked area in the main window. More... | |
QTabWidget::TabPosition | tabPosition (Qt::DockWidgetArea area) const |
Returns the tab position for area. More... | |
QTabWidget::TabShape | tabShape () const |
Qt::ToolBarArea | toolBarArea (QToolBar *toolbar) const |
Returns the Qt::ToolBarArea for toolbar. More... | |
bool | toolBarBreak (QToolBar *toolbar) const |
Returns whether there is a toolbar break before the toolbar. More... | |
Qt::ToolButtonStyle | toolButtonStyle () const |
bool | unifiedTitleAndToolBarOnMac () const |
~QMainWindow () | |
Destroys the main window. More... | |
Public Functions inherited from QWidget | |
bool | acceptDrops () const |
QString | accessibleDescription () const |
QString | accessibleName () const |
QList< QAction * > | actions () const |
Returns the (possibly empty) list of this widget's actions. More... | |
void | activateWindow () |
Sets the top-level widget containing this widget to be the active window. More... | |
void | addAction (QAction *action) |
Appends the action action to this widget's list of actions. More... | |
void | addActions (QList< QAction *> actions) |
Appends the actions actions to this widget's list of actions. More... | |
void | adjustSize () |
Adjusts the size of the widget to fit its contents. More... | |
bool | autoFillBackground () const |
QPalette::ColorRole | backgroundRole () const |
Returns the background role of the widget. More... | |
QSize | baseSize () const |
QWidget * | childAt (int x, int y) const |
Returns the visible child widget at the position ({x}, {y}) in the widget's coordinate system. More... | |
QWidget * | childAt (const QPoint &p) const |
Returns the visible child widget at point p in the widget's own coordinate system. More... | |
QRect | childrenRect () const |
QRegion | childrenRegion () const |
void | clearFocus () |
Takes keyboard input focus from the widget. More... | |
void | clearMask () |
Removes any mask set by setMask(). More... | |
QMargins | contentsMargins () const |
The contentsMargins function returns the widget's contents margins. More... | |
QRect | contentsRect () const |
Returns the area inside the widget's margins. More... | |
Qt::ContextMenuPolicy | contextMenuPolicy () const |
void | createWinId () |
QCursor | cursor () const |
int | devType () const |
WId | effectiveWinId () const |
Returns the effective window system identifier of the widget, i. More... | |
void | ensurePolished () const |
Ensures that the widget has been polished by QStyle (i.e., has a proper font and palette). More... | |
Qt::FocusPolicy | focusPolicy () const |
QWidget * | focusProxy () const |
Returns the focus proxy, or 0 if there is no focus proxy. More... | |
QWidget * | focusWidget () const |
Returns the last child of this widget that setFocus had been called on. More... | |
const QFont & | font () const |
QFontInfo | fontInfo () const |
Returns the font info for the widget's current font. More... | |
QFontMetrics | fontMetrics () const |
Returns the font metrics for the widget's current font. More... | |
QPalette::ColorRole | foregroundRole () const |
Returns the foreground role. More... | |
QRect | frameGeometry () const |
QSize | frameSize () const |
const QRect & | geometry () const |
void | getContentsMargins (int *left, int *top, int *right, int *bottom) const |
Returns the widget's contents margins for left, top, right, and bottom. More... | |
HDC | getDC () const |
Returns the window system handle of the widget, for low-level access. More... | |
void | grabGesture (Qt::GestureType type, Qt::GestureFlags flags=Qt::GestureFlags()) |
Subscribes the widget to a given gesture with specific flags. More... | |
void | grabKeyboard () |
Grabs the keyboard input. More... | |
void | grabMouse () |
Grabs the mouse input. More... | |
void | grabMouse (const QCursor &) |
int | grabShortcut (const QKeySequence &key, Qt::ShortcutContext context=Qt::WindowShortcut) |
Adds a shortcut to Qt's shortcut system that watches for the given key sequence in the given context. More... | |
QGraphicsEffect * | graphicsEffect () const |
The graphicsEffect function returns a pointer to the widget's graphics effect. More... | |
QGraphicsProxyWidget * | graphicsProxyWidget () const |
Returns the proxy widget for the corresponding embedded widget in a graphics view; otherwise returns 0. More... | |
bool | hasFocus () const |
bool | hasMouseTracking () const |
int | height () const |
virtual int | heightForWidth (int) const |
Returns the preferred height for this widget, given the width w. More... | |
QInputContext * | inputContext () |
This function returns the QInputContext for this widget. More... | |
Qt::InputMethodHints | inputMethodHints () const |
virtual QVariant | inputMethodQuery (Qt::InputMethodQuery) const |
This method is only relevant for input widgets. More... | |
void | insertAction (QAction *before, QAction *action) |
Inserts the action action to this widget's list of actions, before the action before. More... | |
void | insertActions (QAction *before, QList< QAction *> actions) |
Inserts the actions actions to this widget's list of actions, before the action before. More... | |
WId | internalWinId () const |
Returns the window system identifier of the widget, or 0 if the widget is not created yet. More... | |
bool | isActiveWindow () const |
bool | isAncestorOf (const QWidget *child) const |
Returns true if this widget is a parent, (or grandparent and so on to any level), of the given child, and both widgets are within the same window; otherwise returns false. More... | |
bool | isEnabled () const |
bool | isEnabledTo (QWidget *) const |
Returns true if this widget would become enabled if ancestor is enabled; otherwise returns false. More... | |
bool | isEnabledToTLW () const |
This function is deprecated. More... | |
bool | isFullScreen () const |
bool | isHidden () const |
Returns true if the widget is hidden, otherwise returns false. More... | |
bool | isLeftToRight () const |
bool | isMaximized () const |
bool | isMinimized () const |
bool | isModal () const |
bool | isRightToLeft () const |
bool | isTopLevel () const |
Use isWindow() instead. More... | |
bool | isVisible () const |
bool | isVisibleTo (QWidget *) const |
Returns true if this widget would become visible if ancestor is shown; otherwise returns false. More... | |
bool | isWindow () const |
Returns true if the widget is an independent window, otherwise returns false. More... | |
bool | isWindowModified () const |
QLayout * | layout () const |
Returns the layout manager that is installed on this widget, or 0 if no layout manager is installed. More... | |
Qt::LayoutDirection | layoutDirection () const |
QLocale | locale () const |
Qt::HANDLE | macCGHandle () const |
Returns the CoreGraphics handle of the widget. More... | |
Qt::HANDLE | macQDHandle () const |
Returns the QuickDraw handle of the widget. More... | |
QPoint | mapFrom (QWidget *, const QPoint &) const |
Translates the widget coordinate pos from the coordinate system of parent to this widget's coordinate system. More... | |
QPoint | mapFromGlobal (const QPoint &) const |
Translates the global screen coordinate pos to widget coordinates. More... | |
QPoint | mapFromParent (const QPoint &) const |
Translates the parent widget coordinate pos to widget coordinates. More... | |
QPoint | mapTo (QWidget *, const QPoint &) const |
Translates the widget coordinate pos to the coordinate system of parent. More... | |
QPoint | mapToGlobal (const QPoint &) const |
Translates the widget coordinate pos to global screen coordinates. More... | |
QPoint | mapToParent (const QPoint &) const |
Translates the widget coordinate pos to a coordinate in the parent widget. More... | |
QRegion | mask () const |
Returns the mask currently set on a widget. More... | |
int | maximumHeight () const |
QSize | maximumSize () const |
int | maximumWidth () const |
int | minimumHeight () const |
QSize | minimumSize () const |
virtual QSize | minimumSizeHint () const |
int | minimumWidth () const |
void | move (int x, int y) |
This corresponds to move(QPoint(x, y)). More... | |
void | move (const QPoint &) |
QWidget * | nativeParentWidget () const |
Returns the native parent for this widget, i. More... | |
QWidget * | nextInFocusChain () const |
Returns the next widget in this widget's focus chain. More... | |
QRect | normalGeometry () const |
void | overrideWindowFlags (Qt::WindowFlags type) |
Sets the window flags for the widget to flags, without telling the window system. More... | |
void | overrideWindowState (Qt::WindowStates state) |
QPaintEngine * | paintEngine () const |
Returns the widget's paint engine. More... | |
const QPalette & | palette () const |
QWidget * | parentWidget () const |
Returns the parent of this widget, or 0 if it does not have any parent widget. More... | |
QPoint | pos () const |
QWidget * | previousInFocusChain () const |
The previousInFocusChain function returns the previous widget in this widget's focus chain. More... | |
QWidget (QWidget *parent=0, Qt::WindowFlags f=0) | |
Constructs a widget which is a child of parent, with widget flags set to f. More... | |
QRect | rect () const |
void | releaseDC (HDC) const |
Releases the HDC hdc acquired by a previous call to getDC(). More... | |
void | releaseKeyboard () |
Releases the keyboard grab. More... | |
void | releaseMouse () |
Releases the mouse grab. More... | |
void | releaseShortcut (int id) |
Removes the shortcut with the given id from Qt's shortcut system. More... | |
void | removeAction (QAction *action) |
Removes the action action from this widget's list of actions. More... | |
void | render (QPaintDevice *target, const QPoint &targetOffset=QPoint(), const QRegion &sourceRegion=QRegion(), RenderFlags renderFlags=RenderFlags(DrawWindowBackground|DrawChildren)) |
Renders the sourceRegion of this widget into the target using renderFlags to determine how to render. More... | |
void | render (QPainter *painter, const QPoint &targetOffset=QPoint(), const QRegion &sourceRegion=QRegion(), RenderFlags renderFlags=RenderFlags(DrawWindowBackground|DrawChildren)) |
Renders the widget into the painter's QPainter::device(). More... | |
void | repaint (int x, int y, int w, int h) |
This version repaints a rectangle (x, y, w, h) inside the widget. More... | |
void | repaint (const QRect &) |
This version repaints a rectangle rect inside the widget. More... | |
void | repaint (const QRegion &) |
This version repaints a region rgn inside the widget. More... | |
void | resize (int w, int h) |
This corresponds to resize(QSize(w, h)). More... | |
void | resize (const QSize &) |
bool | restoreGeometry (const QByteArray &geometry) |
Restores the geometry and state top-level widgets stored in the byte array geometry. More... | |
QByteArray | saveGeometry () const |
Saves the current geometry and state for top-level widgets. More... | |
void | scroll (int dx, int dy) |
Scrolls the widget including its children dx pixels to the right and dy downward. More... | |
void | scroll (int dx, int dy, const QRect &) |
This version only scrolls r and does not move the children of the widget. More... | |
void | setAcceptDrops (bool on) |
void | setAccessibleDescription (const QString &description) |
void | setAccessibleName (const QString &name) |
void | setAttribute (Qt::WidgetAttribute, bool on=true) |
Sets the attribute attribute on this widget if on is true; otherwise clears the attribute. More... | |
void | setAutoFillBackground (bool enabled) |
void | setBackgroundRole (QPalette::ColorRole) |
Sets the background role of the widget to role. More... | |
void | setBaseSize (const QSize &) |
void | setBaseSize (int basew, int baseh) |
This corresponds to setBaseSize(QSize(basew, baseh)). More... | |
void | setContentsMargins (int left, int top, int right, int bottom) |
Sets the margins around the contents of the widget to have the sizes left, top, right, and bottom. More... | |
void | setContentsMargins (const QMargins &margins) |
The setContentsMargins function sets the margins around the widget's contents. More... | |
void | setContextMenuPolicy (Qt::ContextMenuPolicy policy) |
void | setCursor (const QCursor &) |
void | setFixedHeight (int h) |
Sets both the minimum and maximum heights of the widget to h without changing the widths. More... | |
void | setFixedSize (const QSize &) |
Sets both the minimum and maximum sizes of the widget to s, thereby preventing it from ever growing or shrinking. More... | |
void | setFixedSize (int w, int h) |
Sets the width of the widget to w and the height to h. More... | |
void | setFixedWidth (int w) |
Sets both the minimum and maximum width of the widget to w without changing the heights. More... | |
void | setFocus (Qt::FocusReason reason) |
Gives the keyboard input focus to this widget (or its focus proxy) if this widget or one of its parents is the active window. More... | |
void | setFocusPolicy (Qt::FocusPolicy policy) |
void | setFocusProxy (QWidget *) |
Sets the widget's focus proxy to widget w. More... | |
void | setFont (const QFont &) |
Use the single-argument overload instead. More... | |
void | setForegroundRole (QPalette::ColorRole) |
Sets the foreground role of the widget to role. More... | |
void | setGeometry (int x, int y, int w, int h) |
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.This corresponds to setGeometry(QRect(x, y, w, h)). More... | |
void | setGeometry (const QRect &) |
void | setGraphicsEffect (QGraphicsEffect *effect) |
The setGraphicsEffect function is for setting the widget's graphics effect. More... | |
void | setInputContext (QInputContext *) |
This function sets the input context context on this widget. More... | |
void | setInputMethodHints (Qt::InputMethodHints hints) |
void | setLayout (QLayout *) |
Sets the layout manager for this widget to layout. More... | |
void | setLayoutDirection (Qt::LayoutDirection direction) |
void | setLocale (const QLocale &locale) |
void | setMask (const QBitmap &) |
Causes only the pixels of the widget for which bitmap has a corresponding 1 bit to be visible. More... | |
void | setMask (const QRegion &) |
Causes only the parts of the widget which overlap region to be visible. More... | |
void | setMaximumHeight (int maxh) |
void | setMaximumSize (const QSize &) |
void | setMaximumSize (int maxw, int maxh) |
This function corresponds to setMaximumSize(QSize(maxw, maxh)). More... | |
void | setMaximumWidth (int maxw) |
void | setMinimumHeight (int minh) |
void | setMinimumSize (const QSize &) |
void | setMinimumSize (int minw, int minh) |
This function corresponds to setMinimumSize(QSize(minw, minh)). More... | |
void | setMinimumWidth (int minw) |
void | setMouseTracking (bool enable) |
void | setPalette (const QPalette &) |
Use the single-argument overload instead. More... | |
void | setParent (QWidget *parent) |
Sets the parent of the widget to parent, and resets the window flags. More... | |
void | setParent (QWidget *parent, Qt::WindowFlags f) |
This function also takes widget flags, f as an argument. More... | |
void | setShortcutAutoRepeat (int id, bool enable=true) |
If enable is true, auto repeat of the shortcut with the given id is enabled; otherwise it is disabled. More... | |
void | setShortcutEnabled (int id, bool enable=true) |
If enable is true, the shortcut with the given id is enabled; otherwise the shortcut is disabled. More... | |
void | setSizeIncrement (const QSize &) |
void | setSizeIncrement (int w, int h) |
Sets the x (width) size increment to w and the y (height) size increment to h. More... | |
void | setSizePolicy (QSizePolicy) |
void | setSizePolicy (QSizePolicy::Policy horizontal, QSizePolicy::Policy vertical) |
Sets the size policy of the widget to horizontal and vertical, with standard stretch and no height-for-width. More... | |
void | setStatusTip (const QString &) |
void | setStyle (QStyle *) |
Sets the widget's GUI style to style. More... | |
void | setToolTip (const QString &) |
void | setUpdatesEnabled (bool enable) |
void | setupUi (QWidget *widget) |
Sets up the user interface for the specified widget. More... | |
void | setWhatsThis (const QString &) |
void | setWindowFilePath (const QString &filePath) |
void | setWindowFlags (Qt::WindowFlags type) |
void | setWindowIcon (const QIcon &icon) |
void | setWindowIconText (const QString &) |
void | setWindowModality (Qt::WindowModality windowModality) |
void | setWindowOpacity (qreal level) |
void | setWindowRole (const QString &) |
Sets the window's role to role. More... | |
void | setWindowState (Qt::WindowStates state) |
Sets the window state to windowState. More... | |
void | setWindowSurface (QWindowSurface *surface) |
Sets the window surface to be the surface specified. More... | |
QSize | size () const |
virtual QSize | sizeHint () const |
QSize | sizeIncrement () const |
QSizePolicy | sizePolicy () const |
void | stackUnder (QWidget *) |
Places the widget under w in the parent widget's stack. More... | |
QString | statusTip () const |
QStyle * | style () const |
QString | styleSheet () const |
bool | testAttribute (Qt::WidgetAttribute) const |
Returns true if attribute attribute is set on this widget; otherwise returns false. More... | |
QString | toolTip () const |
QWidget * | topLevelWidget () const |
bool | underMouse () const |
Returns true if the widget is under the mouse cursor; otherwise returns false. More... | |
void | ungrabGesture (Qt::GestureType type) |
Unsubscribes the widget from a given gesture type. More... | |
void | unsetCursor () |
void | unsetLayoutDirection () |
void | unsetLocale () |
void | update (int x, int y, int w, int h) |
This version updates a rectangle (x, y, w, h) inside the widget. More... | |
void | update (const QRect &) |
This version updates a rectangle rect inside the widget. More... | |
void | update (const QRegion &) |
This version repaints a region rgn inside the widget. More... | |
void | updateGeometry () |
Notifies the layout system that this widget has changed and may need to change geometry. More... | |
bool | updatesEnabled () const |
QRegion | visibleRegion () const |
Returns the unobscured region where paint events can occur. More... | |
QString | whatsThis () const |
int | width () const |
QWidget * | window () const |
Returns the window for this widget, i.e. More... | |
QString | windowFilePath () const |
Qt::WindowFlags | windowFlags () const |
Window flags are a combination of a type (e. More... | |
QIcon | windowIcon () const |
QString | windowIconText () const |
Qt::WindowModality | windowModality () const |
qreal | windowOpacity () const |
QString | windowRole () const |
Returns the window's role, or an empty string. More... | |
Qt::WindowStates | windowState () const |
Returns the current window state. More... | |
QWindowSurface * | windowSurface () const |
Returns the QWindowSurface this widget will be drawn into. More... | |
QString | windowTitle () const |
Qt::WindowType | windowType () const |
Returns the window type of this widget. More... | |
WId | winId () const |
Returns the window system identifier of the widget. More... | |
int | x () const |
const QX11Info & | x11Info () const |
Returns information about the configuration of the X display used to display the widget. More... | |
Qt::HANDLE | x11PictureHandle () const |
Returns the X11 Picture handle of the widget for XRender support. More... | |
int | y () const |
~QWidget () | |
Destroys the widget. More... | |
Public Functions inherited from QObject | |
bool | blockSignals (bool b) |
If block is true, signals emitted by this object are blocked (i.e., emitting a signal will not invoke anything connected to it). More... | |
const QObjectList & | children () const |
Returns a list of child objects. More... | |
bool | connect (const QObject *sender, const char *signal, const char *member, Qt::ConnectionType type=Qt::AutoConnection) const |
bool | disconnect (const char *signal=0, const QObject *receiver=0, const char *member=0) |
bool | disconnect (const QObject *receiver, const char *member=0) |
void | dumpObjectInfo () |
Dumps information about signal connections, etc. More... | |
void | dumpObjectTree () |
Dumps a tree of children to the debug output. More... | |
QList< QByteArray > | dynamicPropertyNames () const |
Returns the names of all properties that were dynamically added to the object using setProperty(). More... | |
virtual bool | eventFilter (QObject *, QEvent *) |
Filters events if this object has been installed as an event filter for the watched object. More... | |
template<typename T > | |
T | findChild (const QString &aName=QString()) const |
Returns the child of this object that can be cast into type T and that is called name, or 0 if there is no such object. More... | |
template<typename T > | |
QList< T > | findChildren (const QString &aName=QString()) const |
Returns all children of this object with the given name that can be cast to type T, or an empty list if there are no such objects. More... | |
template<typename T > | |
QList< T > | findChildren (const QRegExp &re) const |
bool | inherits (const char *classname) const |
Returns true if this object is an instance of a class that inherits className or a QObject subclass that inherits className; otherwise returns false. More... | |
void | installEventFilter (QObject *) |
Installs an event filter filterObj on this object. More... | |
bool | isWidgetType () const |
Returns true if the object is a widget; otherwise returns false. More... | |
void | killTimer (int id) |
Kills the timer with timer identifier, id. More... | |
virtual const QMetaObject * | metaObject () const |
Returns a pointer to the meta-object of this object. More... | |
void | moveToThread (QThread *thread) |
Changes the thread affinity for this object and its children. More... | |
QString | objectName () const |
QObject * | parent () const |
Returns a pointer to the parent object. More... | |
QVariant | property (const char *name) const |
Returns the value of the object's name property. More... | |
Q_INVOKABLE | QObject (QObject *parent=0) |
Constructs an object with parent object parent. More... | |
void | removeEventFilter (QObject *) |
Removes an event filter object obj from this object. More... | |
void | setObjectName (const QString &name) |
void | setParent (QObject *) |
Makes the object a child of parent. More... | |
bool | setProperty (const char *name, const QVariant &value) |
Sets the value of the object's name property to value. More... | |
void | setUserData (uint id, QObjectUserData *data) |
bool | signalsBlocked () const |
Returns true if signals are blocked; otherwise returns false. More... | |
int | startTimer (int interval) |
Starts a timer and returns a timer identifier, or returns zero if it could not start a timer. More... | |
QThread * | thread () const |
Returns the thread in which the object lives. More... | |
QObjectUserData * | userData (uint id) const |
virtual | ~QObject () |
Destroys the object, deleting all its child objects. More... | |
Public Functions inherited from QPaintDevice | |
int | colorCount () const |
int | depth () const |
int | height () const |
int | heightMM () const |
int | logicalDpiX () const |
int | logicalDpiY () const |
QT_DEPRECATED int | numColors () const |
bool | paintingActive () const |
int | physicalDpiX () const |
int | physicalDpiY () const |
int | width () const |
int | widthMM () const |
virtual | ~QPaintDevice () |
Protected Functions | |
void | contextMenuEvent (QContextMenuEvent *event) |
Reimplemented Function More... | |
bool | event (QEvent *event) |
Reimplemented Function More... | |
Protected Functions inherited from QWidget | |
virtual void | actionEvent (QActionEvent *) |
This event handler is called with the given event whenever the widget's actions are changed. More... | |
virtual void | changeEvent (QEvent *) |
This event handler can be reimplemented to handle state changes. More... | |
virtual void | closeEvent (QCloseEvent *) |
This event handler is called with the given event when Qt receives a window close request for a top-level widget from the window system. More... | |
void | create (WId=0, bool initializeWindow=true, bool destroyOldWindow=true) |
Creates a new widget window if window is 0, otherwise sets the widget's window to window. More... | |
void | destroy (bool destroyWindow=true, bool destroySubWindows=true) |
Frees up window system resources. More... | |
virtual void | dragEnterEvent (QDragEnterEvent *) |
This event handler is called when a drag is in progress and the mouse enters this widget. More... | |
virtual void | dragLeaveEvent (QDragLeaveEvent *) |
This event handler is called when a drag is in progress and the mouse leaves this widget. More... | |
virtual void | dragMoveEvent (QDragMoveEvent *) |
This event handler is called if a drag is in progress, and when any of the following conditions occur: the cursor enters this widget, the cursor moves within this widget, or a modifier key is pressed on the keyboard while this widget has the focus. More... | |
virtual void | dropEvent (QDropEvent *) |
This event handler is called when the drag is dropped on this widget. More... | |
virtual void | enabledChange (bool) |
virtual void | enterEvent (QEvent *) |
This event handler can be reimplemented in a subclass to receive widget enter events which are passed in the event parameter. More... | |
virtual void | focusInEvent (QFocusEvent *) |
This event handler can be reimplemented in a subclass to receive keyboard focus events (focus received) for the widget. More... | |
bool | focusNextChild () |
Finds a new widget to give the keyboard focus to, as appropriate for Tab, and returns true if it can find a new widget, or false if it can't. More... | |
virtual bool | focusNextPrevChild (bool next) |
Finds a new widget to give the keyboard focus to, as appropriate for Tab and Shift+Tab, and returns true if it can find a new widget, or false if it can't. More... | |
virtual void | focusOutEvent (QFocusEvent *) |
This event handler can be reimplemented in a subclass to receive keyboard focus events (focus lost) for the widget. More... | |
bool | focusPreviousChild () |
Finds a new widget to give the keyboard focus to, as appropriate for Shift+Tab, and returns true if it can find a new widget, or false if it can't. More... | |
virtual void | fontChange (const QFont &) |
virtual void | hideEvent (QHideEvent *) |
This event handler can be reimplemented in a subclass to receive widget hide events. More... | |
virtual void | inputMethodEvent (QInputMethodEvent *) |
This event handler, for event event, can be reimplemented in a subclass to receive Input Method composition events. More... | |
virtual void | keyPressEvent (QKeyEvent *) |
This event handler, for event event, can be reimplemented in a subclass to receive key press events for the widget. More... | |
virtual void | keyReleaseEvent (QKeyEvent *) |
This event handler, for event event, can be reimplemented in a subclass to receive key release events for the widget. More... | |
virtual void | languageChange () |
virtual void | leaveEvent (QEvent *) |
This event handler can be reimplemented in a subclass to receive widget leave events which are passed in the event parameter. More... | |
virtual bool | macEvent (EventHandlerCallRef, EventRef) |
This special event handler can be reimplemented in a subclass to receive native Macintosh events. More... | |
int | metric (PaintDeviceMetric) const |
Internal implementation of the virtual QPaintDevice::metric() function. More... | |
virtual void | mouseDoubleClickEvent (QMouseEvent *) |
This event handler, for event event, can be reimplemented in a subclass to receive mouse double click events for the widget. More... | |
virtual void | mouseMoveEvent (QMouseEvent *) |
This event handler, for event event, can be reimplemented in a subclass to receive mouse move events for the widget. More... | |
virtual void | mousePressEvent (QMouseEvent *) |
This event handler, for event event, can be reimplemented in a subclass to receive mouse press events for the widget. More... | |
virtual void | mouseReleaseEvent (QMouseEvent *) |
This event handler, for event event, can be reimplemented in a subclass to receive mouse release events for the widget. More... | |
virtual void | moveEvent (QMoveEvent *) |
This event handler can be reimplemented in a subclass to receive widget move events which are passed in the event parameter. More... | |
virtual void | paintEvent (QPaintEvent *) |
This event handler can be reimplemented in a subclass to receive paint events passed in event. More... | |
virtual void | paletteChange (const QPalette &) |
QWidget (QWidgetPrivate &d, QWidget *parent, Qt::WindowFlags f) | |
virtual bool | qwsEvent (QWSEvent *) |
This special event handler can be reimplemented in a subclass to receive native Qt for Embedded Linux events which are passed in the event parameter. More... | |
void | resetInputContext () |
This function can be called on the widget that currently has focus to reset the input method operating on it. More... | |
virtual void | resizeEvent (QResizeEvent *) |
This event handler can be reimplemented in a subclass to receive widget resize events which are passed in the event parameter. More... | |
virtual void | showEvent (QShowEvent *) |
This event handler can be reimplemented in a subclass to receive widget show events which are passed in the event parameter. More... | |
virtual void | styleChange (QStyle &) |
virtual void | tabletEvent (QTabletEvent *) |
This event handler, for event event, can be reimplemented in a subclass to receive tablet events for the widget. More... | |
virtual void | wheelEvent (QWheelEvent *) |
This event handler, for event event, can be reimplemented in a subclass to receive wheel events for the widget. More... | |
virtual void | windowActivationChange (bool) |
virtual bool | winEvent (MSG *message, long *result) |
This special event handler can be reimplemented in a subclass to receive native Windows events which are passed in the message parameter. More... | |
virtual bool | x11Event (XEvent *) |
This special event handler can be reimplemented in a subclass to receive native X11 events passed in the event parameter. More... | |
Protected Functions inherited from QObject | |
virtual void | childEvent (QChildEvent *) |
This event handler can be reimplemented in a subclass to receive child events. More... | |
virtual void | connectNotify (const char *signal) |
This virtual function is called when something has been connected to signal in this object. More... | |
virtual void | customEvent (QEvent *) |
This event handler can be reimplemented in a subclass to receive custom events. More... | |
virtual void | disconnectNotify (const char *signal) |
This virtual function is called when something has been disconnected from signal in this object. More... | |
QObject (QObjectPrivate &dd, QObject *parent=0) | |
int | receivers (const char *signal) const |
Returns the number of receivers connected to the signal. More... | |
QObject * | sender () const |
Returns a pointer to the object that sent the signal, if called in a slot activated by a signal; otherwise it returns 0. More... | |
int | senderSignalIndex () const |
virtual void | timerEvent (QTimerEvent *) |
This event handler can be reimplemented in a subclass to receive timer events for the object. More... | |
Protected Functions inherited from QPaintDevice | |
QPaintDevice () | |
Properties | |
bool | animated |
whether manipulating dock widgets and tool bars is animated More... | |
bool | dockNestingEnabled |
whether docks can be nested More... | |
DockOptions | dockOptions |
the docking behavior of QMainWindow More... | |
bool | documentMode |
whether the tab bar for tabbed dockwidgets is set to document mode. More... | |
QSize | iconSize |
size of toolbar icons in this mainwindow. More... | |
QTabWidget::TabShape | tabShape |
the tab shape used for tabbed dock widgets. More... | |
Qt::ToolButtonStyle | toolButtonStyle |
style of toolbar buttons in this mainwindow. More... | |
bool | unifiedTitleAndToolBarOnMac |
whether the window uses the unified title and toolbar look on Mac OS X More... | |
Additional Inherited Members | |
Static Public Functions inherited from QWidget | |
static QWidget * | find (WId) |
Returns a pointer to the widget with window identifer/handle id. More... | |
static QWidget * | keyboardGrabber () |
Returns the widget that is currently grabbing the keyboard input. More... | |
static QWidget * | mouseGrabber () |
Returns the widget that is currently grabbing the mouse input. More... | |
static void | setTabOrder (QWidget *, QWidget *) |
Puts the second widget after the first widget in the focus order. More... | |
Static Public Functions inherited from QObject | |
static bool | connect (const QObject *sender, const char *signal, const QObject *receiver, const char *member, Qt::ConnectionType=Qt::AutoConnection) |
Creates a connection of the given type from the signal in the sender object to the method in the receiver object. More... | |
static bool | connect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method, Qt::ConnectionType type=Qt::AutoConnection) |
static bool | disconnect (const QObject *sender, const char *signal, const QObject *receiver, const char *member) |
Disconnects signal in object sender from method in object receiver. More... | |
static bool | disconnect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &member) |
static uint | registerUserData () |
static QString | tr (const char *sourceText, const char *comment=0, int n=-1) |
static QString | trUtf8 (const char *sourceText, const char *comment=0, int n=-1) |
Static Public Functions inherited from QPaintDevice | |
static QWSDisplay * | qwsDisplay () |
Static Public Variables inherited from QObject | |
static const QMetaObject | staticMetaObject |
This variable stores the meta-object for the class. More... | |
Protected Slots inherited from QWidget | |
void | updateMicroFocus () |
Updates the widget's micro focus. More... | |
Protected Variables inherited from QObject | |
QScopedPointer< QObjectData > | d_ptr |
Protected Variables inherited from QPaintDevice | |
ushort | painters |
Static Protected Variables inherited from QObject | |
static const QMetaObject | staticQtMetaObject |
Related Functions inherited from QWidget | |
QWidgetList | |
WId | |
Platform dependent window identifier. More... | |
Related Functions inherited from QObject | |
T | qFindChildqFindChildren (const QObject *obj, const QString &name)() |
QList< T > | qFindChildrenqFindChildren (const QObject *obj, const QString &name)() |
QList< T > | qFindChildrenqFindChildren (const QObject *obj, const QRegExp ®Exp)() |
T * | qobject_cast (QObject *object) |
QObjectList | |
void * | qt_find_obj_child (QObject *parent, const char *type, const QString &name) |
Returns a pointer to the object named name that inherits type and with a given parent. More... | |
Related Functions inherited from QPaintDevice | |
const Q_GUI_EXPORT QX11Info * | qt_x11Info (const QPaintDevice *pd) |
Returns the QX11Info structure for the pd paint device. More... | |
The QMainWindow class provides a main application window.
A main window provides a framework for building an application's user interface. Qt has QMainWindow and its Main Window and Related Classes{related classes} for main window management. QMainWindow has its own layout to which you can add QToolBar, QDockWidget, a QMenuBar, and a QStatusBar. The layout has a center area that can be occupied by any kind of widget. You can see an image of the layout below.
A central widget will typically be a standard Qt widget such as a QTextEdit or a QGraphicsView. Custom widgets can also be used for advanced applications. You set the central widget with setCentralWidget()
.
Main windows have either a single (SDI) or multiple (MDI) document interface. You create MDI applications in Qt by using a QMdiArea as the central widget.
We will now examine each of the other widgets that can be added to a main window. We give examples on how to create and add them.
Qt implements menus in QMenu and QMainWindow keeps them in a QMenuBar. QActions are added to the menus, which display them as menu items.
You can add new menus to the main window's menu bar by calling menuBar()
, which returns the QMenuBar for the window, and then add a menu with QMenuBar::addMenu().
QMainWindow comes with a default menu bar, but you can also set one yourself with setMenuBar()
. If you wish to implement a custom menu bar (i.e., not use the QMenuBar widget), you can set it with setMenuWidget()
.
An example of how to create menus follows:
The createPopupMenu()
function creates popup menus when the main window receives context menu events. The default implementation generates a menu with the checkable actions from the dock widgets and toolbars. You can reimplement createPopupMenu()
for a custom menu.
Toolbars are implemented in the QToolBar class. You add a toolbar to a main window with addToolBar()
.
You control the initial position of toolbars by assigning them to a specific Qt::ToolBarArea. You can split an area by inserting a toolbar break - think of this as a line break in text editing - with addToolBarBreak()
or insertToolBarBreak()
. You can also restrict placement by the user with QToolBar::setAllowedAreas() and QToolBar::setMovable().
The size of toolbar icons can be retrieved with iconSize()
. The sizes are platform dependent; you can set a fixed size with setIconSize()
. You can alter the appearance of all tool buttons in the toolbars with setToolButtonStyle()
.
An example of toolbar creation follows:
Dock widgets are implemented in the QDockWidget class. A dock widget is a window that can be docked into the main window. You add dock widgets to a main window with addDockWidget()
.
There are four dock widget areas as given by the Qt::DockWidgetArea enum: left, right, top, and bottom. You can specify which dock widget area that should occupy the corners where the areas overlap with setCorner()
. By default each area can only contain one row (vertical or horizontal) of dock widgets, but if you enable nesting with setDockNestingEnabled()
, dock widgets can be added in either direction.
Two dock widgets may also be stacked on top of each other. A QTabBar is then used to select which of the widgets that should be displayed.
We give an example of how to create and add dock widgets to a main window:
You can set a status bar with setStatusBar()
, but one is created the first time statusBar()
(which returns the main window's status bar) is called. See QStatusBar for information on how to use it.
QMainWindow can store the state of its layout with saveState()
; it can later be retrieved with restoreState()
. It is the position and size (relative to the size of the main window) of the toolbars and dock widgets that are stored.
Definition at line 63 of file qmainwindow.h.
This enum contains flags that specify the docking behavior of QMainWindow.
These options only control how dock widgets may be dropped in a QMainWindow. They do not re-arrange the dock widgets to conform with the specified options. For this reason they should be set before any dock widgets are added to the main window. Exceptions to this are the AnimatedDocks and VerticalTabs options, which may be set at any time.
Enumerator | |
---|---|
AnimatedDocks | |
AllowNestedDocks | |
AllowTabbedDocks | |
ForceTabbedDocks | |
VerticalTabs |
Definition at line 87 of file qmainwindow.h.
|
explicit |
Constructs a QMainWindow with the given parent and the specified widget flags.
QMainWindow sets the Qt::Window flag itself, and will hence always be created as a top-level widget.
Definition at line 374 of file qmainwindow.cpp.
QMainWindow::~QMainWindow | ( | ) |
void QMainWindow::addDockWidget | ( | Qt::DockWidgetArea | area, |
QDockWidget * | dockwidget | ||
) |
Adds the given dockwidget to the specified area.
Definition at line 1108 of file qmainwindow.cpp.
Referenced by QAxClientSite::qt_metacall(), and QScriptEngineDebugger::standardWindow().
void QMainWindow::addDockWidget | ( | Qt::DockWidgetArea | area, |
QDockWidget * | dockwidget, | ||
Qt::Orientation | orientation | ||
) |
Adds dockwidget into the given area in the direction specified by the orientation.
Definition at line 1158 of file qmainwindow.cpp.
void QMainWindow::addToolBar | ( | Qt::ToolBarArea | area, |
QToolBar * | toolbar | ||
) |
Adds the toolbar into the specified area in this main window.
The toolbar is placed at the end of the current tool bar block (i.e. line). If the main window already manages toolbar then it will only move the toolbar to area.
Definition at line 764 of file qmainwindow.cpp.
Referenced by addToolBar(), QScriptEngineDebugger::standardWindow(), and QMenuBarPrivate::updateCornerWidgetToolBar().
void QMainWindow::addToolBar | ( | QToolBar * | toolbar | ) |
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. Equivalent of calling addToolBar(Qt::TopToolBarArea, toolbar)
Definition at line 807 of file qmainwindow.cpp.
Creates a QToolBar object, setting its window title to title, and inserts it into the top toolbar area.
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
Definition at line 821 of file qmainwindow.cpp.
void QMainWindow::addToolBarBreak | ( | Qt::ToolBarArea | area = Qt::TopToolBarArea | ) |
Adds a toolbar break to the given area after all the other objects that are present.
Definition at line 733 of file qmainwindow.cpp.
QWidget * QMainWindow::centralWidget | ( | ) | const |
Returns the central widget for the main window.
This function returns zero if the central widget has not been set.
Definition at line 651 of file qmainwindow.cpp.
|
protectedvirtual |
Reimplemented Function
Reimplemented from QWidget.
Definition at line 1631 of file qmainwindow.cpp.
Qt::DockWidgetArea QMainWindow::corner | ( | Qt::Corner | corner | ) | const |
Returns the dock widget area that occupies the specified corner.
Definition at line 708 of file qmainwindow.cpp.
|
virtual |
Returns a popup menu containing checkable entries for the toolbars and dock widgets present in the main window.
If there are no toolbars and dock widgets present, this function returns a null pointer.
By default, this function is called by the main window when the user activates a context menu, typically by right-clicking on a toolbar or a dock widget.
If you want to create a custom popup menu, reimplement this function and return a newly-created popup menu. Ownership of the popup menu is transferred to the caller.
Definition at line 1700 of file qmainwindow.cpp.
Referenced by contextMenuEvent().
DockOptions QMainWindow::dockOptions | ( | ) | const |
Referenced by setDockOptions().
Qt::DockWidgetArea QMainWindow::dockWidgetArea | ( | QDockWidget * | dockwidget | ) | const |
Returns the Qt::DockWidgetArea for dockwidget.
If dockwidget has not been added to the main window, this function returns Qt::NoDockWidgetArea
.
Definition at line 1261 of file qmainwindow.cpp.
bool QMainWindow::documentMode | ( | ) | const |
Referenced by checkDockWidgetArea().
|
protectedvirtual |
Reimplemented Function
Reimplemented from QWidget.
Definition at line 1403 of file qmainwindow.cpp.
QSize QMainWindow::iconSize | ( | ) | const |
Referenced by setDockOptions(), and setIconSize().
|
signal |
This signal is emitted when the size of the icons used in the window is changed.
The new icon size is passed in iconSize.
You can connect this signal to other components to help maintain a consistent appearance for your application.
Referenced by addToolBar(), insertToolBar(), and setIconSize().
Inserts the toolbar into the area occupied by the before toolbar so that it appears before it.
For example, in normal left-to-right layout operation, this means that toolbar will appear to the left of the toolbar specified by before in a horizontal toolbar area.
Definition at line 837 of file qmainwindow.cpp.
void QMainWindow::insertToolBarBreak | ( | QToolBar * | before | ) |
Inserts a toolbar break before the toolbar specified by before.
Definition at line 743 of file qmainwindow.cpp.
bool QMainWindow::isAnimated | ( | ) | const |
Definition at line 914 of file qmainwindow.cpp.
Referenced by addToolBar().
bool QMainWindow::isDockNestingEnabled | ( | ) | const |
Definition at line 956 of file qmainwindow.cpp.
bool QMainWindow::isSeparator | ( | const QPoint & | pos | ) | const |
Definition at line 1616 of file qmainwindow.cpp.
QMenuBar * QMainWindow::menuBar | ( | ) | const |
Returns the menu bar for the main window.
This function creates and returns an empty menu bar if the menu bar does not exist.
If you want all windows in a Mac application to share one menu bar, don't use this function to create it, because the menu bar created here will have this QMainWindow as its parent. Instead, you must create a menu bar that does not have a parent, which you can then share among all the Mac windows. Create a parent-less menu bar this way:
Definition at line 527 of file qmainwindow.cpp.
Referenced by menuWidget(), setMenuBar(), setMenuWidget(), and QScriptEngineDebugger::standardWindow().
QWidget * QMainWindow::menuWidget | ( | ) | const |
Returns the menu bar for the main window.
This function returns null if a menu bar hasn't been constructed yet.
Definition at line 578 of file qmainwindow.cpp.
Referenced by QMdiSubWindowPrivate::drawTitleBarWhenMaximized().
void QMainWindow::removeDockWidget | ( | QDockWidget * | dockwidget | ) |
Removes the dockwidget from the main window layout and hides it.
Note that the dockwidget is not deleted.
Definition at line 1246 of file qmainwindow.cpp.
void QMainWindow::removeToolBar | ( | QToolBar * | toolbar | ) |
Removes the toolbar from the main window layout and hides it.
Note that the toolbar is not deleted.
Definition at line 857 of file qmainwindow.cpp.
void QMainWindow::removeToolBarBreak | ( | QToolBar * | before | ) |
Removes a toolbar break previously inserted before the toolbar specified by before.
Definition at line 750 of file qmainwindow.cpp.
bool QMainWindow::restoreDockWidget | ( | QDockWidget * | dockwidget | ) |
Restores the state of dockwidget if it is created after the call to restoreState().
Returns true if the state was restored; otherwise returns false.
Definition at line 1149 of file qmainwindow.cpp.
bool QMainWindow::restoreState | ( | const QByteArray & | state, |
int | version = 0 |
||
) |
Restores the state of this mainwindow's toolbars and dockwidgets.
The version number is compared with that stored in state. If they do not match, the mainwindow's state is left unchanged, and this function returns false
; otherwise, the state is restored, and this function returns true
.
To restore geometry saved using QSettings, you can use code like this:
Definition at line 1310 of file qmainwindow.cpp.
Referenced by QScriptEngineDebugger::standardWindow().
QByteArray QMainWindow::saveState | ( | int | version = 0 | ) | const |
Saves the current state of this mainwindow's toolbars and dockwidgets.
The version number is stored as part of the data.
The objectName property is used to identify each QToolBar and QDockWidget. You should make sure that this property is unique for each QToolBar and QDockWidget you add to the QMainWindow
To restore the saved state, pass the return value and version number to restoreState().
To save the geometry when the window closes, you can implement a close event like this:
Definition at line 1285 of file qmainwindow.cpp.
|
slot |
Definition at line 920 of file qmainwindow.cpp.
Referenced by addToolBar().
void QMainWindow::setCentralWidget | ( | QWidget * | widget | ) |
Sets the given widget to be the main window's central widget.
Note: QMainWindow takes ownership of the widget pointer and deletes it at the appropriate time.
Definition at line 662 of file qmainwindow.cpp.
Referenced by QScriptEngineDebugger::standardWindow().
void QMainWindow::setCorner | ( | Qt::Corner | corner, |
Qt::DockWidgetArea | area | ||
) |
Sets the given dock widget area to occupy the specified corner.
Definition at line 679 of file qmainwindow.cpp.
|
slot |
Definition at line 962 of file qmainwindow.cpp.
void QMainWindow::setDockOptions | ( | DockOptions | options | ) |
Definition at line 460 of file qmainwindow.cpp.
void QMainWindow::setDocumentMode | ( | bool | enabled | ) |
Definition at line 1036 of file qmainwindow.cpp.
void QMainWindow::setIconSize | ( | const QSize & | iconSize | ) |
Definition at line 475 of file qmainwindow.cpp.
Referenced by event().
void QMainWindow::setMenuBar | ( | QMenuBar * | menuBar | ) |
Sets the menu bar for the main window to menuBar.
Note: QMainWindow takes ownership of the menuBar pointer and deletes it at the appropriate time.
Definition at line 546 of file qmainwindow.cpp.
void QMainWindow::setMenuWidget | ( | QWidget * | menuBar | ) |
Sets the menu bar for the main window to menuBar.
QMainWindow takes ownership of the menuBar pointer and deletes it at the appropriate time.
Definition at line 595 of file qmainwindow.cpp.
void QMainWindow::setStatusBar | ( | QStatusBar * | statusbar | ) |
Sets the status bar for the main window to statusbar.
Setting the status bar to 0 will remove it from the main window. Note that QMainWindow takes ownership of the statusbar pointer and deletes it at the appropriate time.
Definition at line 634 of file qmainwindow.cpp.
void QMainWindow::setTabPosition | ( | Qt::DockWidgetAreas | areas, |
QTabWidget::TabPosition | tabPosition | ||
) |
Sets the tab position for the given dock widget areas to the specified tabPosition.
By default, all dock areas show their tabs at the bottom.
Definition at line 1099 of file qmainwindow.cpp.
void QMainWindow::setTabShape | ( | QTabWidget::TabShape | tabShape | ) |
Definition at line 1060 of file qmainwindow.cpp.
void QMainWindow::setToolButtonStyle | ( | Qt::ToolButtonStyle | toolButtonStyle | ) |
Definition at line 502 of file qmainwindow.cpp.
void QMainWindow::setUnifiedTitleAndToolBarOnMac | ( | bool | set | ) |
Definition at line 1567 of file qmainwindow.cpp.
Referenced by QWidget::showFullScreen(), QWidget::showMaximized(), QWidget::showNormal(), and QScriptEngineDebugger::standardWindow().
void QMainWindow::splitDockWidget | ( | QDockWidget * | first, |
QDockWidget * | second, | ||
Qt::Orientation | orientation | ||
) |
Splits the space covered by the first dock widget into two parts, moves the first dock widget into the first part, and moves the second dock widget into the second part.
The orientation specifies how the space is divided: A Qt::Horizontal split places the second dock widget to the right of the first; a Qt::Vertical split places the second dock widget below the first.
Note: if first is currently in a tabbed docked area, second will be added as a new tab, not as a neighbor of first. This is because a single tab can contain only one dock widget.
Note: The Qt::LayoutDirection influences the order of the dock widgets in the two parts of the divided area. When right-to-left layout direction is enabled, the placing of the dock widgets will be reversed.
Definition at line 1189 of file qmainwindow.cpp.
QStatusBar * QMainWindow::statusBar | ( | ) | const |
Returns the status bar for the main window.
This function creates and returns an empty status bar if the status bar does not exist.
Definition at line 613 of file qmainwindow.cpp.
QList< QDockWidget * > QMainWindow::tabifiedDockWidgets | ( | QDockWidget * | dockwidget | ) | const |
Returns the dock widgets that are tabified together with dockwidget.
Definition at line 1218 of file qmainwindow.cpp.
void QMainWindow::tabifyDockWidget | ( | QDockWidget * | first, |
QDockWidget * | second | ||
) |
Moves second dock widget on top of first dock widget, creating a tabbed docked area in the main window.
Definition at line 1203 of file qmainwindow.cpp.
Referenced by QScriptEngineDebugger::standardWindow().
QTabWidget::TabPosition QMainWindow::tabPosition | ( | Qt::DockWidgetArea | area | ) | const |
Returns the tab position for area.
Definition at line 1078 of file qmainwindow.cpp.
QTabWidget::TabShape QMainWindow::tabShape | ( | ) | const |
Referenced by setDocumentMode().
Qt::ToolBarArea QMainWindow::toolBarArea | ( | QToolBar * | toolbar | ) | const |
Returns the Qt::ToolBarArea for toolbar.
If toolbar has not been added to the main window, this function returns Qt::NoToolBarArea
.
Definition at line 872 of file qmainwindow.cpp.
Referenced by createPopupMenu(), and toolbarInUnifiedToolBar().
bool QMainWindow::toolBarBreak | ( | QToolBar * | toolbar | ) | const |
Returns whether there is a toolbar break before the toolbar.
Definition at line 882 of file qmainwindow.cpp.
Qt::ToolButtonStyle QMainWindow::toolButtonStyle | ( | ) | const |
Referenced by setIconSize(), and setToolButtonStyle().
|
signal |
This signal is emitted when the style used for tool buttons in the window is changed.
The new style is passed in toolButtonStyle.
You can connect this signal to other components to help maintain a consistent appearance for your application.
Referenced by addToolBar(), insertToolBar(), and setToolButtonStyle().
bool QMainWindow::unifiedTitleAndToolBarOnMac | ( | ) | const |
Referenced by createPopupMenu(), event(), and setUnifiedTitleAndToolBarOnMac().
|
private |
whether manipulating dock widgets and tool bars is animated
When a dock widget or tool bar is dragged over the main window, the main window adjusts its contents to indicate where the dock widget or tool bar will be docked if it is dropped. Setting this property causes QMainWindow to move its contents in a smooth animation. Clearing this property causes the contents to snap into their new positions.
By default, this property is set. It may be cleared if the main window contains widgets which are slow at resizing or repainting themselves.
Setting this property is identical to setting the AnimatedDocks option using setDockOptions().
Definition at line 72 of file qmainwindow.h.
Referenced by addToolBar().
|
private |
whether docks can be nested
If this property is false, dock areas can only contain a single row (horizontal or vertical) of dock widgets. If this property is true, the area occupied by a dock widget can be split in either direction to contain more dock widgets.
Dock nesting is only necessary in applications that contain a lot of dock widgets. It gives the user greater freedom in organizing their main window. However, dock nesting leads to more complex (and less intuitive) behavior when a dock widget is dragged over the main window, since there are more ways in which a dropped dock widget may be placed in the dock area.
Setting this property is identical to setting the AllowNestedDocks option using setDockOptions().
Definition at line 79 of file qmainwindow.h.
|
private |
the docking behavior of QMainWindow
The default value is AnimatedDocks | AllowTabbedDocks.
Definition at line 81 of file qmainwindow.h.
Referenced by QDockAreaLayout::gapIndex().
|
private |
whether the tab bar for tabbed dockwidgets is set to document mode.
The default is false.
Definition at line 74 of file qmainwindow.h.
|
private |
size of toolbar icons in this mainwindow.
The default is the default tool bar icon size of the GUI style. Note that the icons used must be at least of this size as the icons are only scaled down.
Definition at line 69 of file qmainwindow.h.
Referenced by QToolBar::setIconSize().
|
private |
the tab shape used for tabbed dock widgets.
The default is QTabWidget::Rounded .
Definition at line 77 of file qmainwindow.h.
|
private |
style of toolbar buttons in this mainwindow.
The default is Qt::ToolButtonIconOnly.
Definition at line 70 of file qmainwindow.h.
|
private |
whether the window uses the unified title and toolbar look on Mac OS X
This property is false by default and only has any effect on Mac OS X 10.4 or higher.
If set to true, then the top toolbar area is replaced with a Carbon HIToolbar or a Cocoa NSToolbar (depending on whether Qt was built with Carbon or Cocoa). All toolbars in the top toolbar area and any toolbars added afterwards are moved to that. This means a couple of things.
Setting this back to false will remove these restrictions.
The Qt::WA_MacBrushedMetal attribute takes precedence over this property.
Definition at line 83 of file qmainwindow.h.
Referenced by QToolBar::allowedAreas(), QWidgetPrivate::childAt_helper(), QMacStyle::drawControl(), QToolBarAreaLayout::fitLayout(), qt_mac_unregister_widget(), QToolBarAreaLayout::restoreState(), QWidget::showFullScreen(), toolbarInUnifiedToolBar(), and QMainWindowLayout::usesHIToolBar().