En esta página

Screen QML Type

El objeto «Screen» adjunto proporciona información sobre la pantalla en la que se muestra un elemento o una ventana. Más información...

Import Statement: import QtQuick

Propiedades asociadas

Métodos adjuntos

  • int angleBetween(Qt::ScreenOrientation a, Qt::ScreenOrientation b)

Descripción detallada

El objeto adjunto «Screen» es válido dentro de «Item» o de tipos derivados de «Item», una vez completado el componente. Dentro de estos elementos, hace referencia a la pantalla en la que se está mostrando actualmente el elemento.

El objeto «attached» también es válido dentro de «Window» o de tipos derivados de «Window», una vez completado el componente. En ese caso, hace referencia a la pantalla en la que se creó la ventana. Por lo general, es mejor acceder a la pantalla desde el «Item» correspondiente, ya que, en un ordenador de sobremesa con varias pantallas, el usuario puede arrastrar una ventana hasta una posición en la que se extienda a lo largo de varias pantallas. En ese caso, algunos «Item» estarán en una pantalla y otros en otra diferente.

Para utilizar este tipo, tendrás que importar el módulo con la siguiente línea:

import QtQuick.Window 2.2

Se trata de una importación independiente para permitirte disponer de un entorno QML sin acceso a las funciones del sistema de ventanas.

Ten en cuenta que el tipo «Screen» no es válido en `Component.onCompleted`, ya que en ese momento el «Item» o la «Window» aún no se han mostrado en ninguna pantalla.

Véase también Ejemplos de «Qt Quick »: «Window» y «Screen».

Documentación de propiedades adjuntas

Screen.desktopAvailableHeight : int [read-only attached]

Este valor indica la altura disponible del conjunto de pantallas que conforman el escritorio virtual, en píxeles, sin incluir las áreas reservadas por el gestor de ventanas, como las barras de tareas y los menús del sistema. Si quieres colocar una ventana en la parte inferior del escritorio, puedes vincularla de la siguiente manera:

y: Screen.desktopAvailableHeight - height

Screen.desktopAvailableWidth : int [read-only attached]

Este valor indica la anchura disponible del conjunto de pantallas que conforman el escritorio virtual, en píxeles, sin incluir las áreas reservadas por el gestor de ventanas, como las barras de tareas y los menús del sistema. Si quieres colocar una ventana a la derecha del escritorio, puedes vincularla de la siguiente manera:

x: Screen.desktopAvailableWidth - width

Screen.devicePixelRatio : real [read-only attached]

La relación entre los píxeles físicos y los píxeles independientes del dispositivo en la pantalla.

Los valores habituales son 1,0 en pantallas normales y 2,0 en pantallas «Retina» de Apple.

Screen.height : int [read-only attached]

Aquí se indica la altura de la pantalla en píxeles.

Screen.manufacturer : string [read-only attached]

El fabricante de la pantalla.

Screen.model : string [read-only attached]

El modelo de la pantalla.

Screen.name : string [read-only attached]

El nombre de la pantalla.

Screen.orientation : Qt::ScreenOrientation [read-only attached]

Esto indica la orientación actual de la pantalla desde la perspectiva del sistema de ventanas.

La mayoría de los dispositivos móviles y tabletas cuentan con sensores acelerómetros. El sistema de ventanas puede girar toda la pantalla automáticamente en función de cómo se sostenga el dispositivo, o manualmente a través de los ajustes para girar un monitor de escritorio; en ese caso, esta propiedad orientation cambiará.

Véase también primaryOrientation y QWindow::contentOrientation().

Screen.pixelDensity : real [read-only attached]

El número de píxeles físicos por milímetro.

Screen.primaryOrientation : Qt::ScreenOrientation [read-only attached]

Esto indica la orientación principal de la pantalla. Si la altura de la pantalla es mayor que su anchura, la orientación es Qt.PortraitOrientation; en caso contrario, es Qt.LandscapeOrientation.

Si estás diseñando una aplicación cuyo diseño cambia en función de la orientación del dispositivo, probablemente te interese utilizar `primaryOrientation` para determinar dicho diseño. Esto se debe a que, en un ordenador de sobremesa, es de esperar que `primaryOrientation` cambie cuando el usuario gire la pantalla a través del panel de control del sistema operativo, incluso si el ordenador no dispone de acelerómetro. Del mismo modo, en la mayoría de los ordenadores portátiles que sí cuentan con acelerómetros, el sistema operativo girará toda la pantalla automáticamente, por lo que, de nuevo, verás cómo cambia primaryOrientation.

Screen.serialNumber : string [read-only attached]

El número de serie de la pantalla.

Screen.virtualX : int [read-only attached]

La coordenada x de la pantalla dentro del escritorio virtual.

Screen.virtualY : int [read-only attached]

La coordenada y de la pantalla dentro del escritorio virtual.

Screen.width : int [read-only attached]

Contiene el ancho de la pantalla en píxeles.

Documentación del método adjunta

[attached] int angleBetween(Qt::ScreenOrientation a, Qt::ScreenOrientation b)

Devuelve el ángulo de rotación, en grados, entre las orientaciones de pantalla especificadas a y b.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.