Viadeo Twitter Google Bookmarks ! Facebook Digg MySpace Yahoo MyWeb Blinklist Netvouz Reddit Simpy StumbleUpon Bookmarks Windows Live Favorites 
Logo Documentation Qt ·  Page d'accueil  ·  Toutes les classes  ·  Toutes les fonctions  ·  Vues d'ensemble  · 

QMdiSubWindow Class Reference

The QMdiSubWindow class provides a subwindow class for QMdiArea. More...

 #include <QMdiSubWindow>

Inherits: QWidget.

This class was introduced in Qt 4.3.

Public Types

enum SubWindowOption { RubberBandResize, RubberBandMove }
flags SubWindowOptions


  • 58 properties inherited from QWidget
  • 1 property inherited from QObject

Public Functions

QMdiSubWindow ( QWidget * parent = 0, Qt::WindowFlags flags = 0 )
~QMdiSubWindow ()
bool isShaded () const
int keyboardPageStep () const
int keyboardSingleStep () const
QMdiArea * mdiArea () const
void setKeyboardPageStep ( int step )
void setKeyboardSingleStep ( int step )
void setOption ( SubWindowOption option, bool on = true )
void setSystemMenu ( QMenu * systemMenu )
void setWidget ( QWidget * widget )
QMenu * systemMenu () const
bool testOption ( SubWindowOption option ) const
QWidget * widget () const

Reimplemented Public Functions

virtual QSize minimumSizeHint () const
virtual QSize sizeHint () const
  • 217 public functions inherited from QWidget
  • 29 public functions inherited from QObject
  • 13 public functions inherited from QPaintDevice

Public Slots

void showShaded ()
void showSystemMenu ()
  • 19 public slots inherited from QWidget
  • 1 public slot inherited from QObject


void aboutToActivate ()
void windowStateChanged ( Qt::WindowStates oldState, Qt::WindowStates newState )

Reimplemented Protected Functions

virtual void changeEvent ( QEvent * changeEvent )
virtual void childEvent ( QChildEvent * childEvent )
virtual void closeEvent ( QCloseEvent * closeEvent )
virtual void contextMenuEvent ( QContextMenuEvent * contextMenuEvent )
virtual bool event ( QEvent * event )
virtual bool eventFilter ( QObject * object, QEvent * event )
virtual void focusInEvent ( QFocusEvent * focusInEvent )
virtual void focusOutEvent ( QFocusEvent * focusOutEvent )
virtual void hideEvent ( QHideEvent * hideEvent )
virtual void keyPressEvent ( QKeyEvent * keyEvent )
virtual void leaveEvent ( QEvent * leaveEvent )
virtual void mouseDoubleClickEvent ( QMouseEvent * mouseEvent )
virtual void mouseMoveEvent ( QMouseEvent * mouseEvent )
virtual void mousePressEvent ( QMouseEvent * mouseEvent )
virtual void mouseReleaseEvent ( QMouseEvent * mouseEvent )
virtual void moveEvent ( QMoveEvent * moveEvent )
virtual void paintEvent ( QPaintEvent * paintEvent )
virtual void resizeEvent ( QResizeEvent * resizeEvent )
virtual void showEvent ( QShowEvent * showEvent )
virtual void timerEvent ( QTimerEvent * timerEvent )
  • 37 protected functions inherited from QWidget
  • 7 protected functions inherited from QObject
  • 1 protected function inherited from QPaintDevice

Additional Inherited Members

  • 4 static public members inherited from QWidget
  • 5 static public members inherited from QObject
  • 37 protected functions inherited from QWidget
  • 7 protected functions inherited from QObject
  • 1 protected function inherited from QPaintDevice
  • 1 protected slot inherited from QWidget

Detailed Description

The QMdiSubWindow class provides a subwindow class for QMdiArea.

QMdiSubWindow represents a top-level window in a QMdiArea, and consists of a title bar with window decorations, an internal widget, and (depending on the current style) a window frame and a size grip. QMdiSubWindow has its own layout, which consists of the title bar and a center area for the internal widget.

The most common way to construct a QMdiSubWindow is to call QMdiArea::addSubWindow() with the internal widget as the argument. You can also create a subwindow yourself, and set an internal widget by calling setWidget().

You use the same API when programming with subwindows as with regular top-level windows (e.g., you can call functions such as show(), hide(), showMaximized(), and setWindowTitle()).

Subwindow Handling

QMdiSubWindow also supports behavior specific to subwindows in an MDI area.

By default, each QMdiSubWindow is visible inside the MDI area viewport when moved around, but it is also possible to specify transparent window movement and resizing behavior, where only the outline of a subwindow is updated during these operations. The setOption() function is used to enable this behavior.

The isShaded() function detects whether the subwindow is currently shaded (i.e., the window is collapsed so that only the title bar is visible). To enter shaded mode, call showShaded(). QMdiSubWindow emits the windowStateChanged() signal whenever the window state has changed (e.g., when the window becomes minimized, or is restored). It also emits aboutToActivate() before it is activated.

In keyboard-interactive mode, the windows are moved and resized with the keyboard. You can enter this mode through the system menu of the window. The keyboardSingleStep and keyboardPageStep properties control the distance the widget is moved or resized for each keypress event. When shift is pressed down page step is used; otherwise single step is used.

You can also change the active window with the keyboard. By pressing the control and tab keys at the same time, the next (using the current WindowOrder) subwindow will be activated. By pressing control, shift, and tab, you will activate the previous window. This is equivalent to calling activateNextSubWindow() and activatePreviousSubWindow(). Note that these shortcuts overrides global shortcuts, but not the QMdiAreas shortcuts.

See also QMdiArea.

Member Type Documentation

enum QMdiSubWindow::SubWindowOption
flags QMdiSubWindow::SubWindowOptions

This enum describes options that customize the behavior of QMdiSubWindow.

QMdiSubWindow::RubberBandResize0x4If you enable this option, a rubber band control is used to represent the subwindow's outline, and the user resizes this instead of the subwindow itself. As a result, the subwindow maintains its original position and size until the resize operation has been completed, at which time it will receive a single QResizeEvent. By default, this option is disabled.
QMdiSubWindow::RubberBandMove0x8If you enable this option, a rubber band control is used to represent the subwindow's outline, and the user moves this instead of the subwindow itself. As a result, the subwindow remains in its original position until the move operation has completed, at which time a QMoveEvent is sent to the window. By default, this option is disabled.

The SubWindowOptions type is a typedef for QFlags<SubWindowOption>. It stores an OR combination of SubWindowOption values.

Property Documentation

keyboardPageStep : int

This property holds sets how far a widget should move or resize when using the keyboard page keys.

When in keyboard-interactive mode, you can use the arrow and page keys to either move or resize the window. This property controls the page keys. The common way to enter keyboard interactive mode is to enter the subwindow menu, and select either "resize" or "move".

The default keyboard page step value is 20 pixels.

Access functions:

int keyboardPageStep () const
void setKeyboardPageStep ( int step )

See also keyboardSingleStep.

keyboardSingleStep : int

This property holds sets how far a widget should move or resize when using the keyboard arrow keys.

When in keyboard-interactive mode, you can use the arrow and page keys to either move or resize the window. This property controls the arrow keys. The common way to enter keyboard interactive mode is to enter the subwindow menu, and select either "resize" or "move".

The default keyboard single step value is 5 pixels.

Access functions:

int keyboardSingleStep () const
void setKeyboardSingleStep ( int step )

See also keyboardPageStep.

Member Function Documentation

QMdiSubWindow::QMdiSubWindow ( QWidget * parent = 0, Qt::WindowFlags flags = 0 )

Constructs a new QMdiSubWindow widget. The parent and flags arguments are passed to QWidget's constructor.

Instead of using addSubWindow(), it is also simply possible to use setParent() when you add the subwindow to a QMdiArea.

Note that only QMdiSubWindows can be set as children of QMdiArea; you cannot, for instance, write:

 QMdiArea mdiArea;
 QTextEdit editor(&mdiArea); // invalid child widget

See also QMdiArea::addSubWindow().

QMdiSubWindow::~QMdiSubWindow ()

Destroys the subwindow.

See also QMdiArea::removeSubWindow().

void QMdiSubWindow::aboutToActivate () [signal]

QMdiSubWindow emits this signal immediately before it is activated. After the subwindow has been activated, the QMdiArea that manages the subwindow will also emit the subWindowActivated() signal.

See also QMdiArea::subWindowActivated().

void QMdiSubWindow::changeEvent ( QEvent * changeEvent ) [virtual protected]

Reimplemented from QWidget::changeEvent().

void QMdiSubWindow::childEvent ( QChildEvent * childEvent ) [virtual protected]

Reimplemented from QObject::childEvent().

void QMdiSubWindow::closeEvent ( QCloseEvent * closeEvent ) [virtual protected]

Reimplemented from QWidget::closeEvent().

void QMdiSubWindow::contextMenuEvent ( QContextMenuEvent * contextMenuEvent ) [virtual protected]

Reimplemented from QWidget::contextMenuEvent().

bool QMdiSubWindow::event ( QEvent * event ) [virtual protected]

Reimplemented from QObject::event().

bool QMdiSubWindow::eventFilter ( QObject * object, QEvent * event ) [virtual protected]

Reimplemented from QObject::eventFilter().

void QMdiSubWindow::focusInEvent ( QFocusEvent * focusInEvent ) [virtual protected]

Reimplemented from QWidget::focusInEvent().

void QMdiSubWindow::focusOutEvent ( QFocusEvent * focusOutEvent ) [virtual protected]

Reimplemented from QWidget::focusOutEvent().

void QMdiSubWindow::hideEvent ( QHideEvent * hideEvent ) [virtual protected]

Reimplemented from QWidget::hideEvent().

bool QMdiSubWindow::isShaded () const

Returns true if this window is shaded; otherwise returns false.

A window is shaded if it is collapsed so that only the title bar is visible.

void QMdiSubWindow::keyPressEvent ( QKeyEvent * keyEvent ) [virtual protected]

Reimplemented from QWidget::keyPressEvent().

void QMdiSubWindow::leaveEvent ( QEvent * leaveEvent ) [virtual protected]

Reimplemented from QWidget::leaveEvent().

QMdiArea * QMdiSubWindow::mdiArea () const

Returns the area containing this sub-window, or 0 if there is none.

This function was introduced in Qt 4.4.

See also QMdiArea::addSubWindow().

QSize QMdiSubWindow::minimumSizeHint () const [virtual]

Reimplemented from QWidget::minimumSizeHint().

void QMdiSubWindow::mouseDoubleClickEvent ( QMouseEvent * mouseEvent ) [virtual protected]

Reimplemented from QWidget::mouseDoubleClickEvent().

void QMdiSubWindow::mouseMoveEvent ( QMouseEvent * mouseEvent ) [virtual protected]

Reimplemented from QWidget::mouseMoveEvent().

void QMdiSubWindow::mousePressEvent ( QMouseEvent * mouseEvent ) [virtual protected]

Reimplemented from QWidget::mousePressEvent().

void QMdiSubWindow::mouseReleaseEvent ( QMouseEvent * mouseEvent ) [virtual protected]

Reimplemented from QWidget::mouseReleaseEvent().

void QMdiSubWindow::moveEvent ( QMoveEvent * moveEvent ) [virtual protected]

Reimplemented from QWidget::moveEvent().

void QMdiSubWindow::paintEvent ( QPaintEvent * paintEvent ) [virtual protected]

Reimplemented from QWidget::paintEvent().

void QMdiSubWindow::resizeEvent ( QResizeEvent * resizeEvent ) [virtual protected]

Reimplemented from QWidget::resizeEvent().

void QMdiSubWindow::setOption ( SubWindowOption option, bool on = true )

If on is true, option is enabled on the subwindow; otherwise it is disabled. See SubWindowOption for the effect of each option.

See also SubWindowOption and testOption().

void QMdiSubWindow::setSystemMenu ( QMenu * systemMenu )

Sets systemMenu as the current system menu for this subwindow.

By default, each QMdiSubWindow has a standard system menu.

QActions for the system menu created by QMdiSubWindow will automatically be updated depending on the current window state; e.g., the minimize action will be disabled after the window is minimized.

QActions added by the user are not updated by QMdiSubWindow.

QMdiSubWindow takes ownership of systemMenu; you do not have to delete it. Any existing menus will be deleted.

See also systemMenu() and showSystemMenu().

void QMdiSubWindow::setWidget ( QWidget * widget )

Sets widget as the internal widget of this subwindow. The internal widget is displayed in the center of the subwindow beneath the title bar.

QMdiSubWindow takes temporary ownership of widget; you do not have to delete it. Any existing internal widget will be removed and reparented to the root window.

See also widget().

void QMdiSubWindow::showEvent ( QShowEvent * showEvent ) [virtual protected]

Reimplemented from QWidget::showEvent().

void QMdiSubWindow::showShaded () [slot]

Calling this function makes the subwindow enter the shaded mode. When the subwindow is shaded, only the title bar is visible.

Although shading is not supported by all styles, this function will still show the subwindow as shaded, regardless of whether support for shading is available. However, when used with styles without shading support, the user will be unable to return from shaded mode through the user interface (e.g., through a shade button in the title bar).

See also isShaded().

void QMdiSubWindow::showSystemMenu () [slot]

Shows the system menu below the system menu icon in the title bar.

See also setSystemMenu() and systemMenu().

QSize QMdiSubWindow::sizeHint () const [virtual]

Reimplemented from QWidget::sizeHint().

QMenu * QMdiSubWindow::systemMenu () const

Returns a pointer to the current system menu, or zero if no system menu is set. QMdiSubWindow provides a default system menu, but you can also set the menu with setSystemMenu().

See also setSystemMenu() and showSystemMenu().

bool QMdiSubWindow::testOption ( SubWindowOption option ) const

Returns true if option is enabled; otherwise returns false.

See also SubWindowOption and setOption().

void QMdiSubWindow::timerEvent ( QTimerEvent * timerEvent ) [virtual protected]

Reimplemented from QObject::timerEvent().

QWidget * QMdiSubWindow::widget () const

Returns the current internal widget.

See also setWidget().

void QMdiSubWindow::windowStateChanged ( Qt::WindowStates oldState, Qt::WindowStates newState ) [signal]

QMdiSubWindow emits this signal after the window state changes. oldState is the window state before it changed, and newState is the new, current state.


Best Of

Actualités les plus lues

  1. Microsoft ouvre aux autres compilateurs C++ AMP, la spécification pour la conception d'applications parallèles C++ utilisant le GPU 22
  2. Les développeurs ignorent-ils trop les failles découvertes dans leur code ? Prenez-vous en compte les remarques des autres ? 17
  3. RIM : « 13 % des développeurs ont gagné plus de 100 000 $ sur l'AppWord », Qt et open-source au menu du BlackBerry DevCon Europe 0
  4. « Quelque chose ne va vraiment pas avec les développeurs "modernes" », un développeur à "l'ancienne" critique la multiplication des bibliothèques 12
  5. BlackBerry 10 : premières images du prochain OS de RIM qui devrait intégrer des widgets et des tuiles inspirées de Windows Phone 0
  6. Adieu qmake, bienvenue qbs : Qt Building Suite, un outil déclaratif et extensible pour la compilation de projets Qt 17
  7. Quelles nouveautés de C++11 Visual C++ doit-il rapidement intégrer ? Donnez-nous votre avis 10
Page suivante

Le Qt Developer Network au hasard


Compiler l'add-in Qt de Visual Studio

Le Qt Developer Network est un réseau de développeurs Qt anglophone, où ils peuvent partager leur expérience sur le framework. Lire l'article.



Liens utiles


  • Vous souhaitez rejoindre la rédaction ou proposer un tutoriel, une traduction, une question... ? Postez dans le forum Contribuez ou contactez-nous par MP ou par email (voir en bas de page).

Qt dans le magazine

Cette page est une traduction d'une page de la documentation de Qt, écrite par Nokia Corporation and/or its subsidiary(-ies). Les éventuels problèmes résultant d'une mauvaise traduction ne sont pas imputables à Nokia. Qt 4.7
Copyright © 2012 Developpez LLC. Tous droits réservés Developpez LLC. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon, vous encourez selon la loi jusqu'à 3 ans de prison et jusqu'à 300 000 E de dommages et intérêts. Cette page est déposée à la SACD.
Vous avez déniché une erreur ? Un bug ? Une redirection cassée ? Ou tout autre problème, quel qu'il soit ? Ou bien vous désirez participer à ce projet de traduction ? N'hésitez pas à nous contacter ou par MP !

Hébergement Web