QWindow Class

Documentación de la función miembro

[explicit] QWindow::QWindow(QScreen *targetScreen = nullptr)

Crea una ventana como nivel superior en targetScreen.

La ventana no se muestra hasta que se llame a setVisible(true), show(), o similar.

Véase también setScreen().

[explicit] QWindow::QWindow(QWindow *parent)

Crea una ventana como hija de la ventana parent indicada.

La ventana se incrustará dentro de la ventana padre, sus coordenadas relativas a la ventana padre.

La pantalla se hereda del padre.

Véase también setParent().

[virtual noexcept] QWindow::~QWindow()

Destruye la ventana.

[slot] void QWindow::alert(int msec)

Hace que se muestre una alerta durante msec milisegundos. Si msec es 0 (el valor predeterminado), la alerta se muestra indefinidamente hasta que la ventana vuelve a estar activa. Esta función no tiene ningún efecto sobre una ventana activa.

En estado de alerta, la ventana indica que requiere atención, por ejemplo, parpadeando o haciendo rebotar la entrada de la barra de tareas.

QSize QWindow::baseSize() const

Devuelve el tamaño base de la ventana.

Véase también setBaseSize().

[slot] bool QWindow::close()

Cierra la ventana.

Esto cierra la ventana, llamando efectivamente a destroy(), y potencialmente abandonando la aplicación. Devuelve true en caso de éxito, false si tiene una ventana padre (en cuyo caso la ventana de nivel superior debería cerrarse en su lugar).

Véase también destroy(), QGuiApplication::quitOnLastWindowClosed(), y closeEvent().

[virtual protected] void QWindow::closeEvent(QCloseEvent *ev)

Reemplace esta función para manejar eventos de cierre (ev).

La función es llamada cuando se solicita el cierre de la ventana. Llame a QEvent::ignore() en el evento si desea evitar que la ventana se cierre.

Ver también close().

void QWindow::create()

Asigna los recursos de plataforma asociados a la ventana.

Es en este momento cuando el formato de superficie establecido mediante setFormat() se resuelve en una superficie nativa real. Sin embargo, la ventana permanece oculta hasta que se llama a setVisible().

Tenga en cuenta que normalmente no es necesario llamar a esta función directamente, ya que será llamada implícitamente por show(), setVisible(), winId(), y otras funciones que requieren acceso a los recursos de la plataforma.

Llame a destroy() para liberar los recursos de la plataforma si es necesario.

Véase también destroy().

QCursor QWindow::cursor() const

la forma del cursor para esta ventana

Véase también setCursor() y unsetCursor().

void QWindow::destroy()

Libera los recursos nativos de la plataforma asociados a esta ventana.

Véase también create().

qreal QWindow::devicePixelRatio() const

Devuelve la proporción entre píxeles físicos y píxeles independientes del dispositivo para la ventana. Este valor depende de la pantalla en la que se encuentre la ventana, y puede cambiar al mover la ventana.

La instancia QWindow recibe un evento de tipo QEvent::DevicePixelRatioChange cuando cambia la proporción de píxeles del dispositivo.

Los valores comunes son 1.0 en pantallas normales y 2.0 en pantallas Apple "retina".

Véase también QScreen::devicePixelRatio() y QEvent::DevicePixelRatioChange.

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

Reimplementa: QObject::event(QEvent *e).

Sobreescribe esto para manejar cualquier evento (ev) enviado a la ventana. Devuelve true si el evento fue reconocido y procesado.

Recuerde llamar a la versión de la clase base si desea que los eventos de ratón, teclado, redimensionamiento, etc sean enviados como siempre.

[virtual protected] void QWindow::exposeEvent(QExposeEvent *ev)

El evento de exposición (ev) es enviado por el sistema de ventanas cuando una ventana se mueve entre los estados no expuesto y expuesto.

Una ventana expuesta es potencialmente visible para el usuario. Si la ventana es movida fuera de la pantalla, es oscurecida totalmente por otra ventana, es minimizada, o similar, esta función puede ser llamada y el valor de isExposed() puede cambiar a false. Puede utilizar este evento para limitar operaciones caras como animaciones para que sólo se ejecuten cuando la ventana esté expuesta.

Este evento no debe utilizarse para pintar. Para manejar el pintado implemente paintEvent() en su lugar.

Siempre se enviará un evento de redimensionado antes del evento de exposición la primera vez que se muestre una ventana.

Ver también paintEvent() y isExposed().

QString QWindow::filePath() const

el nombre del archivo que representa esta ventana.

Véase también setFilePath().

[virtual protected] void QWindow::focusInEvent(QFocusEvent *ev)

Sobreescriba esto para manejar eventos de enfoque (ev).

Los eventos de enfoque se envían cuando la ventana recibe el enfoque del teclado.

Véase también focusOutEvent().

[virtual] QObject *QWindow::focusObject() const

Devuelve el QObject que será el receptor final de los eventos ligados al foco, como los eventos clave.

[signal] void QWindow::focusObjectChanged(QObject *object)

Esta señal se emite cuando el receptor final de eventos ligados al foco se cambia a object.

Véase también focusObject().

[virtual protected] void QWindow::focusOutEvent(QFocusEvent *ev)

Sobreescribe esto para manejar eventos de foco fuera (ev).

Los eventos de foco fuera se envían cuando la ventana pierde el foco del teclado.

Véase también focusInEvent().

[override virtual] QSurfaceFormat QWindow::format() const

Reimplementa: QSurface::format() const.

Devuelve el formato actual de esta ventana.

Una vez creada la ventana, esta función devolverá el formato real de la superficie de la ventana. Podría diferir del formato solicitado si la plataforma no pudiera cumplir el formato solicitado. También puede ser un superconjunto, por ejemplo, ciertos tamaños de búfer pueden ser mayores de lo solicitado.

Véase también setFormat(), create(), requestedFormat() y QOpenGLContext::format().

QRect QWindow::frameGeometry() const

Devuelve la geometría de la ventana, incluido su marco.

La geometría está en relación con la virtualGeometry() de su pantalla.

Véase también geometry() y frameMargins().

QMargins QWindow::frameMargins() const

Devuelve los márgenes del marco de la ventana que la rodea.

Véase también geometry() y frameGeometry().

QPoint QWindow::framePosition() const

Devuelve la posición superior izquierda de la ventana, incluyendo su marco.

Devuelve el mismo valor que frameGeometry().topLeft().

Véase también setFramePosition(), geometry() y frameGeometry().

[static] QWindow *QWindow::fromWinId(WId id)

Crea una representación local de una ventana creada por otro proceso o mediante el uso de bibliotecas nativas por debajo de Qt.

Dado el handle id a una ventana nativa, este método crea un objeto QWindow que puede utilizarse para representar la ventana al invocar métodos como setParent() y setTransientParent().

Esto puede utilizarse, en plataformas que lo soporten, para incrustar un QWindow dentro de una ventana nativa, o para incrustar una ventana nativa dentro de un QWindow.

Si las ventanas externas no están soportadas o la incrustación de la ventana nativa falló en el plugin de la plataforma, esta función devuelve nullptr.

Véase también setParent().

QRect QWindow::geometry() const

Devuelve la geometría de la ventana, excluyendo su marco.

La geometría está en relación con la virtualGeometry() de su pantalla.

Véase también setGeometry(), frameMargins() y frameGeometry().

[slot] void QWindow::hide()

Oculta la ventana.

Equivale a llamar a setVisible(false).

Véase también show() y setVisible().

[virtual protected] void QWindow::hideEvent(QHideEvent *ev)

Reemplace esta función para manejar eventos de ocultación (ev).

La función es llamada cuando la ventana ha solicitado ser ocultada en el sistema de ventanas.

QIcon QWindow::icon() const

Devuelve el icono de la ventana en el sistema de ventanas.

Véase también setIcon().

bool QWindow::isActive() const

Devuelve true si la ventana está activa.

Este es el caso de la ventana que tiene el foco de entrada, así como de las ventanas que están en la misma cadena padre / padre transitoria que la ventana de foco.

Normalmente, las ventanas activas deberían aparecer activas desde una perspectiva de estilo.

Para obtener la ventana que tiene actualmente el foco, utilice QGuiApplication::focusWindow().

Véase también requestActivate().

bool QWindow::isAncestorOf(const QWindow *child, QWindow::AncestorMode mode = IncludeTransients) const

Devuelve true si la ventana es un ancestro de la dada child. Si mode es IncludeTransients, los padres transitorios también se consideran ancestros.

bool QWindow::isExposed() const

Devuelve si esta ventana está expuesta en el sistema de ventanas.

Cuando la ventana no está expuesta, es mostrada por la aplicación pero aún no se muestra en el sistema de ventanas, por lo que la aplicación debe minimizar las animaciones y otras actividades gráficas.

Se envía un exposeEvent() cada vez que cambia este valor.

Véase también exposeEvent().

bool QWindow::isModal() const

Devuelve si la ventana es modal.

Una ventana modal impide que otras ventanas reciban información.

Véase también QWindow::modality.

bool QWindow::isTopLevel() const

Devuelve si la ventana es de nivel superior, es decir, no tiene ventana padre.

[virtual protected] void QWindow::keyPressEvent(QKeyEvent *ev)

Sobrescribir esto para manejar eventos de pulsación de teclas (ev).

Véase también keyReleaseEvent().

[virtual protected] void QWindow::keyReleaseEvent(QKeyEvent *ev)

Sobrescribe esto para manejar eventos de liberación de teclas (ev).

Véase también keyPressEvent().

[slot] void QWindow::lower()

Bajar la ventana en el sistema de ventanas.

Solicita que se baje la ventana para que aparezca debajo de otras ventanas.

[since 6.0] QPointF QWindow::mapFromGlobal(const QPointF &pos) const

Traduce la coordenada global de pantalla pos a coordenadas de ventana.

Esta función se introdujo en Qt 6.0.

Véase también mapToGlobal().

QPoint QWindow::mapFromGlobal(const QPoint &pos) const

[since 6.0] QPointF QWindow::mapToGlobal(const QPointF &pos) const

Traduce las coordenadas de la ventana pos a coordenadas globales de pantalla. Por ejemplo, mapToGlobal(QPointF(0,0)) daría las coordenadas globales del píxel superior izquierdo de la ventana.

Esta función se introdujo en Qt 6.0.

Véase también mapFromGlobal().

QPoint QWindow::mapToGlobal(const QPoint &pos) const

QRegion QWindow::mask() const

Devuelve la máscara establecida en la ventana.

La máscara es una indicación al sistema de ventanas de que la aplicación no desea recibir entradas de ratón o táctiles fuera de la región dada.

Véase también setMask().

QSize QWindow::maximumSize() const

Devuelve el tamaño máximo de la ventana.

Véase también setMaximumSize().

QSize QWindow::minimumSize() const

Devuelve el tamaño mínimo de la ventana.

Véase también setMinimumSize().

[signal] void QWindow::modalityChanged(Qt::WindowModality modality)

Esta señal se emite cuando la propiedad Qwindow::modality cambia a modality.

[virtual protected] void QWindow::mouseDoubleClickEvent(QMouseEvent *ev)

Sobreescribe esto para manejar eventos de doble click del ratón (ev).

Véase también mousePressEvent() y QStyleHints::mouseDoubleClickInterval().

[virtual protected] void QWindow::mouseMoveEvent(QMouseEvent *ev)

Sobreescribe esto para manejar eventos de movimiento del ratón (ev).

[virtual protected] void QWindow::mousePressEvent(QMouseEvent *ev)

Sobreescribe esto para manejar eventos de pulsación del ratón (ev).

Véase también mouseReleaseEvent().

[virtual protected] void QWindow::mouseReleaseEvent(QMouseEvent *ev)

Sobreescribe esto para manejar eventos de liberación del ratón (ev).

Véase también mousePressEvent().

[virtual protected] void QWindow::moveEvent(QMoveEvent *ev)

Sobreescribe esto para manejar eventos de movimiento de ventana (ev).

[virtual protected] bool QWindow::nativeEvent(const QByteArray &eventType, void *message, qintptr *result)

Sobreescriba esto para manejar eventos dependientes de la plataforma. Se le dará eventType, message y result.

Esto puede hacer que tu aplicación no sea portable.

Debería devolver true sólo si el evento fue manejado.

[virtual protected, since 6.0] void QWindow::paintEvent(QPaintEvent *ev)

El evento paint (ev) es enviado por el sistema de ventanas cada vez que un área de la ventana necesita ser repintada, por ejemplo cuando se muestra inicialmente la ventana, o debido a que partes de la ventana quedan al descubierto al mover otra ventana.

Se espera que la aplicación renderice en la ventana en respuesta al evento paint, independientemente del estado expuesto de la ventana. Por ejemplo, un evento paint puede ser enviado antes de que la ventana sea expuesta, para prepararla para ser mostrada al usuario.

Esta función se introdujo en Qt 6.0.

Véase también exposeEvent().

QWindow *QWindow::parent(QWindow::AncestorMode mode = ExcludeTransients) const

Devuelve la ventana padre, si existe.

Si mode es IncludeTransients, entonces se devuelve el padre transitorio si no hay padre.

Una ventana sin padre se conoce como ventana de nivel superior.

Véase también setParent().

QPoint QWindow::position() const

Devuelve la posición de la ventana en el escritorio excluyendo cualquier marco de ventana

Véase también setPosition().

[slot] void QWindow::raise()

Elevar la ventana en el sistema de ventanas.

Solicita que la ventana se eleve para que aparezca por encima de otras ventanas.

[slot] void QWindow::requestActivate()

Solicita que la ventana se active, es decir, que reciba el foco del teclado.

Véase también isActive() y QGuiApplication::focusWindow().

[slot] void QWindow::requestUpdate()

Programa un evento QEvent::UpdateRequest para que se envíe a esta ventana.

El evento se envía en sincronización con la pantalla vsync en las plataformas en las que esto es posible. En caso contrario, el evento se envía con un retraso máximo de 5 ms. Si la pantalla asociada a la ventana informa de un refresh rate superior a 60 Hz, el intervalo se reduce a un valor inferior a 5. El tiempo adicional está ahí para dar al bucle de eventos un poco de tiempo de inactividad para recoger los eventos del sistema, y puede ser anulado utilizando la variable de entorno QT_QPA_UPDATE_IDLE_TIME.

Cuando se manejan animaciones, esta función debe ser llamada una vez que el dibujo ha finalizado. Si se llama a esta función varias veces, se enviará un único evento a la ventana.

Las subclases de QWindow deben reimplementar event(), interceptar el evento y llamar al código de renderizado de la aplicación, luego llamar a la implementación de la clase base.

QSurfaceFormat QWindow::requestedFormat() const

Devuelve el formato de superficie solicitado para esta ventana.

Si el formato solicitado no es compatible con la implementación de la plataforma, el formato solicitado diferirá del formato real de la ventana.

Este es el valor establecido con setFormat().

Véase también setFormat() y format().

void QWindow::resize(const QSize &newSize)

establece el tamaño de la ventana, excluyendo cualquier marco de ventana, en newSize

Véase también size() y geometry().

void QWindow::resize(int w, int h)

establecer el tamaño de la ventana, excluyendo cualquier marco de ventana, a un QSize construido a partir de la anchura w y la altura. h

Para cambiar el tamaño de las ventanas de forma interactiva, consulte startSystemResize().

Véase también size() y geometry().

[virtual protected] void QWindow::resizeEvent(QResizeEvent *ev)

Sobreescriba esto para manejar eventos de redimensionamiento (ev).

El evento de redimensionamiento es llamado cada vez que la ventana es redimensionada en el sistema de ventanas, ya sea directamente a través del sistema de ventanas reconociendo una petición setGeometry() o resize(), o indirectamente a través del usuario redimensionando la ventana manualmente.

[since 6.9] QMargins QWindow::safeAreaMargins() const

Devuelve los márgenes del área segura de la ventana.

El área segura representa la parte de la ventana en la que el contenido puede colocarse de forma segura sin riesgo de ser oscurecido por, o entrar en conflicto con, otros elementos de la interfaz de usuario, como las interfaces de usuario del sistema.

Los márgenes son relativos a la geometría interna de la ventana, es decir, QRect(0, 0, width(), height()).

void PaintDeviceWindow::paintEvent(QPaintEvent *)
{
    QPainter painter(this);
    QRect rect(0, 0, width(), height());
    painter.fillRect(rect, QGradient::SunnyMorning);
    painter.fillRect(rect - safeAreaMargins(), QGradient::DustyGrass);
}

Esta función se introdujo en Qt 6.9.

Véase también geometry() y safeAreaMarginsChanged().

[signal, since 6.9] void QWindow::safeAreaMarginsChanged(QMargins margins)

Esta señal se emite cuando los márgenes del área segura cambian a margins.

Esta función se introdujo en Qt 6.9.

Véase también safeAreaMargins().

QScreen *QWindow::screen() const

Devuelve la pantalla en la que se muestra la ventana, o null si no hay ninguna.

Para las ventanas hijas, devuelve la pantalla de la ventana de nivel superior correspondiente.

Véase también setScreen() y QScreen::virtualSiblings().

[signal] void QWindow::screenChanged(QScreen *screen)

Esta señal se emite cuando cambia el screen de una ventana, ya sea porque se establece explícitamente con setScreen(), o automáticamente cuando se quita la pantalla de la ventana.

void QWindow::setBaseSize(const QSize &size)

Establece la base size de la ventana.

El tamaño base se utiliza para calcular un tamaño de ventana adecuado si la ventana define sizeIncrement().

Véase también setMinimumSize(), setMaximumSize(), setSizeIncrement() y baseSize().

void QWindow::setCursor(const QCursor &cursor)

establece la forma del cursor para esta ventana

El ratón cursor asumirá esta forma cuando esté sobre esta ventana, a menos que se establezca un cursor de anulación. Véase list of predefined cursor objects para una gama de formas útiles.

Si no se ha establecido ningún cursor, o después de una llamada a unsetCursor(), se utilizará el cursor de la ventana padre.

Por defecto, el cursor tiene la forma Qt::ArrowCursor.

Algunas implementaciones de ventanas subyacentes restablecerán el cursor si sale de una ventana aunque se agarre el ratón. Si desea tener un cursor establecido para todas las ventanas, incluso cuando se sale de la ventana, considere QGuiApplication::setOverrideCursor().

Véase también cursor() y QGuiApplication::setOverrideCursor().

void QWindow::setFilePath(const QString &filePath)

establece el nombre de archivo que esta ventana está representando.

El sistema de ventanas puede utilizar filePath para mostrar la ruta del documento que representa esta ventana en la barra de mosaicos.

Véase también filePath().

void QWindow::setFlag(Qt::WindowType flag, bool on = true)

Establece el indicador de ventana flag en esta ventana si on es verdadero; en caso contrario, borra el indicador.

Véase también setFlags(), flags() y type().

void QWindow::setFormat(const QSurfaceFormat &format)

Establece la superficie de la ventana format.

El formato determina propiedades como la profundidad de color, el alfa, la profundidad y el tamaño de la memoria intermedia del esténcil, etc. Por ejemplo, para dar a una ventana un fondo transparente (siempre que el sistema de ventanas soporte composición, y siempre que otro contenido en la ventana no la vuelva opaca de nuevo):

QSurfaceFormat format;
format.setAlphaBufferSize(8);
window.setFormat(format);

El formato de la superficie se resolverá en la función create(). Llamar a esta función después de haber llamado a create() no volverá a resolver el formato de superficie de la superficie nativa.

Cuando el formato no se establece explícitamente a través de esta función, se utilizará el formato devuelto por QSurfaceFormat::defaultFormat(). Esto significa que cuando se tienen varias ventanas, las llamadas individuales a esta función pueden sustituirse por una única llamada a QSurfaceFormat::setDefaultFormat() antes de crear la primera ventana.

Véase también format(), create(), destroy() y QSurfaceFormat::setDefaultFormat().

void QWindow::setFramePosition(const QPoint &point)

Establece la posición superior izquierda de la ventana (point) incluyendo su marco.

La posición está en relación con la virtualGeometry() de su pantalla.

Véase también framePosition(), setGeometry() y frameGeometry().

[slot] void QWindow::setGeometry(const QRect &rect)

Establece la geometría de la ventana, excluyendo su marco, en rect.

La geometría está en relación con la virtualGeometry() de su pantalla.

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        window, qOverload(&QWindow::setGeometry));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        window, [receiver = window](const QRect &rect) { receiver->setGeometry(rect); });

Véase también geometry().

[slot] void QWindow::setGeometry(int posx, int posy, int w, int h)

Establece la geometría de la ventana, excluyendo su marco, en un rectángulo construido a partir de posx, posy, w y h.

La geometría está en relación con la virtualGeometry() de su pantalla.

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        window, qOverload(&QWindow::setGeometry));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        window, [receiver = window](int posx, int posy, int w, int h) { receiver->setGeometry(posx, posy, w, h); });

Véase también geometry().

void QWindow::setIcon(const QIcon &icon)

Establece el icon de la ventana en el sistema de ventanas.

El icono de la ventana puede ser utilizado por el sistema de ventanas, por ejemplo, para decorar la ventana, y/o en el conmutador de tareas.

Véase también icon() y setFilePath().

bool QWindow::setKeyboardGrabEnabled(bool grab)

Establece si la captura de teclado debe estar habilitada o no (grab).

Si el valor devuelto es true, la ventana recibe todos los eventos de teclado hasta que se llame a setKeyboardGrabEnabled(false); las demás ventanas no reciben ningún evento de teclado. Los eventos de ratón no se ven afectados. Utilice setMouseGrabEnabled() si desea capturarlos.

Véase también setMouseGrabEnabled().

void QWindow::setMask(const QRegion &region)

Establece la máscara de la ventana.

La máscara es una indicación al sistema de ventanas de que la aplicación no desea recibir entradas de ratón o táctiles fuera de la dirección region.

El gestor de ventanas puede elegir mostrar o no las áreas de la ventana no incluidas en la máscara, por lo que es responsabilidad de la aplicación borrar a transparente las áreas que no forman parte de la máscara.

Véase también mask().

void QWindow::setMaximumSize(const QSize &size)

Establece el tamaño máximo de la ventana.

Se trata de una indicación al gestor de ventanas para que evite cambiar el tamaño por encima del especificado size.

Véase también setMinimumSize() y maximumSize().

void QWindow::setMinimumSize(const QSize &size)

Establece el tamaño mínimo de la ventana.

Se trata de una indicación al gestor de ventanas para que evite redimensionar por debajo del valor especificado size.

Véase también setMaximumSize() y minimumSize().

bool QWindow::setMouseGrabEnabled(bool grab)

Establece si el agarre del ratón debe estar habilitado o no (grab).

Si el valor devuelto es true, la ventana recibe todos los eventos de ratón hasta que se llame a setMouseGrabEnabled(false); las demás ventanas no reciben ningún evento de ratón. Los eventos de teclado no se ven afectados. Utilice setKeyboardGrabEnabled() si desea capturarlos.

Véase también setKeyboardGrabEnabled().

void QWindow::setParent(QWindow *parent)

Establece la ventana parent. Esto hará que el sistema de ventanas gestione el recorte de la ventana, por lo que se recortará a la ventana parent.

Establecer parent como nullptr hará que la ventana se convierta en una ventana de nivel superior.

Si parent es una ventana creada por fromWinId(), entonces la ventana actual se incrustará dentro de parent, si la plataforma lo soporta.

Véase también parent().

void QWindow::setPosition(const QPoint &pt)

establece la posición de la ventana en el escritorio a pt

La posición está en relación con la virtualGeometry() de su pantalla.

Para mover ventanas de forma interactiva, véase startSystemMove(). Para cambiar el tamaño de las ventanas de forma interactiva, consulte startSystemResize().

Véase también position() y startSystemMove().

void QWindow::setPosition(int posx, int posy)

establece la posición de la ventana en el escritorio en posx, posy

La posición está en relación con la virtualGeometry() de su pantalla.

Véase también position().

void QWindow::setScreen(QScreen *newScreen)

Establece la pantalla en la que debe mostrarse la ventana.

Si la ventana ha sido creada, se volverá a crear en newScreen.

Esta función sólo funciona para ventanas de nivel superior.

Véase también screen() y QScreen::virtualSiblings().

void QWindow::setSizeIncrement(const QSize &size)

Establece el incremento de tamaño (size) de la ventana.

Cuando el usuario redimensiona la ventana, el tamaño se moverá en pasos de sizeIncrement().width() píxeles horizontalmente y sizeIncrement().height() píxeles verticalmente, con baseSize() como base.

Por defecto, esta propiedad contiene un tamaño con anchura y altura cero.

Es posible que el sistema de ventanas no admita incrementos de tamaño.

Véase también sizeIncrement(), setBaseSize(), setMinimumSize() y setMaximumSize().

void QWindow::setSurfaceType(QSurface::SurfaceType surfaceType)

Establece el surfaceType de la ventana.

Especifica si la ventana está destinada al renderizado raster con QBackingStore, o al renderizado OpenGL con QOpenGLContext.

El surfaceType se utilizará cuando se cree la superficie nativa en la función create(). Llamar a esta función después de que la superficie nativa haya sido creada requiere llamar a destroy() y create() para liberar la antigua superficie nativa y crear una nueva.

Véase también surfaceType(), QBackingStore, QOpenGLContext, create(), y destroy().

void QWindow::setVulkanInstance(QVulkanInstance *instance)

Asocia esta ventana con la instancia de Vulkan instance especificada.

instance debe permanecer válida mientras exista esta instancia de QWindow.

Véase también vulkanInstance().

void QWindow::setWindowState(Qt::WindowState state)

establecer el estado de ocupación de pantalla de la ventana

La ventana state representa si la ventana aparece en el sistema de ventanas maximizada, minimizada, a pantalla completa o normal.

El valor enum Qt::WindowActive no es un parámetro aceptado.

Véase también windowState(), showNormal(), showFullScreen(), showMinimized(), showMaximized(), y setWindowStates().

void QWindow::setWindowStates(Qt::WindowStates state)

establecer el estado de ocupación de pantalla de la ventana

La ventana state representa si la ventana aparece en el sistema de ventanas maximizada, minimizada y/o a pantalla completa.

La ventana puede estar en una combinación de varios estados. Por ejemplo, si la ventana está minimizada y maximizada, la ventana aparecerá minimizada, pero al hacer clic en la entrada de la barra de tareas se restaurará al estado maximizado.

El valor enum Qt::WindowActive no debe establecerse.

Véase también windowStates(), showNormal(), showFullScreen(), showMinimized() y showMaximized().

[slot] void QWindow::show()

Muestra la ventana.

Para ventanas hijo, equivale a llamar a showNormal(). En caso contrario, equivale a llamar a showFullScreen(), showMaximized(), o showNormal(), dependiendo del comportamiento por defecto de la plataforma para el tipo de ventana y las banderas.

Véase también showFullScreen(), showMaximized(), showNormal(), hide(), QStyleHints::showIsFullScreen(), y flags().

[virtual protected] void QWindow::showEvent(QShowEvent *ev)

Reemplaza esta función para manejar eventos de mostrar (ev).

La función es llamada cuando la ventana ha solicitado ser visible.

Si la ventana es mostrada exitosamente por el sistema de ventanas, esto será seguido por un evento de redimensionamiento y un evento de exposición.

[slot] void QWindow::showFullScreen()

Muestra la ventana como pantalla completa.

Equivale a llamar a setWindowStates(Qt::WindowFullScreen) y luego a setVisible(true).

Consulte la documentación de QWidget::showFullScreen() para conocer las consideraciones y limitaciones específicas de cada plataforma.

Véase también setWindowStates() y setVisible().

[slot] void QWindow::showMaximized()

Muestra la ventana maximizada.

Equivale a llamar a setWindowStates(Qt::WindowMaximized) y luego a setVisible(true).

Véase también setWindowStates() y setVisible().

[slot] void QWindow::showMinimized()

Muestra la ventana como minimizada.

Equivale a llamar a setWindowStates(Qt::WindowMinimized) y luego a setVisible(true).

Véase también setWindowStates() y setVisible().

[slot] void QWindow::showNormal()

Muestra la ventana de forma normal, es decir, ni maximizada, ni minimizada, ni a pantalla completa.

Equivale a llamar a setWindowStates(Qt::WindowNoState) y luego a setVisible(true).

Véase también setWindowStates() y setVisible().

[override virtual] QSize QWindow::size() const

Reimplementa: QSurface::size() const.

Devuelve el tamaño de la ventana excluyendo cualquier marco de ventana.

Véase también resize().

QSize QWindow::sizeIncrement() const

Devuelve el incremento de tamaño de la ventana.

Véase también setSizeIncrement().

[slot] bool QWindow::startSystemMove()

Iniciar una operación de movimiento específica del sistema

Al llamar a esta opción, se iniciará una operación de movimiento interactiva en la ventana en las plataformas que lo admitan. El comportamiento real puede variar dependiendo de la plataforma. Normalmente, hará que la ventana siga el cursor del ratón hasta que se suelte el botón del ratón.

En las plataformas que lo soportan, este método de mover ventanas es preferible a setPosition, porque permite una apariencia más nativa de las ventanas en movimiento, por ejemplo, dejando que el gestor de ventanas ajuste esta ventana contra otras ventanas, o un comportamiento especial de mosaico o redimensionamiento con animaciones cuando se arrastra hasta el borde de la pantalla. Además, en algunas plataformas como Wayland, setPosition no está soportado, por lo que esta es la única forma en que la aplicación puede influir en su posición.

Devuelve true si la operación fue soportada por el sistema.

[slot] bool QWindow::startSystemResize(Qt::Edges edges)

Iniciar una operación de redimensionamiento específica del sistema

Esta llamada iniciará una operación interactiva de redimensionamiento de la ventana en las plataformas que lo soporten. El comportamiento real puede variar dependiendo de la plataforma. Normalmente, hará que la ventana cambie de tamaño de forma que su borde siga el cursor del ratón.

En las plataformas que lo soportan, este método de redimensionamiento de ventanas es preferible a setGeometry, porque permite un aspecto más nativo del redimensionamiento de ventanas, por ejemplo, dejando que el gestor de ventanas ajuste esta ventana contra otras ventanas, o un comportamiento especial de redimensionamiento con animaciones cuando se arrastra al borde de la pantalla.

edges debe ser un único borde, o dos bordes adyacentes (una esquina). No se permiten otros valores.

Devuelve true si la operación fue soportada por el sistema.

[override virtual] QSurface::SurfaceType QWindow::surfaceType() const

Reimplementa: QSurface::surfaceType() const.

Devuelve el tipo de superficie de la ventana.

Véase también setSurfaceType().

[virtual protected] void QWindow::tabletEvent(QTabletEvent *ev)

Anule esto para manejar los eventos de pulsar, mover y soltar de la tableta (ev).

Los eventos de entrada y salida por proximidad no se envían a las ventanas, se entregan a la instancia de la aplicación.

[virtual protected] void QWindow::touchEvent(QTouchEvent *ev)

Sobrescribir esto para manejar eventos táctiles (ev).

Qt::WindowType QWindow::type() const

Devuelve el tipo de la ventana.

Devuelve la parte de las banderas de ventana que representa si la ventana es un diálogo, tooltip, popup, ventana normal, etc.

Véase también flags() y setFlags().

void QWindow::unsetCursor()

Restaura el cursor de flecha por defecto para esta ventana.

QVulkanInstance *QWindow::vulkanInstance() const

Devuelve la instancia Vulkan asociada si se ha establecido alguna, en caso contrario nullptr.

Véase también setVulkanInstance().

[virtual protected] void QWindow::wheelEvent(QWheelEvent *ev)

Sobreescribe esto para manejar la rueda del ratón u otros eventos de rueda (ev).

WId QWindow::winId() const

Devuelve el id de plataforma de la ventana.

Para plataformas en las que este id pueda ser útil, el valor devuelto representará unívocamente la ventana dentro de la pantalla correspondiente.

Véase también screen().

Qt::WindowState QWindow::windowState() const

el estado de ocupación de la pantalla de la ventana

Véase también setWindowState() y windowStates().

[signal] void QWindow::windowStateChanged(Qt::WindowState windowState)

Esta señal se emite cuando cambia windowState, ya sea porque se ha establecido explícitamente con setWindowStates(), o automáticamente cuando el usuario hace clic en uno de los botones de la barra de título o por otros medios.

Qt::WindowStates QWindow::windowStates() const

el estado de ocupación de pantalla de la ventana

La ventana puede estar en una combinación de varios estados. Por ejemplo, si la ventana está minimizada y maximizada, aparecerá minimizada, pero al hacer clic en la entrada de la barra de tareas volverá al estado maximizado.

Véase también setWindowStates().