Screen QML Type

L'objet Screen attached fournit des informations sur l'écran sur lequel un élément ou une fenêtre est affiché. Plus d'informations...

• Liste de tous les membres, y compris les membres hérités
• Les membres obsolètes

Propriétés de l'objet attaché

• 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éthodes attachées

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

Description détaillée

L'objet attaché Screen est valide à l'intérieur des types d'éléments ou des types dérivés d'éléments, après l'achèvement du composant. Dans ces éléments, il fait référence à l'écran sur lequel l'élément est actuellement affiché.

L'objet attaché est également valide à l'intérieur des types Window ou Window dérivés, après l'achèvement du composant. Dans ce cas, il fait référence à l'écran sur lequel la fenêtre a été créée. Il est généralement préférable d'accéder à l'écran à partir de l'élément concerné, car sur un ordinateur de bureau à plusieurs écrans, l'utilisateur peut faire glisser une fenêtre dans une position où elle s'étend sur plusieurs écrans. Dans ce cas, certains éléments se trouvent sur un écran et d'autres sur un autre.

Pour utiliser ce type de module, vous devez importer le module avec la ligne suivante :

import QtQuick.Window 2.2

Il s'agit d'une importation séparée afin de vous permettre d'avoir un environnement QML sans accès aux fonctionnalités du système de fenêtres.

Notez que le type Screen n'est pas valide à Component.onCompleted, car l'élément ou la fenêtre n'a pas été affiché sur un écran à ce moment-là.

Voir également Qt Quick Exemples - Window et Screen.

Documentation sur les propriétés attachées

Screen.desktopAvailableHeight : int [read-only]

Elle contient la hauteur disponible de l'ensemble des écrans qui composent le bureau virtuel, en pixels, à l'exclusion des zones réservées au gestionnaire de fenêtres telles que les barres de tâches et les menus système. Si vous souhaitez positionner une fenêtre en bas du bureau, vous pouvez la lier comme suit :

y: Screen.desktopAvailableHeight - height

Screen.desktopAvailableWidth : int [read-only]

Il s'agit de la largeur disponible de l'ensemble des écrans qui composent le bureau virtuel, en pixels, à l'exclusion des zones réservées au gestionnaire de fenêtres, telles que les barres de tâches et les menus système. Si vous souhaitez positionner une fenêtre à droite du bureau, vous pouvez la lier comme suit :

x: Screen.desktopAvailableWidth - width

Screen.devicePixelRatio : real [read-only]

Rapport entre les pixels physiques et les pixels indépendants de l'appareil pour l'écran.

Les valeurs courantes sont 1,0 pour les écrans normaux et 2,0 pour les écrans Apple "retina".

Screen.height : int [read-only]

Elle contient la hauteur de l'écran en pixels.

Screen.manufacturer : string [read-only]

Le fabricant de l'écran.

Screen.model : string [read-only]

Le modèle de l'écran.

Screen.name : string [read-only]

Le nom de l'écran.

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

Elle contient l'orientation actuelle de l'écran du point de vue du système de fenêtres.

La plupart des appareils mobiles et des tablettes contiennent des capteurs d'accéléromètre. Le système de fenêtrage peut faire pivoter l'ensemble de l'écran automatiquement en fonction de la manière dont il est tenu, ou manuellement via les paramètres de rotation d'un moniteur de bureau ; dans ce cas, cette propriété orientation sera modifiée.

Voir également primaryOrientation et QWindow::contentOrientation().

Screen.pixelDensity : real [read-only]

Nombre de pixels physiques par millimètre.

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

Ce champ contient l'orientation principale de l'écran. Si la hauteur de l'écran est supérieure à sa largeur, l'orientation est Qt.PortraitOrientation ; sinon, c'est Qt.LandscapeOrientation.

Si vous concevez une application dont la présentation change en fonction de l'orientation de l'appareil, vous voudrez probablement utiliser primaryOrientation pour déterminer la présentation. En effet, sur un ordinateur de bureau, vous pouvez vous attendre à ce que primaryOrientation change lorsque l'utilisateur fait pivoter l'écran via le panneau de configuration du système d'exploitation, même si l'ordinateur ne contient pas d'accéléromètre. De même, sur la plupart des ordinateurs de poche dotés d'un accéléromètre, le système d'exploitation fait pivoter l'ensemble de l'écran automatiquement, ce qui entraîne à nouveau une modification de primaryOrientation.

Screen.serialNumber : string [read-only]

Le numéro de série de l'écran.

Screen.virtualX : int [read-only]

Coordonnée x de l'écran dans le bureau virtuel.

Screen.virtualY : int [read-only]

Coordonnée y de l'écran dans le bureau virtuel.

Screen.width : int [read-only]

Elle contient la largeur de l'écran en pixels.

Documentation de la méthode attachée

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

Renvoie l'angle de rotation, en degrés, entre les orientations d'écran spécifiées a et b.