QMainWindow Class

Documentación de funciones miembro

[explicit] QMainWindow::QMainWindow(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())

Construye un QMainWindow con el parent dado y el widget flags especificado.

QMainWindow establece la bandera Qt::Window por sí mismo, y por lo tanto siempre será creado como un widget de nivel superior.

[virtual noexcept] QMainWindow::~QMainWindow()

Destruye la ventana principal.

void QMainWindow::addDockWidget(Qt::DockWidgetArea area, QDockWidget *dockwidget)

Añade el dockwidget dado al area especificado.

void QMainWindow::addDockWidget(Qt::DockWidgetArea area, QDockWidget *dockwidget, Qt::Orientation orientation)

Añade dockwidget a area en la dirección especificada por orientation.

void QMainWindow::addToolBar(Qt::ToolBarArea area, QToolBar *toolbar)

Añade el toolbar en el area especificado en esta ventana principal. El toolbar se coloca al final del bloque actual de la barra de herramientas (es decir, de la línea). Si la ventana principal ya maneja toolbar entonces sólo moverá la barra de herramientas a area.

Véase también insertToolBar(), addToolBarBreak(), y insertToolBarBreak().

void QMainWindow::addToolBar(QToolBar *toolbar)

Equivale a llamar a addToolBar(Qt::TopToolBarArea, toolbar)

QToolBar *QMainWindow::addToolBar(const QString &title)

Crea un objeto QToolBar, estableciendo su título de ventana a title, y lo inserta en el área superior de la barra de herramientas.

Véase también setWindowTitle().

void QMainWindow::addToolBarBreak(Qt::ToolBarArea area = Qt::TopToolBarArea)

Añade una barra de herramientas a area después de todos los demás objetos presentes.

QWidget *QMainWindow::centralWidget() const

Devuelve el widget central de la ventana principal. Esta función devuelve nullptr si no se ha establecido el widget central.

Véase también setCentralWidget().

[override virtual protected] void QMainWindow::contextMenuEvent(QContextMenuEvent *event)

Reimplementa: QWidget::contextMenuEvent(QContextMenuEvent *event).

Qt::DockWidgetArea QMainWindow::corner(Qt::Corner corner) const

Devuelve el área del widget del dock que ocupa la dirección corner especificada.

Véase también setCorner().

[virtual] QMenu *QMainWindow::createPopupMenu()

Devuelve un menú emergente que contiene entradas comprobables para las barras de herramientas y los widgets del dock presentes en la ventana principal. Si no hay barras de herramientas ni widgets acoplables, esta función devuelve nullptr.

Por defecto, esta función es invocada por la ventana principal cuando el usuario activa un menú contextual, normalmente haciendo clic con el botón derecho del ratón sobre una barra de herramientas o un widget del dock.

Si desea crear un menú emergente personalizado, reimplemente esta función y devuelva un menú emergente recién creado. La propiedad del menú emergente se transfiere a la persona que realiza la llamada.

Véase también addDockWidget(), addToolBar() y menuBar().

Qt::DockWidgetArea QMainWindow::dockWidgetArea(QDockWidget *dockwidget) const

Devuelve el Qt::DockWidgetArea para dockwidget. Si no se ha añadido dockwidget a la ventana principal, esta función devuelve Qt::NoDockWidgetArea.

Véase también addDockWidget(), splitDockWidget() y Qt::DockWidgetArea.

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

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

[signal] void QMainWindow::iconSizeChanged(const QSize &iconSize)

Esta señal se emite cuando se cambia el tamaño de los iconos utilizados en la ventana. El nuevo tamaño del icono se pasa en iconSize.

Puedes conectar esta señal a otros componentes para ayudar a mantener una apariencia consistente en tu aplicación.

Véase también setIconSize().

void QMainWindow::insertToolBar(QToolBar *before, QToolBar *toolbar)

Inserta toolbar en el área ocupada por la barra de herramientas before de forma que aparezca antes que ella. Por ejemplo, en un funcionamiento normal de maquetación de izquierda a derecha, esto significa que toolbar aparecerá a la izquierda de la barra de herramientas especificada por before en un área de barra de herramientas horizontal.

Véase también insertToolBarBreak(), addToolBar() y addToolBarBreak().

void QMainWindow::insertToolBarBreak(QToolBar *before)

Inserta una barra de herramientas antes de la barra de herramientas especificada por before.

QMenuBar *QMainWindow::menuBar() const

Devuelve la barra de menús de la ventana principal. Esta función crea y devuelve una barra de menú vacía si la barra de menú no existe.

Si desea que todas las ventanas de una aplicación Mac compartan una barra de menús, no utilice esta función para crearla, porque la barra de menús creada aquí tendrá este QMainWindow como padre. En su lugar, debe crear una barra de menú que no tenga padre, que luego podrá compartir entre todas las ventanas del Mac. Cree así una barra de menú sin padre:

QMenuBar *menuBar = new QMenuBar(nullptr);

Véase también setMenuBar().

QWidget *QMainWindow::menuWidget() const

Devuelve la barra de menú de la ventana principal. Esta función devuelve null si aún no se ha construido una barra de menú.

Véase también setMenuWidget().

void QMainWindow::removeDockWidget(QDockWidget *dockwidget)

Elimina dockwidget del diseño de la ventana principal y lo oculta. Tenga en cuenta que dockwidget no se elimina.

void QMainWindow::removeToolBar(QToolBar *toolbar)

Elimina toolbar del diseño de la ventana principal y lo oculta. Tenga en cuenta que toolbar no se elimina.

void QMainWindow::removeToolBarBreak(QToolBar *before)

Elimina una barra de herramientas previamente insertada antes de la barra de herramientas especificada por before.

void QMainWindow::resizeDocks(const QList<QDockWidget *> &docks, const QList<int> &sizes, Qt::Orientation orientation)

Redimensiona los widgets del dock de la lista docks al tamaño en píxeles correspondiente de la lista sizes. Si orientation es Qt::Horizontal, ajusta la anchura, en caso contrario ajusta la altura de los widgets del dock. Los tamaños se ajustarán de forma que se respeten los tamaños máximo y mínimo y el propio QMainWindow no se redimensionará. Cualquier espacio adicional/faltante se distribuye entre los widgets según el peso relativo de los tamaños.

Ejemplo:

    resizeDocks({blueWidget, yellowWidget}, {20 , 40}, Qt::Horizontal);

Si el widget azul y el amarillo están anidados en el mismo nivel, se redimensionarán de forma que el widget amarillo sea el doble de grande que el widget azul.

Si algunos widgets están agrupados en pestañas, sólo debe especificarse un widget por grupo. Los widgets que no estén en la lista podrían modificarse para respetar las restricciones.

bool QMainWindow::restoreDockWidget(QDockWidget *dockwidget)

Restaura el estado de dockwidget si se ha creado después de la llamada a restoreState(). Devuelve true si el estado fue restaurado; en caso contrario devuelve false.

Véase también restoreState() y saveState().

bool QMainWindow::restoreState(const QByteArray &state, int version = 0)

Restaura el state de las barras de herramientas y dockwidgets de esta ventana principal. También restaura la configuración de las esquinas. El número version se compara con el almacenado en state. Si no coinciden, el estado de la ventana principal se deja sin cambios, y esta función devuelve false; de lo contrario, el estado se restaura, y esta función devuelve true.

Para restaurar la geometría guardada mediante QSettings, puede utilizar código como el siguiente:

void MainWindow::readSettings()
{
    QSettings settings("MyCompany", "MyApp");
    restoreGeometry(settings.value("myWidget/geometry").toByteArray());
    restoreState(settings.value("myWidget/windowState").toByteArray());
}

Véase también saveState(), QWidget::saveGeometry(), QWidget::restoreGeometry(), y restoreDockWidget().

QByteArray QMainWindow::saveState(int version = 0) const

Guarda el estado actual de las barras de herramientas y dockwidgets de esta ventana principal. Esto incluye la configuración de las esquinas que puede establecerse con setCorner(). El número version se almacena como parte de los datos.

La propiedad objectName se utiliza para identificar cada QToolBar y QDockWidget. Debes asegurarte de que esta propiedad es única para cada QToolBar y QDockWidget que añadas a la ventana principal. QMainWindow

Para restaurar el estado guardado, pase el valor de retorno y el número version a restoreState().

Para guardar la geometría cuando la ventana se cierra, puedes implementar un evento de cierre como este:

void MyMainWindow::closeEvent(QCloseEvent *event)
{
    QSettings settings("MyCompany", "MyApp");
    settings.setValue("geometry", saveGeometry());
    settings.setValue("windowState", saveState());
    QMainWindow::closeEvent(event);
}

Véase también restoreState(), QWidget::saveGeometry(), y QWidget::restoreGeometry().

void QMainWindow::setCentralWidget(QWidget *widget)

Establece el widget dado como widget central de la ventana principal.

Nota: QMainWindow toma posesión del puntero widget y lo borra en el momento oportuno.

Véase también centralWidget().

void QMainWindow::setCorner(Qt::Corner corner, Qt::DockWidgetArea area)

Establece el widget del dock dado area para que ocupe el espacio especificado corner.

Véase también corner().

void QMainWindow::setMenuBar(QMenuBar *menuBar)

Establece la barra de menús de la ventana principal en menuBar.

Nota: QMainWindow se apropia del puntero menuBar y lo borra en el momento oportuno.

Véase también menuBar().

void QMainWindow::setMenuWidget(QWidget *menuBar)

Establece la barra de menús de la ventana principal en menuBar.

QMainWindow toma posesión del puntero menuBar y lo borra en el momento oportuno.

Véase también menuWidget().

void QMainWindow::setStatusBar(QStatusBar *statusbar)

Establece la barra de estado de la ventana principal en statusbar.

Establecer la barra de estado en nullptr la eliminará de la ventana principal. Tenga en cuenta que QMainWindow toma posesión del puntero statusbar y lo elimina en el momento apropiado.

Véase también statusBar().

void QMainWindow::setTabPosition(Qt::DockWidgetAreas areas, QTabWidget::TabPosition tabPosition)

Establece la posición de la pestaña para el widget del dock areas especificado en tabPosition. Por defecto, todas las áreas dock muestran sus pestañas en la parte inferior.

Véase también tabPosition() y setTabShape().

void QMainWindow::splitDockWidget(QDockWidget *first, QDockWidget *second, Qt::Orientation orientation)

Divide el espacio cubierto por el widget de acoplamiento first en dos partes, mueve el widget de acoplamiento first a la primera parte y mueve el widget de acoplamiento second a la segunda parte.

orientation especifica cómo se divide el espacio: Una división Qt::Horizontal coloca el segundo widget dock a la derecha del primero; una división Qt::Vertical coloca el segundo widget dock debajo del primero.

Nota: si first se encuentra actualmente en un área acoplada con pestañas, second se añadirá como nueva pestaña, no como vecina de first. Esto se debe a que una sola pestaña sólo puede contener un widget acoplable.

Nota: Qt::LayoutDirection influye en el orden de los widgets acoplables en las dos partes del área dividida. Cuando se activa la dirección de maquetación de derecha a izquierda, la colocación de los widgets del dock se invierte.

Véase también tabifyDockWidget(), addDockWidget() y removeDockWidget().

QStatusBar *QMainWindow::statusBar() const

Devuelve la barra de estado de la ventana principal. Esta función crea y devuelve una barra de estado vacía si la barra de estado no existe.

Véase también setStatusBar().

QTabWidget::TabPosition QMainWindow::tabPosition(Qt::DockWidgetArea area) const

Devuelve la posición de tabulación de area.

Véase también setTabPosition() y tabShape().

[signal] void QMainWindow::tabifiedDockWidgetActivated(QDockWidget *dockWidget)

Esta señal se emite cuando el widget dock tabulado se activa seleccionando la pestaña. El widget dock activado se pasa en dockWidget.

Véase también tabifyDockWidget() y tabifiedDockWidgets().

QList<QDockWidget *> QMainWindow::tabifiedDockWidgets(QDockWidget *dockwidget) const

Devuelve los widgets del dock tabulados junto con dockwidget.

Véase también tabifyDockWidget().

void QMainWindow::tabifyDockWidget(QDockWidget *first, QDockWidget *second)

Mueve el widget acoplado second encima del widget acoplado first, creando un área acoplada con pestañas en la ventana principal.

Véase también tabifiedDockWidgets().

QWidget *QMainWindow::takeCentralWidget()

Elimina el widget central de esta ventana principal.

La propiedad del widget eliminado se pasa a la persona que llama.

Qt::ToolBarArea QMainWindow::toolBarArea(const QToolBar *toolbar) const

Devuelve el Qt::ToolBarArea para toolbar. Si no se ha añadido toolbar a la ventana principal, esta función devuelve Qt::NoToolBarArea.

Véase también addToolBar(), addToolBarBreak() y Qt::ToolBarArea.

bool QMainWindow::toolBarBreak(QToolBar *toolbar) const

Devuelve si hay una interrupción de la barra de herramientas antes de toolbar.

Véase también addToolBarBreak() y insertToolBarBreak().

[signal] void QMainWindow::toolButtonStyleChanged(Qt::ToolButtonStyle toolButtonStyle)

Esta señal se emite cuando se cambia el estilo utilizado para los botones de herramientas en la ventana. El nuevo estilo se pasa en toolButtonStyle.

Puedes conectar esta señal a otros componentes para ayudar a mantener una apariencia consistente en tu aplicación.

Véase también setToolButtonStyle().