QMdiArea Class

Documentation des fonctions membres

QMdiArea::QMdiArea(QWidget *parent = nullptr)

Construit une zone mdi vide. parent est transmis au constructeur de QWidget.

[virtual noexcept] QMdiArea::~QMdiArea()

Détruit la zone MDI.

[slot] void QMdiArea::activateNextSubWindow()

Donne le focus clavier à une autre fenêtre dans la liste des fenêtres enfants. La fenêtre activée sera la suivante, déterminée par l'adresse activation order.

Voir également activatePreviousSubWindow() et QMdiArea::WindowOrder.

[slot] void QMdiArea::activatePreviousSubWindow()

Donne le focus clavier à une autre fenêtre dans la liste des fenêtres enfants. La fenêtre activée sera la précédente, déterminée par l'adresse activation order.

Voir également activateNextSubWindow() et QMdiArea::WindowOrder.

QMdiSubWindow *QMdiArea::activeSubWindow() const

Renvoie un pointeur sur la sous-fenêtre active actuelle. Si aucune fenêtre n'est active, nullptr est renvoyé.

Les sous-fenêtres sont traitées comme des fenêtres de niveau supérieur en ce qui concerne l'état de la fenêtre, c'est-à-dire que si un widget situé en dehors de la zone MDI est la fenêtre active, aucune sous-fenêtre ne sera active. Notez que si un widget de la fenêtre dans laquelle se trouve la zone MDI gagne le focus, la fenêtre sera activée.

Voir également setActiveSubWindow() et Qt::WindowState.

QMdiSubWindow *QMdiArea::addSubWindow(QWidget *widget, Qt::WindowFlags windowFlags = Qt::WindowFlags())

Ajoute widget comme nouvelle sous-fenêtre à la zone MDI. Si windowFlags est différent de zéro, il remplacera les drapeaux définis sur le widget.

Le site widget peut être soit un site QMdiSubWindow, soit un autre site QWidget (dans ce cas, la zone MDI créera une sous-fenêtre et définira le site widget comme widget interne).

QMdiArea mdiArea;
QMdiSubWindow *subWindow1 = new QMdiSubWindow;
subWindow1->setWidget(internalWidget1);
subWindow1->setAttribute(Qt::WA_DeleteOnClose);
mdiArea.addSubWindow(subWindow1);

QMdiSubWindow *subWindow2 =
    mdiArea.addSubWindow(internalWidget2);

Lorsque vous créez votre propre sous-fenêtre, vous devez définir l'attribut de widget Qt::WA_DeleteOnClose si vous souhaitez que la fenêtre soit supprimée lorsqu'elle est fermée dans la zone MDI. Sinon, la fenêtre sera cachée et la zone MDI n'activera pas la sous-fenêtre suivante.

Renvoie l'adresse QMdiSubWindow qui est ajoutée à la zone MDI.

Voir également removeSubWindow().

[slot] void QMdiArea::cascadeSubWindows()

Organise toutes les fenêtres enfants selon un modèle en cascade.

Voir également tileSubWindows().

[override virtual protected] void QMdiArea::childEvent(QChildEvent *childEvent)

Réimplémente : QObject::childEvent(QChildEvent *event).

[slot] void QMdiArea::closeActiveSubWindow()

Ferme la sous-fenêtre active.

Voir aussi closeAllSubWindows().

[slot] void QMdiArea::closeAllSubWindows()

Ferme toutes les sous-fenêtres en envoyant un message QCloseEvent à chacune d'entre elles. Il est possible que vous receviez des signaux subWindowActivated() des sous-fenêtres avant qu'elles ne soient fermées (si la zone MDI active la sous-fenêtre alors qu'une autre est en train de se fermer).

Les sous-fenêtres qui ignorent l'événement de fermeture resteront ouvertes.

Voir également closeActiveSubWindow().

QMdiSubWindow *QMdiArea::currentSubWindow() const

Renvoie un pointeur sur la sous-fenêtre courante, ou nullptr s'il n'y a pas de sous-fenêtre courante.

Cette fonction renvoie la même chose que activeSubWindow() si la fenêtre QApplication contenant QMdiArea est active.

Voir aussi activeSubWindow() et QApplication::activeWindow().

[override virtual protected] bool QMdiArea::event(QEvent *event)

Réimplémente : QAbstractScrollArea::event(QEvent *event).

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

Réimplémente : QObject::eventFilter(QObject *watched, QEvent *event).

[override virtual] QSize QMdiArea::minimumSizeHint() const

Réimplémente : QAbstractScrollArea::minimumSizeHint() const.

[override virtual protected] void QMdiArea::paintEvent(QPaintEvent *paintEvent)

Réimplémente : QAbstractScrollArea::paintEvent(QPaintEvent *event).

void QMdiArea::removeSubWindow(QWidget *widget)

Supprime widget de la zone MDI. Le widget doit être soit un QMdiSubWindow, soit un widget qui est le widget interne d'une sous-fenêtre. Remarque : widget n'est jamais réellement supprimé par QMdiArea. Si un QMdiSubWindow est transmis, son parent est défini sur nullptr et il est supprimé ; mais si un widget interne est transmis, le widget enfant est défini sur nullptr et le QMdiSubWindow n' est pas supprimé.

Voir aussi addSubWindow().

[override virtual protected] void QMdiArea::resizeEvent(QResizeEvent *resizeEvent)

Réimplémente : QAbstractScrollArea::resizeEvent(QResizeEvent *event).

[override virtual protected] void QMdiArea::scrollContentsBy(int dx, int dy)

Réimplémente : QAbstractScrollArea::scrollContentsBy(int dx, int dy).

[slot] void QMdiArea::setActiveSubWindow(QMdiSubWindow *window)

Active la sous-fenêtre window. Si window est nullptr, toute fenêtre active est désactivée.

Voir aussi activeSubWindow().

void QMdiArea::setOption(QMdiArea::AreaOption option, bool on = true)

Si on est vrai, option est activé sur la zone MDI, sinon il est désactivé. Voir AreaOption pour l'effet de chaque option.

Voir également AreaOption et testOption().

[override virtual protected slot] void QMdiArea::setupViewport(QWidget *viewport)

Réimplémente : QAbstractScrollArea::setupViewport(QWidget *viewport).

Ce slot est appelé par QAbstractScrollArea après que setViewport() a été appelé. Réimplémentez cette fonction dans une sous-classe de QMdiArea pour initialiser le nouveau viewport avant qu'il ne soit utilisé.

Voir aussi setViewport().

[override virtual protected] void QMdiArea::showEvent(QShowEvent *showEvent)

Réimplémente : QWidget::showEvent(QShowEvent *event).

[override virtual] QSize QMdiArea::sizeHint() const

Réimplémente : QAbstractScrollArea::sizeHint() const.

[signal] void QMdiArea::subWindowActivated(QMdiSubWindow *window)

QMdiArea émet ce signal après l'activation de window. Lorsque window est nullptr, QMdiArea vient de désactiver sa dernière fenêtre active et il n'y a aucune fenêtre active dans l'espace de travail.

Voir également QMdiArea::activeSubWindow().

QList<QMdiSubWindow *> QMdiArea::subWindowList(QMdiArea::WindowOrder order = CreationOrder) const

Renvoie une liste de toutes les sous-fenêtres de la zone MDI. Si order est CreationOrder (valeur par défaut), les fenêtres sont triées dans l'ordre dans lequel elles ont été insérées dans l'espace de travail. Si order est StackingOrder, les fenêtres sont classées dans l'ordre d'empilement, la fenêtre la plus haute étant le dernier élément de la liste. Si order est ActivationHistoryOrder, les fenêtres sont classées en fonction de leur historique d'activation récent.

Voir également WindowOrder.

bool QMdiArea::testOption(QMdiArea::AreaOption option) const

Renvoie true si option est activé ; sinon, renvoie false.

Voir aussi AreaOption et setOption().

[slot] void QMdiArea::tileSubWindows()

Dispose toutes les fenêtres enfant dans un motif de tuiles.

Voir également cascadeSubWindows().

[override virtual protected] void QMdiArea::timerEvent(QTimerEvent *timerEvent)

Réimplémente : QObject::timerEvent(QTimerEvent *event).

[override virtual protected] bool QMdiArea::viewportEvent(QEvent *event)

Réimplémente : QAbstractScrollArea::viewportEvent(QEvent *event).