QMdiArea Class

Documentation sur les fonctions membres

QMdiArea::QMdiArea(QWidget *parent = nullptr)

Crée une zone MDI vide. L'objet ` parent ` est transmis au constructeur de ` QWidget`.

[virtual noexcept] QMdiArea::~QMdiArea()

Supprime la zone MDI.

[slot] void QMdiArea::activateNextSubWindow()

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

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

[slot] void QMdiArea::activatePreviousSubWindow()

Attribue le focus clavier à une autre fenêtre de la liste des fenêtres enfants. La fenêtre activée sera la précédente, telle que déterminée par la variable activation order.

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

QMdiSubWindow *QMdiArea::activeSubWindow() const

Renvoie un pointeur vers la sous-fenêtre actuellement active. Si aucune fenêtre n'est active, la valeur « nullptr » est renvoyée.

Les sous-fenêtres sont traitées comme des fenêtres de premier niveau en ce qui concerne l’état de la fenêtre ; ainsi, 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 obtient 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 en tant que nouvelle sous-fenêtre à la zone MDI. Si windowFlags sont différents de zéro, ils remplaceront les indicateurs définis sur le widget.

L’ widget peut être soit un QMdiSubWindow, soit un autre QWidget (auquel cas la zone MDI créera une sous-fenêtre et définira l’ 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 « Qt::WA_DeleteOnClose » du widget si vous souhaitez que la fenêtre soit supprimée lorsqu’elle est fermée dans la zone MDI. Sinon, la fenêtre sera masquée et la zone MDI n’activera pas la sous-fenêtre suivante.

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

Voir aussi removeSubWindow().

[slot] void QMdiArea::cascadeSubWindows()

Dispose toutes les fenêtres enfants 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 événement « QCloseEvent » à chacune d’entre elles. Vous pouvez recevoir des signaux « subWindowActivated() » provenant des sous-fenêtres avant leur fermeture (si la zone MDI active une 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 vers la sous-fenêtre active, ou ` nullptr ` s'il n'y a pas de sous-fenêtre active.

Cette fonction renvoie le même résultat que activeSubWindow() si l'QApplication contenant QMdiArea est active.

Voir également 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. L’ widget e doit être soit un QMdiSubWindow, soit un widget qui est le widget interne d’une sous-fenêtre. Remarque : widget n’est en réalité jamais supprimé par QMdiArea. Si un QMdiSubWindow est passé en paramètre, son parent est défini sur nullptr et il est supprimé ; mais si un widget interne est passé en paramètre, le widget enfant est défini sur nullptr et l’ QMdiSubWindow n’ est pas supprimé.

Voir également 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émentation de : 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 actuellement active est désactivée.

Voir également activeSubWindow().

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

Si la valeur de on est « true », la fonction « option » est activée dans la zone MDI ; dans le cas contraire, elle est désactivée. Consultez AreaOption pour connaître 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 l'appel de ` setViewport()`. Réimplémentez cette fonction dans une sous-classe de ` QMdiArea ` pour initialiser le nouvel ` viewport ` avant son utilisation.

Voir également 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 une fois que la fonction « window » a été activée. Lorsque « window » vaut « nullptr », « QMdiArea » vient de désactiver sa dernière fenêtre active et il n'y a plus 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 présentes dans la zone MDI. Si order est défini sur 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 défini sur StackingOrder, les fenêtres sont répertoriées dans leur ordre d’empilement, la fenêtre la plus en haut apparaissant en dernier dans la liste. Si order est défini sur ActivationHistoryOrder, les fenêtres sont répertorié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 également AreaOption et setOption().

[slot] void QMdiArea::tileSubWindows()

Dispose toutes les fenêtres enfants selon un motif en mosaïque.

Voir aussi 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).