QMdiArea Class

Documentación de las funciones miembro

QMdiArea::QMdiArea(QWidget *parent = nullptr)

Construye un área mdi vacía. parent se pasa al constructor de QWidget.

[virtual noexcept] QMdiArea::~QMdiArea()

Destruye el área MDI.

[slot] void QMdiArea::activateNextSubWindow()

Da el foco del teclado a otra ventana de la lista de ventanas hijas. La ventana activada será la siguiente determinada por el activation order actual.

Véase también activatePreviousSubWindow() y QMdiArea::WindowOrder.

[slot] void QMdiArea::activatePreviousSubWindow()

Da el foco del teclado a otra ventana de la lista de ventanas hijas. La ventana activada será la anterior determinada por el activation order actual.

Véase también activateNextSubWindow() y QMdiArea::WindowOrder.

QMdiSubWindow *QMdiArea::activeSubWindow() const

Devuelve un puntero a la subventana activa en ese momento. Si no hay ninguna ventana activa, se devuelve nullptr.

Las subventanas se tratan como ventanas de nivel superior con respecto al estado de la ventana, es decir, si un widget fuera del área MDI es la ventana activa, ninguna subventana estará activa. Tenga en cuenta que si un widget de la ventana en la que vive el área MDI obtiene el foco, la ventana se activará.

Véase también setActiveSubWindow() y Qt::WindowState.

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

Añade widget como una nueva subventana al área MDI. Si windowFlags es distinto de cero, anulará las banderas establecidas en el widget.

El widget puede ser un QMdiSubWindow u otro QWidget (en cuyo caso el área MDI creará una subventana y establecerá el widget como widget interno).

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

QMdiSubWindow *subWindow2 =
    mdiArea.addSubWindow(internalWidget2);

Cuando cree su propia subventana, deberá establecer el atributo de widget Qt::WA_DeleteOnClose si desea que la ventana se elimine cuando se cierre en el área MDI. De lo contrario, la ventana se ocultará y el área MDI no activará la siguiente subventana.

Devuelve el QMdiSubWindow que se añade al área MDI.

Véase también removeSubWindow().

[slot] void QMdiArea::cascadeSubWindows()

Ordena todas las ventanas hijas en cascada.

Véase también tileSubWindows().

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

Reimplementa: QObject::childEvent(QChildEvent *event).

[slot] void QMdiArea::closeActiveSubWindow()

Cierra la subventana activa.

Véase también closeAllSubWindows().

[slot] void QMdiArea::closeAllSubWindows()

Cierra todas las subventanas enviando un QCloseEvent a cada una de ellas. Puede recibir señales subWindowActivated() de las subventanas antes de que se cierren (si el área MDI activa la subventana cuando otra se está cerrando).

Las subventanas que ignoren el evento de cierre permanecerán abiertas.

Véase también closeActiveSubWindow().

QMdiSubWindow *QMdiArea::currentSubWindow() const

Devuelve un puntero a la subventana actual, o nullptr si no hay subventana actual.

Esta función devolverá lo mismo que activeSubWindow() si la QApplication que contiene QMdiArea está activa.

Véase también activeSubWindow() y QApplication::activeWindow().

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

Reimplementa: QAbstractScrollArea::event(QEvent *event).

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

Reimplementa: QObject::eventFilter(QObject *watched, QEvent *event).

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

Reimplementa: QAbstractScrollArea::minimumSizeHint() const.

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

Reimplementa: QAbstractScrollArea::paintEvent(QPaintEvent *event).

void QMdiArea::removeSubWindow(QWidget *widget)

Elimina widget del área MDI. El widget debe ser un QMdiSubWindow o un widget que sea el widget interno de una subventana. Tenga en cuenta que widget nunca es eliminado por QMdiArea. Si se pasa un QMdiSubWindow, su padre se establece en nullptr y se elimina; pero si se pasa un widget interno, el widget hijo se establece en nullptr y el QMdiSubWindow no se elimina.

Véase también addSubWindow().

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

Reimplementa: QAbstractScrollArea::resizeEvent(QResizeEvent *event).

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

Reimplementa: QAbstractScrollArea::scrollContentsBy(int dx, int dy).

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

Activa la subventana window. Si window es nullptr, se desactiva cualquier ventana activa en ese momento.

Véase también activeSubWindow().

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

Si on es verdadero, option se activa en el área MDI; en caso contrario, se desactiva. Consulte AreaOption para conocer el efecto de cada opción.

Véase también AreaOption y testOption().

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

Reimplementa: QAbstractScrollArea::setupViewport(QWidget *viewport).

Este slot es llamado por QAbstractScrollArea después de que setViewport() haya sido llamado. Reimplemente esta función en una subclase de QMdiArea para inicializar el nuevo viewport antes de usarlo.

Ver también setViewport().

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

Reimplementa: QWidget::showEvent(QShowEvent *event).

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

Reimplementa: QAbstractScrollArea::sizeHint() const.

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

QMdiArea emite esta señal después de que window se haya activado. Cuando window es nullptr, QMdiArea acaba de desactivar su última ventana activa, y no hay ventanas activas en el espacio de trabajo.

Véase también QMdiArea::activeSubWindow().

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

Devuelve una lista de todas las subventanas del área MDI. Si order es CreationOrder (el valor predeterminado), las ventanas se ordenan en el orden en que se insertaron en el área de trabajo. Si order es StackingOrder, las ventanas se enumeran en su orden de apilamiento, con la ventana superior como último elemento de la lista. Si order es ActivationHistoryOrder, las ventanas se ordenan según su historial de activación reciente.

Véase también WindowOrder.

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

Devuelve true si option está habilitado; en caso contrario devuelve false.

Véase también AreaOption y setOption().

[slot] void QMdiArea::tileSubWindows()

Ordena todas las ventanas hijas en forma de mosaico.

Véase también cascadeSubWindows().

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

Reimplementa: QObject::timerEvent(QTimerEvent *event).

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

Reimplementa: QAbstractScrollArea::viewportEvent(QEvent *event).