Screen QML Type

Das Objekt „Screen“ liefert Informationen darüber, auf welchem Bildschirm ein Element oder ein Fenster angezeigt wird. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder
• Veraltete Mitglieder

Zugehörige Eigenschaften

• 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

Beigefügte Methoden

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

Ausführliche Beschreibung

Das angehängte Objekt „Screen“ ist innerhalb von „Item“ oder von „Item“ abgeleiteten Typen nach Abschluss der Komponentenverarbeitung gültig. Innerhalb dieser Elemente bezieht es sich auf den Bildschirm, auf dem das Element gerade angezeigt wird.

Das zugeordnete Objekt ist auch innerhalb von „Window“-Typen oder von „Window“ abgeleiteten Typen gültig, nachdem die Komponente fertiggestellt wurde. In diesem Fall bezieht es sich auf den Bildschirm, auf dem das Fenster erstellt wurde. Im Allgemeinen ist es besser, stattdessen über das entsprechende „Item“ auf den Bildschirm zuzugreifen, da der Benutzer auf einem Desktop-Computer mit mehreren Bildschirmen ein Fenster an eine Position ziehen kann, an der es sich über mehrere Bildschirme erstreckt. In diesem Fall befinden sich einige Elemente auf einem Bildschirm und andere auf einem anderen Bildschirm.

Um diesen Typ zu verwenden, müssen Sie das Modul mit der folgenden Zeile importieren:

import QtQuick.Window 2.2

Es handelt sich um einen separaten Import, damit Sie eine QML-Umgebung ohne Zugriff auf Funktionen des Fenstersystems nutzen können.

Beachten Sie, dass der Typ „Screen“ bei `Component.onCompleted` nicht gültig ist, da das `Item` oder das `Window` zu diesem Zeitpunkt noch nicht auf einem Bildschirm angezeigt wurde.

Siehe auch „Qt Quick -Beispiele – Window und Screen“.

Dokumentation zu angehängten Eigenschaften

Screen.desktopAvailableHeight : int [read-only attached]

Dieser Wert gibt die verfügbare Höhe der Bildschirmgruppe an, aus der sich der virtuelle Desktop zusammensetzt, in Pixeln, ohne die vom Fenstermanager reservierten Bereiche wie Taskleisten und Systemmenüs. Wenn Sie ein Fenster am unteren Rand des Desktops positionieren möchten, können Sie es wie folgt binden:

y: Screen.desktopAvailableHeight - height

Screen.desktopAvailableWidth : int [read-only attached]

Dieser Wert gibt die verfügbare Breite der Bildschirmgruppe an, aus der sich der virtuelle Desktop zusammensetzt, in Pixeln, ohne die vom Fenstermanager reservierten Bereiche wie Taskleisten und Systemmenüs. Wenn Sie ein Fenster am rechten Rand des Desktops positionieren möchten, können Sie es wie folgt binden:

x: Screen.desktopAvailableWidth - width

Screen.devicePixelRatio : real [read-only attached]

Das Verhältnis zwischen physischen Pixeln und geräteunabhängigen Pixeln auf dem Bildschirm.

Übliche Werte sind 1,0 bei normalen Displays und 2,0 bei Apple-„Retina“-Displays.

Screen.height : int [read-only attached]

Hier ist die Höhe des Bildschirms in Pixeln angegeben.

Screen.manufacturer : string [read-only attached]

Der Hersteller des Bildschirms.

Screen.model : string [read-only attached]

Das Modell des Bildschirms.

Screen.name : string [read-only attached]

Der Name des Bildschirms.

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

Hier wird die aktuelle Ausrichtung des Bildschirms aus Sicht des Fenstersystems angegeben.

Die meisten Mobilgeräte und Tablet-Computer verfügen über Beschleunigungssensoren. Das Fenstersystem kann den gesamten Bildschirm automatisch entsprechend der Halteposition drehen oder manuell über Einstellungen, um einen Desktop-Monitor zu drehen; in diesem Fall ändert sich die Eigenschaft „ orientation “.

Siehe auch „ primaryOrientation “ und „ QWindow::contentOrientation()“.

Screen.pixelDensity : real [read-only attached]

Die Anzahl der physikalischen Pixel pro Millimeter.

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

Hier wird die primäre Ausrichtung des Bildschirms angegeben. Ist die Höhe des Bildschirms größer als seine Breite, lautet die Ausrichtung „Qt.PortraitOrientation“; andernfalls ist sie „Qt.LandscapeOrientation“.

Wenn Sie eine Anwendung entwickeln, deren Layout sich je nach Geräteausrichtung ändert, sollten Sie wahrscheinlich `primaryOrientation` zur Bestimmung des Layouts verwenden. Der Grund dafür ist, dass sich auf einem Desktop-Computer die `primaryOrientation` ändern kann, wenn der Benutzer den Bildschirm über die Systemsteuerung des Betriebssystems dreht – selbst wenn der Computer keinen Beschleunigungssensor enthält. Ebenso dreht das Betriebssystem bei den meisten Handheld-Computern, die über Beschleunigungssensoren verfügen, den gesamten Bildschirm automatisch, sodass sich auch hier die `primaryOrientation` ändert.

Screen.serialNumber : string [read-only attached]

Die Seriennummer des Bildschirms.

Screen.virtualX : int [read-only attached]

Die x-Koordinate des Bildschirms innerhalb des virtuellen Desktops.

Screen.virtualY : int [read-only attached]

Die y-Koordinate des Bildschirms innerhalb des virtuellen Desktops.

Screen.width : int [read-only attached]

Diese enthält die Breite des Bildschirms in Pixeln.

Beigefügte Methodendokumentation

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

Gibt den Drehwinkel in Grad zwischen den angegebenen Bildschirmausrichtungen a und b zurück.