Screen QML Type

L'objet « Screen » associé fournit des informations sur l'écran sur lequel s'affiche un élément ou une fenêtre. En savoir plus...

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

Propriétés associées

• 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 ci-jointes

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

Description détaillée

L'objet associé Screen est valide au sein d'un Item ou d'un type dérivé de Item, une fois la création du composant terminée. Au sein de ces éléments, il fait référence à l'écran sur lequel l'élément est actuellement affiché.

L'objet « attached » est également valide au sein des types « Window » ou dérivés de « Window », une fois la création du composant terminée. 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'« Item » concerné, car sur un ordinateur de bureau multi-écrans, l'utilisateur peut faire glisser une fenêtre vers une position où elle s'étend sur plusieurs écrans. Dans ce cas, certains éléments se trouveront sur un écran, et d’autres sur un écran différent.

Pour utiliser ce type, vous devrez importer le module à l’aide de la ligne suivante :

import QtQuick.Window 2.2

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

Notez que le type « Screen » n’est pas valide dans `Component.onCompleted`, car l’élément (`Item`) ou la fenêtre (`Window`) n’a pas encore été affiché(e) à l’écran à ce moment-là.

Voir également Exemples d’Qt Quick s — Fenêtre et Écran.

Documentation sur les propriétés associées

Screen.desktopAvailableHeight : int [read-only attached]

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

y: Screen.desktopAvailableHeight - height

Screen.desktopAvailableWidth : int [read-only attached]

Cette variable contient la largeur disponible de l'ensemble des écrans qui composent le bureau virtuel, en pixels, à l'exclusion des zones réservées par le gestionnaire de fenêtres, telles que les barres des tâches et les menus système. Si vous souhaitez positionner une fenêtre à droite du bureau, vous pouvez l'ancrer de la manière suivante :

x: Screen.desktopAvailableWidth - width

Screen.devicePixelRatio : real [read-only attached]

Le rapport entre les pixels physiques et les pixels indépendants du périphérique pour l'écran.

Les valeurs courantes sont 1,0 sur les écrans normaux et 2,0 sur les écrans « Retina » d'Apple.

Screen.height : int [read-only attached]

Cette variable contient la hauteur de l'écran en pixels.

Screen.manufacturer : string [read-only attached]

Le fabricant de l'écran.

Screen.model : string [read-only attached]

Le modèle de l'écran.

Screen.name : string [read-only attached]

Le nom de l'écran.

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

Ce paramètre indique l'orientation actuelle de l'écran du point de vue du système de gestion des fenêtres.

La plupart des appareils mobiles et des tablettes sont équipés de capteurs accélérométriques. Le système de fenêtrage peut faire pivoter automatiquement l'ensemble de l'écran en fonction de la façon dont l'appareil est tenu, ou manuellement via les paramètres permettant de faire pivoter un écran d'ordinateur de bureau ; dans ce cas, la propriété orientation changera.

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

Screen.pixelDensity : real [read-only attached]

Le nombre de pixels physiques par millimètre.

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

Ce paramètre indique l'orientation principale de l'écran. Si la hauteur de l'écran est supérieure à sa largeur, l'orientation est Qt.PortraitOrientation ; dans le cas contraire, elle est Qt.LandscapeOrientation.

Si vous concevez une application dont la mise en page change en fonction de l'orientation de l'appareil, vous souhaiterez probablement utiliser `primaryOrientation` pour déterminer cette mise en page. 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 dispose pas d'accéléromètre. De même, sur la plupart des ordinateurs de poche équipés d’accéléromètres, le système d’exploitation fera pivoter automatiquement l’écran dans son ensemble ; là encore, vous constaterez donc un changement de primaryOrientation.

Screen.serialNumber : string [read-only attached]

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

Screen.virtualX : int [read-only attached]

La coordonnée x de l'écran au sein du bureau virtuel.

Screen.virtualY : int [read-only attached]

La coordonnée y de l'écran au sein du bureau virtuel.

Screen.width : int [read-only attached]

Cette propriété contient la largeur de l'écran en pixels.

Documentation de la méthode ci-jointe

[attached] 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.