QScreen Class
Die Klasse „QScreen“ dient dazu, Bildschirmeigenschaften abzufragen. Mehr...
| Header: | #include <QScreen> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| Erbt von: | QObject |
Eigenschaften
|
|
Öffentliche Funktionen
| int | angleBetween(Qt::ScreenOrientation a, Qt::ScreenOrientation b) const |
| QRect | availableGeometry() const |
| QSize | availableSize() const |
| QRect | availableVirtualGeometry() const |
| QSize | availableVirtualSize() const |
| int | depth() const |
| qreal | devicePixelRatio() const |
| QRect | geometry() const |
| QPixmap | grabWindow(WId window = 0, int x = 0, int y = 0, int width = -1, int height = -1) |
| QPlatformScreen * | handle() const |
| bool | isLandscape(Qt::ScreenOrientation o) const |
| bool | isPortrait(Qt::ScreenOrientation o) const |
| qreal | logicalDotsPerInch() const |
| qreal | logicalDotsPerInchX() const |
| qreal | logicalDotsPerInchY() const |
| QString | manufacturer() const |
| QRect | mapBetween(Qt::ScreenOrientation a, Qt::ScreenOrientation b, const QRect &rect) const |
| QString | model() const |
| QString | name() const |
| QNativeInterface * | nativeInterface() const |
| Qt::ScreenOrientation | nativeOrientation() const |
| Qt::ScreenOrientation | orientation() const |
| qreal | physicalDotsPerInch() const |
| qreal | physicalDotsPerInchX() const |
| qreal | physicalDotsPerInchY() const |
| QSizeF | physicalSize() const |
| Qt::ScreenOrientation | primaryOrientation() const |
| qreal | refreshRate() const |
| QString | serialNumber() const |
| QSize | size() const |
| QTransform | transformBetween(Qt::ScreenOrientation a, Qt::ScreenOrientation b, const QRect &target) const |
| QRect | virtualGeometry() const |
| QScreen * | virtualSiblingAt(QPoint point) |
| QList<QScreen *> | virtualSiblings() const |
| QSize | virtualSize() const |
Signale
| void | availableGeometryChanged(const QRect &geometry) |
| void | geometryChanged(const QRect &geometry) |
| void | logicalDotsPerInchChanged(qreal dpi) |
| void | orientationChanged(Qt::ScreenOrientation orientation) |
| void | physicalDotsPerInchChanged(qreal dpi) |
| void | physicalSizeChanged(const QSizeF &size) |
| void | primaryOrientationChanged(Qt::ScreenOrientation orientation) |
| void | refreshRateChanged(qreal refreshRate) |
| void | virtualGeometryChanged(const QRect &rect) |
Ausführliche Beschreibung
Ein Hinweis zu logischen und physikalischen Punkten pro Zoll: Die physikalische DPI-Angabe basiert, sofern verfügbar, auf den tatsächlichen physikalischen Pixelgrößen und ist nützlich für die Druckvorschau sowie in anderen Fällen, in denen es wünschenswert ist, die genauen physikalischen Abmessungen der auf dem Bildschirm angezeigten Inhalte zu kennen.
Logische Punkte pro Zoll werden verwendet, um Schriftarten und Elemente der Benutzeroberfläche von Punktgrößen in Pixelgrößen umzurechnen, und können von den physikalischen Punkten pro Zoll abweichen. Die logischen Punkte pro Zoll lassen sich manchmal im Einstellungsfenster der Desktop-Umgebung vom Benutzer festlegen, damit dieser die Größen der Benutzeroberfläche und der Schriftarten in verschiedenen Anwendungen global steuern kann.
Hinweis: Sowohl die physikalische als auch die logische DPI werden in geräteunabhängigen Punkten ausgedrückt. Multiplizieren Sie den Wert mit ` QScreen::devicePixelRatio()``, um die geräteabhängige Dichte zu erhalten.
Um ein QScreen-Objekt zu erhalten, verwenden Sie ` QGuiApplication::primaryScreen()` für den primären Bildschirm oder ` QGuiApplication::screens()`, um eine Liste aller Bildschirme abzurufen.
Siehe auch QGuiApplication::primaryScreen() und QGuiApplication::screens().
Dokumentation zu den Eigenschaften
[read-only] availableGeometry : QRect
Diese Eigenschaft enthält die verfügbare Geometrie des Bildschirms in Pixeln
Die verfügbare Geometrie ist die Geometrie ohne die vom Fenstermanager reservierten Bereiche wie Taskleisten und Systemmenüs.
Beachten Sie, dass unter X11 hiermit die tatsächlich verfügbare Geometrie nur auf Systemen mit einem Monitor zurückgegeben wird und nur dann, wenn der Fenstermanager das Atom _NET_WORKAREA gesetzt hat. In allen anderen Fällen entspricht der Wert dem von ` geometry()` zurückgegebenen Wert. Dies ist eine Einschränkung in der Spezifikation des X11-Fenstermanagers.
Zugriffsfunktionen:
| QRect | availableGeometry() const |
Notifier-Signal:
| void | availableGeometryChanged(const QRect &geometry) |
[read-only] availableSize : QSize
Diese Eigenschaft enthält die verfügbare Bildschirmgröße in Pixeln
Die verfügbare Größe ist die Größe ohne die vom Fenstermanager reservierten Bereiche wie Taskleisten und Systemmenüs.
Zugriffsfunktionen:
| QSize | availableSize() const |
Notifier-Signal:
| void | availableGeometryChanged(const QRect &geometry) |
[read-only] availableVirtualGeometry : QRect
Diese Eigenschaft enthält die verfügbare Geometrie des virtuellen Desktops, zu dem dieser Bildschirm gehört
Gibt die verfügbare Geometrie des virtuellen Desktops zurück, der diesem Bildschirm entspricht.
Dies ist die Vereinigung der einzelnen verfügbaren Geometrien der virtuellen Geschwister.
Zugriffsfunktionen:
| QRect | availableVirtualGeometry() const |
Benachrichtigungssignal:
| void | virtualGeometryChanged(const QRect &rect) |
Siehe auch „ availableGeometry()“ und „ virtualSiblings()“.
[read-only] availableVirtualSize : QSize
Diese Eigenschaft gibt die verfügbare Größe des virtuellen Desktops an, zu dem dieser Bildschirm gehört
Gibt die verfügbare Pixelgröße des virtuellen Desktops zurück, der diesem Bildschirm entspricht.
Dies ist die kombinierte Größe der einzelnen verfügbaren Geometrien der virtuellen Geschwister.
Zugriffsfunktionen:
| QSize | availableVirtualSize() const |
Benachrichtigungssignal:
| void | virtualGeometryChanged(const QRect &rect) |
Siehe auch „ availableSize()“ und „ virtualSiblings()“.
[read-only] depth : const int
Diese Eigenschaft gibt die Farbtiefe des Bildschirms an
Zugriffsfunktionen:
| int | depth() const |
[read-only] devicePixelRatio : qreal
Diese Eigenschaft gibt das Verhältnis zwischen physikalischen Pixeln und geräteunabhängigen Pixeln auf dem Bildschirm an
Gibt das Verhältnis zwischen physikalischen Pixeln und geräteunabhängigen Pixeln für den Bildschirm zurück.
Diese Funktion kann einen Wert zurückgeben, der von ` QWindow::devicePixelRatio()` abweicht, beispielsweise unter Wayland bei Verwendung einer fraktionierten Skalierung oder wenn Fenstereigenschaften festgelegt sind, die die Oberflächenauflösung beeinflussen. Verwenden Sie vorzugsweise ` QWindow::devicePixelRatio()`.
Hinweis: Auf einigen Plattformen können sich das `devicePixelRatio` eines Fensters und das des Bildschirms, auf dem es angezeigt wird, unterscheiden. Verwenden Sie diese Funktion nur, wenn Sie nicht wissen, welches Fenster Sie ansprechen. Wenn Sie das Zielfenster kennen, verwenden Sie stattdessen ` QWindow::devicePixelRatio()`.
Zugriffsfunktionen:
| qreal | devicePixelRatio() const |
Notifier-Signal:
| void | physicalDotsPerInchChanged(qreal dpi) |
Siehe auch QWindow::devicePixelRatio() und QGuiApplication::devicePixelRatio().
[read-only] geometry : QRect
Diese Eigenschaft enthält die Geometrie des Bildschirms in Pixeln
Beispielsweise könnte dies „ QRect “ (0, 0, 1280, 1024) oder in einer Umgebung mit virtuellen Desktops „ QRect “ (1280, 0, 1280, 1024) zurückgeben.
Zugriffsfunktionen:
| QRect | geometry() const |
Notifier-Signal:
| void | geometryChanged(const QRect &geometry) |
[read-only] logicalDotsPerInch : qreal
Diese Eigenschaft gibt die Anzahl der logischen Punkte oder Pixel pro Zoll an
Dieser Wert kann verwendet werden, um Schriftgrößen in Pixelgrößen umzurechnen.
Es handelt sich hierbei um eine Hilfsgröße, die einfach dem Durchschnitt der Eigenschaften „ logicalDotsPerInchX “ und „ logicalDotsPerInchY “ entspricht.
Zugriffsfunktionen:
| qreal | logicalDotsPerInch() const |
Benachrichtigungssignal:
| void | logicalDotsPerInchChanged(qreal dpi) |
Siehe auch „ logicalDotsPerInchX()“ und „ logicalDotsPerInchY()“.
[read-only] logicalDotsPerInchX : qreal
Diese Eigenschaft gibt die Anzahl der logischen Punkte oder Pixel pro Zoll in horizontaler Richtung an
Dieser Wert wird verwendet, um Schriftgrößen in Pixelgrößen umzurechnen.
Zugriffsfunktionen:
| qreal | logicalDotsPerInchX() const |
Benachrichtigungssignal:
| void | logicalDotsPerInchChanged(qreal dpi) |
Siehe auch „ logicalDotsPerInchY()“.
[read-only] logicalDotsPerInchY : qreal
Diese Eigenschaft gibt die Anzahl der logischen Punkte oder Pixel pro Zoll in vertikaler Richtung an
Dieser Wert wird verwendet, um Schriftgrößen in Pixelgrößen umzurechnen.
Zugriffsfunktionen:
| qreal | logicalDotsPerInchY() const |
Benachrichtigungssignal:
| void | logicalDotsPerInchChanged(qreal dpi) |
Siehe auch ` logicalDotsPerInchX()`.
[read-only] manufacturer : const QString
Diese Eigenschaft gibt den Hersteller des Bildschirms an
Zugriffsfunktionen:
| QString | manufacturer() const |
[read-only] model : const QString
Diese Eigenschaft enthält das Modell des Bildschirms
Zugriffsfunktionen:
| QString | model() const |
[read-only] name : const QString
Diese Eigenschaft enthält eine für den Benutzer lesbare Zeichenfolge, die den Bildschirm bezeichnet
Beispielsweise entsprechen diese unter X11 den XRandr-Bildschirmnamen, typischerweise „VGA1“, „HDMI1“ usw.
Hinweis: Es ist nicht gewährleistet, dassdie für den Benutzer sichtbare Zeichenfolge mit dem Ergebnis nativer APIs übereinstimmt, und sie sollte nicht zur eindeutigen Identifizierung eines Bildschirms verwendet werden.
Zugriffsfunktionen:
| QString | name() const |
[read-only] nativeOrientation : Qt::ScreenOrientation
Diese Eigenschaft gibt die native Bildschirmausrichtung an
Die native Ausrichtung des Bildschirms ist die Ausrichtung, bei der der Logo-Aufkleber des Geräts richtig herum erscheint, oder „ Qt::PrimaryOrientation “, falls die Plattform diese Funktionalität nicht unterstützt.
Die native Ausrichtung ist eine Eigenschaft der Hardware und ändert sich nicht.
Zugriffsfunktionen:
| Qt::ScreenOrientation | nativeOrientation() const |
[read-only] orientation : Qt::ScreenOrientation
Diese Eigenschaft gibt die Bildschirmausrichtung an
Die Eigenschaft „ orientation “ gibt die Ausrichtung des Bildschirms aus Sicht des Fenstersystems an.
Die meisten Mobilgeräte und Tablet-Computer verfügen über Beschleunigungssensoren. Das Modul „ Qt Sensors “ bietet die Möglichkeit, diesen Sensor direkt auszulesen. Das Fenstersystem kann jedoch den gesamten Bildschirm automatisch entsprechend der Halteposition drehen; in diesem Fall ändert sich die Eigenschaft „ orientation “.
Zugriffsfunktionen:
| Qt::ScreenOrientation | orientation() const |
Notifier-Signal:
| void | orientationChanged(Qt::ScreenOrientation orientation) |
Siehe auch „ primaryOrientation()“ und „ QWindow::contentOrientation()“.
[read-only] physicalDotsPerInch : qreal
Diese Eigenschaft gibt die Anzahl der physikalischen Punkte oder Pixel pro Zoll an
Dieser Wert gibt die Pixeldichte auf dem Bildschirm an. Je nachdem, welche Informationen das zugrunde liegende System bereitstellt, ist der Wert möglicherweise nicht ganz genau.
Dies ist eine Hilfseigenschaft, die einfach dem Durchschnitt der Eigenschaften „ physicalDotsPerInchX “ und „ physicalDotsPerInchY “ entspricht.
Hinweis: Diephysikalische DPI wird in geräteunabhängigen Punkten angegeben. Multiplizieren Sie diesen Wert mit „ QScreen::devicePixelRatio()“, um die geräteabhängige Dichte zu erhalten.
Zugriffsfunktionen:
| qreal | physicalDotsPerInch() const |
Benachrichtigungssignal:
| void | physicalDotsPerInchChanged(qreal dpi) |
Siehe auch „ physicalDotsPerInchX()“ und „ physicalDotsPerInchY()“.
[read-only] physicalDotsPerInchX : qreal
Diese Eigenschaft gibt die Anzahl der physikalischen Punkte oder Pixel pro Zoll in horizontaler Richtung an
Dieser Wert gibt die tatsächliche horizontale Pixeldichte auf dem Bildschirm an. Je nachdem, welche Informationen das zugrunde liegende System bereitstellt, ist der Wert möglicherweise nicht ganz genau.
Hinweis: Diephysikalische DPI wird in geräteunabhängigen Punkten angegeben. Multiplizieren Sie diesen Wert mit QScreen::devicePixelRatio(), um die geräteabhängige Dichte zu erhalten.
Zugriffsfunktionen:
| qreal | physicalDotsPerInchX() const |
Benachrichtigungssignal:
| void | physicalDotsPerInchChanged(qreal dpi) |
Siehe auch physicalDotsPerInchY().
[read-only] physicalDotsPerInchY : qreal
Diese Eigenschaft gibt die Anzahl der physikalischen Punkte oder Pixel pro Zoll in vertikaler Richtung an
Dieser Wert gibt die tatsächliche vertikale Pixeldichte auf dem Bildschirm an. Je nachdem, welche Informationen das zugrunde liegende System bereitstellt, ist der Wert möglicherweise nicht ganz genau.
Hinweis: Diephysikalische DPI wird in geräteunabhängigen Punkten angegeben. Multiplizieren Sie diesen Wert mit QScreen::devicePixelRatio(), um die geräteabhängige Dichte zu erhalten.
Zugriffsfunktionen:
| qreal | physicalDotsPerInchY() const |
Benachrichtigungssignal:
| void | physicalDotsPerInchChanged(qreal dpi) |
Siehe auch physicalDotsPerInchX().
[read-only] physicalSize : QSizeF
Diese Eigenschaft enthält die physikalische Größe des Bildschirms (in Millimetern)
Die physische Größe entspricht den tatsächlichen Abmessungen des Bildschirms.
Je nachdem, welche Informationen das zugrunde liegende System bereitstellt, ist der Wert möglicherweise nicht ganz genau.
Zugriffsfunktionen:
| QSizeF | physicalSize() const |
Benachrichtigungssignal:
| void | physicalSizeChanged(const QSizeF &size) |
[read-only] primaryOrientation : Qt::ScreenOrientation
Diese Eigenschaft gibt die primäre Bildschirmausrichtung an
Die primäre Bildschirmausrichtung lautet „ Qt::LandscapeOrientation “, wenn die Breite der Bildschirmgeometrie größer oder gleich ihrer Höhe ist, andernfalls „ Qt::PortraitOrientation “. Diese Eigenschaft kann sich ändern, wenn die Bildschirmausrichtung geändert wurde (d. h. wenn das Display gedreht wurde). Das Verhalten ist jedoch plattformabhängig und kann oft in einer Anwendungsmanifestdatei festgelegt werden.
Zugriffsfunktionen:
| Qt::ScreenOrientation | primaryOrientation() const |
Notifier-Signal:
| void | primaryOrientationChanged(Qt::ScreenOrientation orientation) |
[read-only] refreshRate : qreal
Diese Eigenschaft gibt die ungefähre vertikale Bildwiederholfrequenz des Bildschirms in Hz an
Warnung: Vermeiden Sie es, die Bildwiederholfrequenz des Bildschirms zur Steuerung von Animationen über einen Timer wie z. B. ` QChronoTimer` zu verwenden. Verwenden Sie stattdessen ` QWindow::requestUpdate()`.
Zugriffsfunktionen:
| qreal | refreshRate() const |
Notifier-Signal:
| void | refreshRateChanged(qreal refreshRate) |
Siehe auch ` QWindow::requestUpdate()`.
[read-only] serialNumber : const QString
Diese Eigenschaft enthält die Seriennummer des Bildschirms
Zugriffsfunktionen:
| QString | serialNumber() const |
[read-only] size : QSize
Diese Eigenschaft gibt die Pixelauflösung des Bildschirms an
Zugriffsfunktionen:
| QSize | size() const |
Benachrichtigungssignal:
| void | geometryChanged(const QRect &geometry) |
[read-only] virtualGeometry : QRect
Diese Eigenschaft enthält die Pixelgeometrie des virtuellen Desktops, zu dem dieser Bildschirm gehört
Gibt die Pixelgeometrie des virtuellen Desktops zurück, der diesem Bildschirm entspricht.
Dies ist die Vereinigung der einzelnen Geometrien der virtuellen Geschwister.
Zugriffsfunktionen:
| QRect | virtualGeometry() const |
Benachrichtigungssignal:
| void | virtualGeometryChanged(const QRect &rect) |
Siehe auch ` virtualSiblings()`.
[read-only] virtualSize : QSize
Diese Eigenschaft enthält die Pixelgröße des virtuellen Desktops, zu dem dieser Bildschirm gehört
Gibt die Pixelgröße des virtuellen Desktops zurück, der diesem Bildschirm entspricht.
Dies ist die kombinierte Größe der einzelnen Geometrien der virtuellen Geschwister.
Zugriffsfunktionen:
| QSize | virtualSize() const |
Benachrichtigungssignal:
| void | virtualGeometryChanged(const QRect &rect) |
Siehe auch „ virtualSiblings()“.
Dokumentation der Mitgliedsfunktionen
int QScreen::angleBetween(Qt::ScreenOrientation a, Qt::ScreenOrientation b) const
Hilfsfunktion zur Berechnung des Drehwinkels, der erforderlich ist, um von der Drehung a zur Drehung b zu gelangen.
Das Ergebnis ist 0, 90, 180 oder 270.
Qt::PrimaryOrientation wird als Bildschirm primaryOrientation() interpretiert.
QPixmap QScreen::grabWindow(WId window = 0, int x = 0, int y = 0, int width = -1, int height = -1)
Erstellt und gibt eine Pixmap zurück, die durch das Erfassen des Inhalts des angegebenen window unter Berücksichtigung der Einschränkungen von QRect(x, y, width, height) erstellt wurde. Ist window gleich 0, wird der gesamte Bildschirm erfasst.
Die Argumente (x, y) geben den Versatz im Fenster an, während (width, height) den zu kopierenden Bereich festlegen. Ist width negativ, kopiert die Funktion den gesamten Inhalt bis zum rechten Rand des Fensters. Ist height negativ, kopiert die Funktion den gesamten Inhalt bis zum unteren Rand des Fensters.
Die Argumente `offset` und `size` werden in geräteunabhängigen Pixeln angegeben. Die zurückgegebene Pixmap kann größer sein als die angeforderte Größe, wenn von einem Bildschirm mit hoher DPI-Auflösung kopiert wird. Rufen Sie ` QPixmap::devicePixelRatio()` auf, um festzustellen, ob dies der Fall ist.
Die Fenstersystem-Kennung (`WId`) kann mit der Funktion ` QWidget::winId()` abgerufen werden. Der Grund für die Verwendung einer Fensterkennung anstelle eines ` QWidget` besteht darin, das Erfassen von Fenstern zu ermöglichen, die nicht Teil der Anwendung sind, sowie von Fenstersystem-Frames und Ähnlichem.
Wenn ` window ` den Wert 0 hat, ist das Verhalten plattformabhängig.
- Auf Plattformen, auf denen Koordinaten bildschirmlokal sind (Windows, X11), beziehen sich (x, y) auf den Ursprung dieses Bildschirms.
- Auf Plattformen, auf denen Koordinaten global sind (macOS), beziehen sich (x, y) auf den virtuellen Desktop. Dies erfordert, dass Aufrufer
screen->geometry().topLeft()subtrahieren, um das gleiche Ergebnis wie unter Windows zu erzielen.
Um den gesamten Bildschirm plattformübergreifend zu erfassen, verwenden Sie grabWindow(0) ohne Angabe von Koordinaten. Code, der einen Teilbereich erfasst, muss diesen Unterschied explizit berücksichtigen.
Warnung: Das Erfassen von Fenstern, die nicht Teil der Anwendung sind, wird auf Systemen wie iOS nicht unterstützt, da Sandboxing- und Sicherheitsmaßnahmen das Auslesen von Pixeln aus Fenstern verhindern, die nicht der Anwendung gehören.
Die Funktion `grabWindow()` erfasst Pixel vom Bildschirm, nicht vom Fenster, d. h., wenn sich ein anderes Fenster teilweise oder vollständig über dem von dir erfassten Fenster befindet, erhältst du auch Pixel aus dem darüberliegenden Fenster. Der Mauszeiger wird in der Regel nicht erfasst.
Hinweis zu X11: Wenn das angegebene „ window “ nicht dieselbe Tiefe wie das Root-Fenster hat und ein anderes Fenster das erfasste Fenster teilweise oder vollständig verdeckt, werden keine Pixel aus dem darüberliegenden Fenster erfasst. Der Inhalt der verdeckten Bereiche in der Pixmap ist undefiniert und nicht initialisiert.
Unter Windows Vista und höher funktioniert das Erfassen eines überlagerten Fensters, das durch Setzen des Attributs „ Qt::WA_TranslucentBackground “ erstellt wurde, nicht. Stattdessen sollte das Erfassen des Desktop-Widgets funktionieren.
Warnung: Im Allgemeinen ist das Erfassen eines Bereichs außerhalb des Bildschirms nicht sicher. Dies hängt vom zugrunde liegenden Fenstersystem ab.
QPlatformScreen *QScreen::handle() const
Rufe den Plattformbildschirm-Handle ab.
Siehe auch Qt Platform Abstraction (QPA).
bool QScreen::isLandscape(Qt::ScreenOrientation o) const
Hilfsfunktion, die „ true “ zurückgibt, wenn „ o “ entweder „landscape“ oder „inverted landscape“ ist; andernfalls wird „ false “ zurückgegeben.
Qt::PrimaryOrientation wird als die „ primaryOrientation “ des Bildschirms interpretiert ().
bool QScreen::isPortrait(Qt::ScreenOrientation o) const
Hilfsfunktion, die „ true “ zurückgibt, wenn „ o “ entweder „portrait“ oder „inverted portrait“ ist; andernfalls wird „ false “ zurückgegeben.
Qt::PrimaryOrientation wird als „ primaryOrientation()“ des Bildschirms interpretiert.
QRect QScreen::mapBetween(Qt::ScreenOrientation a, Qt::ScreenOrientation b, const QRect &rect) const
Ordnet das Rechteck zwischen zwei Bildschirmausrichtungen zu.
Dadurch werden die x- und y-Abmessungen des Rechtecks rect gespiegelt, wenn die Ausrichtung a Qt::PortraitOrientation oder Qt::InvertedPortraitOrientation lautet und die Ausrichtung b Qt::LandscapeOrientation oder Qt::InvertedLandscapeOrientation lautet, oder umgekehrt.
Qt::PrimaryOrientation wird als „ primaryOrientation()“ des Bildschirms interpretiert.
template <typename QNativeInterface> QNativeInterface *QScreen::nativeInterface() const
Gibt eine native Schnittstelle des angegebenen Typs für den Bildschirm zurück.
Diese Funktion ermöglicht den Zugriff auf plattformspezifische Funktionen von „ QScreen “, wie sie im Namespace „ QNativeInterface “ definiert sind:
Native Schnittstelle zu einem Bildschirm | |
Native Schnittstelle zu einem Bildschirm unter macOS | |
Native Schnittstelle zu einem Bildschirm unter Wayland | |
Native Schnittstelle zu einem Bildschirm |
Ist die angeforderte Schnittstelle nicht verfügbar, wird ein ` nullptr ` zurückgegeben.
[signal] void QScreen::orientationChanged(Qt::ScreenOrientation orientation)
Dieses Signal wird ausgelöst, wenn sich die Ausrichtung des Bildschirms ändert, wobei „ orientation “ als Argument übergeben wird.
Hinweis: Notifier -Signal für die Eigenschaft „ orientation “.
Siehe auch „ orientation()“.
[signal] void QScreen::primaryOrientationChanged(Qt::ScreenOrientation orientation)
Dieses Signal wird ausgelöst, wenn sich die primäre Ausrichtung des Bildschirms ändert, wobei „ orientation “ als Argument übergeben wird.
Hinweis: Notifier -Signal für die Eigenschaft ` primaryOrientation`.
Siehe auch „ primaryOrientation()“.
QTransform QScreen::transformBetween(Qt::ScreenOrientation a, Qt::ScreenOrientation b, const QRect &target) const
Hilfsfunktion zur Berechnung einer Transformation, die vom Koordinatensystem, das durch die Ausrichtung a definiert ist, in das Koordinatensystem abbildet, das durch die Ausrichtung b und die Zielabmessungen target definiert ist.
Beispiel: Wenn a Qt::Landscape, b Qt::Portrait und target QRect (0, 0, w, h) ist, führt die resultierende Transformation dazu, dass der Punkt QPoint(0, 0) auf QPoint(0, w) abgebildet wird und QPoint(h, w) auf QPoint(0, h). Somit wird das Querformat-Koordinatensystem QRect(0, 0, h, w) (mit einer Drehung um 90 Grad) in das Hochformat-Koordinatensystem QRect(0, 0, w, h) abgebildet.
Qt::PrimaryOrientation wird als Bildschirmkoordinaten primaryOrientation() interpretiert.
QScreen *QScreen::virtualSiblingAt(QPoint point)
Gibt den Bildschirm unter point innerhalb der Menge QScreen::virtualSiblings() zurück oder nullptr, falls er sich außerhalb eines Bildschirms befindet.
Die „ point “ beziehen sich auf die „ virtualGeometry()“ jedes Satzes virtueller Geschwister.
QList<QScreen *> QScreen::virtualSiblings() const
Die virtuellen Geschwister des Bildschirms abrufen.
Die virtuellen Geschwister sind die Bildschirminstanzen, die sich denselben virtuellen Desktop teilen. Sie nutzen ein gemeinsames Koordinatensystem, und Fenster können frei über diese hinweg verschoben oder positioniert werden, ohne dass sie neu erstellt werden müssen.
© 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.
