Screen QML Type
El objeto Pantalla adjunta proporciona información sobre la Pantalla en la que se muestra un Elemento o Ventana. Más...
| Import Statement: | import QtQuick |
Propiedades adjuntas
- desktopAvailableHeight : int
- desktopAvailableWidth : int
- devicePixelRatio : real
- height : int
- manufacturer : string
- model : string
- name : string
- orientation : Qt::ScreenOrientation
- pixelDensity : real
- primaryOrientation : Qt::ScreenOrientation
- serialNumber : string
- virtualX : int
- virtualY : int
- width : int
Métodos adjuntos
- int angleBetween(Qt::ScreenOrientation a, Qt::ScreenOrientation b)
Descripción detallada
El objeto adjunto Pantalla es válido dentro de los tipos Elemento o Elemento derivado, una vez completado el componente. Dentro de estos elementos se refiere a la pantalla en la que se está mostrando el elemento.
El objeto adjunto también es válido dentro de los tipos Window o Window derivados, una vez finalizado el componente. En este caso, se refiere a la pantalla en la que se creó la ventana. Por lo general, es mejor acceder a la pantalla desde el elemento correspondiente, ya que en un ordenador multipantalla, el usuario puede arrastrar una ventana hasta una posición en la que abarque varias pantallas. En ese caso, algunos elementos estarán en una pantalla y otros en otra.
Para utilizar este tipo, necesitará importar el módulo con la siguiente línea:
import QtQuick.Window 2.2
Es una importación separada para permitirle tener un entorno QML sin acceso a las características del sistema de ventanas.
Tenga en cuenta que el tipo Screen no es válido en Component.onCompleted, porque el Item o Window no se ha mostrado en una pantalla en ese momento.
Véase también Qt Quick Ejemplos - Window y Screen.
Documentación de propiedades adjuntas
Screen.desktopAvailableHeight : int [read-only]
Contiene la altura disponible del conjunto de pantallas que componen el escritorio virtual, en píxeles, excluyendo las áreas reservadas al gestor de ventanas, como las barras de tareas y los menús del sistema. Si desea colocar una ventana en la parte inferior del escritorio, puede enlazarla de la siguiente manera:
y: Screen.desktopAvailableHeight - height
Screen.desktopAvailableWidth : int [read-only]
Contiene la anchura disponible del conjunto de pantallas que componen el escritorio virtual, en píxeles, excluyendo las áreas reservadas al gestor de ventanas, como las barras de tareas y los menús del sistema. Si desea posicionar una ventana a la derecha del escritorio, puede enlazarla de la siguiente manera:
x: Screen.desktopAvailableWidth - width
Screen.devicePixelRatio : real [read-only]
Relación entre los píxeles físicos y los píxeles independientes del dispositivo para la pantalla.
Los valores habituales son 1,0 en las pantallas normales y 2,0 en las pantallas "retina" de Apple.
Screen.height : int [read-only]
Contiene la altura de la pantalla en píxeles.
Screen.manufacturer : string [read-only]
El fabricante de la pantalla.
Screen.model : string [read-only]
El modelo de la pantalla.
Screen.name : string [read-only]
El nombre de la pantalla.
Screen.orientation : Qt::ScreenOrientation [read-only]
Contiene la orientación actual de la pantalla desde la perspectiva del sistema de ventanas.
La mayoría de los dispositivos móviles y tabletas contienen sensores de acelerómetro. El sistema de ventanas puede rotar toda la pantalla automáticamente basándose en cómo se está sujetando, o manualmente a través de la configuración para rotar un monitor de escritorio; en ese caso, esta propiedad orientation cambiará.
Véase también primaryOrientation y QWindow::contentOrientation().
Screen.pixelDensity : real [read-only]
Número de píxeles físicos por milímetro.
Screen.primaryOrientation : Qt::ScreenOrientation [read-only]
Contiene la orientación primaria de la pantalla. Si la altura de la pantalla es mayor que su anchura, entonces la orientación es Qt.PortraitOrientation; de lo contrario es Qt.LandscapeOrientation.
Si estás diseñando una aplicación que cambia su diseño dependiendo de la orientación del dispositivo, probablemente quieras usar primaryOrientation para determinar el diseño. Esto se debe a que en un ordenador de sobremesa, se puede esperar que primaryOrientation cambie cuando el usuario gira la pantalla a través del panel de control del sistema operativo, incluso si el ordenador no contiene un acelerómetro. Del mismo modo, en la mayoría de los ordenadores de mano que tienen acelerómetros, el sistema operativo girará toda la pantalla de forma automática, por lo que de nuevo verás el cambio de primaryOrientation.
Screen.serialNumber : string [read-only]
El número de serie de la pantalla.
Screen.virtualX : int [read-only]
La coordenada x de la pantalla dentro del escritorio virtual.
Screen.virtualY : int [read-only]
La coordenada y de la pantalla dentro del escritorio virtual.
Screen.width : int [read-only]
Contiene el ancho de la pantalla en píxeles.
Documentación del método adjunto
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.
