QWindow Class

Dokumentation der Mitgliedsfunktionen

[explicit] QWindow::QWindow(QScreen *targetScreen = nullptr)

Erstellt ein Fenster als oberste Ebene auf der „ targetScreen “.

Das Fenster wird erst angezeigt, wenn „ setVisible “ (true), „ show()“ oder eine ähnliche Funktion aufgerufen wird.

Siehe auch ` setScreen()`.

[explicit] QWindow::QWindow(QWindow *parent)

Erstellt ein Fenster als untergeordnetes Fenster des angegebenen Fensters „ parent “.

Das Fenster wird in das übergeordnete Fenster eingebettet, seine Koordinaten beziehen sich auf das übergeordnete Fenster.

Der Bildschirm wird vom übergeordneten Fenster geerbt.

Siehe auch ` setParent()`.

[virtual noexcept] QWindow::~QWindow()

Löscht das Fenster.

[slot] void QWindow::alert(int msec)

Löst die Anzeige einer Warnmeldung für msec Millisekunden aus. Wenn msec auf „ 0 “ gesetzt ist (Standardeinstellung), wird die Warnmeldung so lange angezeigt, bis das Fenster wieder aktiv wird. Diese Funktion hat keine Auswirkung auf ein aktives Fenster.

Im Alarmzustand signalisiert das Fenster, dass es Aufmerksamkeit erfordert, beispielsweise durch Blinken oder Auf- und Abbewegen des Eintrags in der Taskleiste.

QSize QWindow::baseSize() const

Gibt die Basisgröße des Fensters zurück.

Siehe auch „ setBaseSize()“.

[slot] bool QWindow::close()

Schließen Sie das Fenster.

Dadurch wird das Fenster geschlossen, was effektiv den Aufruf von ` destroy()` bewirkt und möglicherweise zum Beenden der Anwendung führt. Gibt bei Erfolg ` true ` zurück, andernfalls `false`, wenn ein übergeordnetes Fenster vorhanden ist (in diesem Fall sollte stattdessen das oberste Fenster geschlossen werden).

Siehe auch „ destroy()“, „ QGuiApplication::quitOnLastWindowClosed()“ und „ closeEvent()“.

[virtual protected] void QWindow::closeEvent(QCloseEvent *ev)

Überschreiben Sie diese Funktion, um Schließereignisse zu verarbeiten (ev).

Die Funktion wird aufgerufen, wenn das Schließen des Fensters angefordert wird. Rufen Sie bei diesem Ereignis QEvent::ignore() auf, wenn Sie das Schließen des Fensters verhindern möchten.

Siehe auch ` close()`.

void QWindow::create()

Weist die mit dem Fenster verbundenen Plattformressourcen zu.

An dieser Stelle wird das mit ` setFormat()` festgelegte Oberflächenformat in eine tatsächliche native Oberfläche aufgelöst. Das Fenster bleibt jedoch ausgeblendet, bis ` setVisible()` aufgerufen wird.

Beachten Sie, dass es in der Regel nicht erforderlich ist, diese Funktion direkt aufzurufen, da sie implizit von ` show()`, ` setVisible()`, ` winId()` und anderen Funktionen aufgerufen wird, die Zugriff auf die Plattformressourcen benötigen.

Rufen Sie bei Bedarf destroy() auf, um die Plattformressourcen freizugeben.

Siehe auch destroy().

QCursor QWindow::cursor() const

die Cursorform für dieses Fenster

Siehe auch setCursor() und unsetCursor().

void QWindow::destroy()

Gibt die mit diesem Fenster verbundenen nativen Plattformressourcen frei.

Siehe auch „ create()“.

qreal QWindow::devicePixelRatio() const

Gibt das Verhältnis zwischen physischen Pixeln und geräteunabhängigen Pixeln für das Fenster zurück. Dieser Wert hängt vom Bildschirm ab, auf dem sich das Fenster befindet, und kann sich ändern, wenn das Fenster verschoben wird.

Die Instanz „ QWindow “ erhält ein Ereignis vom Typ „ QEvent::DevicePixelRatioChange “, wenn sich das Gerätepixelverhältnis ändert.

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

Siehe auch QScreen::devicePixelRatio() und QEvent::DevicePixelRatioChange.

[override virtual protected] bool QWindow::event(QEvent *ev)

Umsetzt: ` QObject::event(QEvent *e)`.

Überschreiben Sie diese Funktion, um beliebige an das Fenster gesendete Ereignisse (ev) zu verarbeiten. Geben Sie „ true “ zurück, wenn das Ereignis erkannt und verarbeitet wurde.

Denken Sie daran, die Version der Basisklasse aufzurufen, wenn Sie möchten, dass Mausereignisse, Tastenereignisse, Größenänderungsereignisse usw. wie gewohnt weitergeleitet werden.

[virtual protected] void QWindow::exposeEvent(QExposeEvent *ev)

Das „expose“-Ereignis (ev) wird vom Fenstersystem ausgelöst, wenn ein Fenster zwischen dem nicht sichtbaren und dem sichtbaren Zustand wechselt.

Ein „exposed“ Fenster ist für den Benutzer potenziell sichtbar. Wenn das Fenster aus dem Bildschirmbereich verschoben, von einem anderen Fenster vollständig verdeckt, minimiert oder Ähnliches geschieht, kann diese Funktion aufgerufen werden und der Wert von ` isExposed()` kann sich auf `false` ändern. Sie können dieses Ereignis nutzen, um rechenintensive Vorgänge wie Animationen so zu beschränken, dass sie nur ausgeführt werden, wenn das Fenster sichtbar ist.

Dieses Ereignis sollte nicht zum Zeichnen verwendet werden. Um das Zeichnen zu handhaben, implementieren Sie stattdessen ` paintEvent()`.

Ein Resize-Ereignis wird immer vor dem Expose-Ereignis gesendet, wenn ein Fenster zum ersten Mal angezeigt wird.

Siehe auch „ paintEvent()“ und „ isExposed()“.

QString QWindow::filePath() const

den Dateinamen, den dieses Fenster darstellt.

Siehe auch setFilePath().

[virtual protected] void QWindow::focusInEvent(QFocusEvent *ev)

Überschreiben Sie diese Methode, um den Fokus in Ereignissen zu verarbeiten (ev).

Fokus-Ereignisse werden gesendet, wenn das Fenster den Tastaturfokus erhält.

Siehe auch focusOutEvent().

[virtual] QObject *QWindow::focusObject() const

Gibt das „ QObject “ zurück, das als endgültiger Empfänger von Ereignissen dient, die mit dem Fokus verknüpft sind, wie z. B. Tastenereignisse.

[signal] void QWindow::focusObjectChanged(QObject *object)

Dieses Signal wird ausgelöst, wenn der endgültige Empfänger von Ereignissen, die mit dem Fokus verknüpft sind, auf „ object “ geändert wird.

Siehe auch ` focusObject()`.

[virtual protected] void QWindow::focusOutEvent(QFocusEvent *ev)

Überschreiben Sie diese Funktion, um „Focus-Out“-Ereignisse zu verarbeiten (ev).

„Focus-out“-Ereignisse werden gesendet, wenn das Fenster den Tastaturfokus verliert.

Siehe auch focusInEvent().

[override virtual] QSurfaceFormat QWindow::format() const

Implementiert neu: ` QSurface::format()` const.

Gibt das tatsächliche Format dieses Fensters zurück.

Nachdem das Fenster erstellt wurde, gibt diese Funktion das tatsächliche Oberflächenformat des Fensters zurück. Es kann vom angeforderten Format abweichen, wenn das angeforderte Format von der Plattform nicht erfüllt werden konnte. Es kann sich auch um eine Obermenge handeln, beispielsweise können bestimmte Puffergrößen größer sein als angefordert.

Siehe auch setFormat(), create(), requestedFormat() und QOpenGLContext::format().

QRect QWindow::frameGeometry() const

Gibt die Geometrie des Fensters einschließlich seines Fensterrahmens zurück.

Die Geometrie bezieht sich auf die `virtualGeometry()` des jeweiligen Bildschirms.

Siehe auch ` geometry()` und ` frameMargins()`.

QMargins QWindow::frameMargins() const

Gibt die Ränder des Fensterrahmens zurück, die das Fenster umgeben.

Siehe auch „ geometry()“ und „ frameGeometry()“.

QPoint QWindow::framePosition() const

Gibt die Position der oberen linken Ecke des Fensters einschließlich des Fensterrahmens zurück.

Dies liefert denselben Wert wie ` frameGeometry()`.topLeft().

Siehe auch „ setFramePosition()“, „ geometry()“ und „ frameGeometry()“.

[static] QWindow *QWindow::fromWinId(WId id)

Erstellt eine lokale Darstellung eines Fensters, das von einem anderen Prozess oder mithilfe von nativen Bibliotheken unterhalb von Qt erstellt wurde.

Bei Angabe des Handles id zu einem nativen Fenster erstellt diese Methode ein QWindow -Objekt, das zur Darstellung des Fensters verwendet werden kann, wenn Methoden wie setParent() und setTransientParent() aufgerufen werden.

Dies kann auf Plattformen, die dies unterstützen, dazu verwendet werden, ein ` QWindow ` in ein natives Fenster einzubetten oder ein natives Fenster in ein ` QWindow` einzubetten.

Wenn fremde Fenster nicht unterstützt werden oder das Einbetten des nativen Fensters im Plattform-Plugin fehlgeschlagen ist, gibt diese Funktion ` nullptr` zurück.

Siehe auch ` setParent()`.

QRect QWindow::geometry() const

Gibt die Geometrie des Fensters zurück, wobei der Fensterrahmen unberücksichtigt bleibt.

Die Geometrie bezieht sich auf die `virtualGeometry()` des jeweiligen Bildschirms.

Siehe auch ` setGeometry()`, ` frameMargins()` und ` frameGeometry()`.

[slot] void QWindow::hide()

Blendet das Fenster aus.

Entspricht dem Aufruf von „ setVisible(false)“.

Siehe auch „ show()“ und „ setVisible()“.

[virtual protected] void QWindow::hideEvent(QHideEvent *ev)

Überschreiben Sie diese Funktion, um Ausblendereignisse zu verarbeiten (ev).

Die Funktion wird aufgerufen, wenn das Fenster im Fenstersystem angefordert hat, ausgeblendet zu werden.

QIcon QWindow::icon() const

Gibt das Symbol des Fensters im Fenstersystem zurück

Siehe auch „ setIcon“ ().

bool QWindow::isActive() const

Gibt „ true “ zurück, wenn das Fenster aktiv ist.

Dies gilt sowohl für das Fenster, das den Eingabefokus hat, als auch für Fenster, die sich in derselben übergeordneten bzw. vorübergehenden übergeordneten Kette wie das Fokusfenster befinden.

In der Regel sollten aktive Fenster aus stilistischer Sicht als aktiv erscheinen.

Um das Fenster zu ermitteln, das derzeit den Fokus hat, verwenden Sie ` QGuiApplication::focusWindow()`.

Siehe auch ` requestActivate()`.

bool QWindow::isAncestorOf(const QWindow *child, QWindow::AncestorMode mode = IncludeTransients) const

Gibt ` true ` zurück, wenn das Fenster ein Vorfahr des angegebenen ` child` ist. Wenn ` mode ` auf ` IncludeTransients` gesetzt ist, werden auch vorübergehende Eltern als Vorfahren berücksichtigt.

bool QWindow::isExposed() const

Gibt zurück, ob dieses Fenster im Fenstersystem sichtbar ist.

Wenn das Fenster nicht sichtbar ist, wird es zwar von der Anwendung angezeigt, ist aber im Fenstersystem noch nicht zu sehen; daher sollte die Anwendung Animationen und andere grafische Aktivitäten minimieren.

Bei jeder Änderung dieses Werts wird ein „ exposeEvent()“ gesendet.

Siehe auch ` exposeEvent()`.

bool QWindow::isModal() const

Gibt zurück, ob das Fenster modal ist.

Ein modales Fenster verhindert, dass andere Fenster Eingaben empfangen können.

Siehe auch „ QWindow::modality “.

bool QWindow::isTopLevel() const

Gibt zurück, ob das Fenster ein Fenster der obersten Ebene ist, d. h. kein übergeordnetes Fenster hat.

[virtual protected] void QWindow::keyPressEvent(QKeyEvent *ev)

Überschreiben Sie diese Methode, um Tastendruckereignisse zu verarbeiten (ev).

Siehe auch keyReleaseEvent().

[virtual protected] void QWindow::keyReleaseEvent(QKeyEvent *ev)

Überschreiben Sie diese Methode, um Tastenloslass-Ereignisse zu verarbeiten (ev).

Siehe auch keyPressEvent().

[slot] void QWindow::lower()

Das Fenster im Fenstersystem nach unten verschieben.

Fordert an, dass das Fenster nach unten verschoben wird, sodass es unterhalb anderer Fenster erscheint.

[since 6.0] QPointF QWindow::mapFromGlobal(const QPointF &pos) const

Konvertiert die globalen Bildschirmkoordinaten pos in Fensterkoordinaten.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch ` mapToGlobal()`.

QPoint QWindow::mapFromGlobal(const QPoint &pos) const

[since 6.0] QPointF QWindow::mapToGlobal(const QPointF &pos) const

Wandelt die Fensterkoordinaten pos in globale Bildschirmkoordinaten um. Beispielsweise würde mapToGlobal(QPointF(0,0)) die globalen Koordinaten des Pixels in der oberen linken Ecke des Fensters liefern.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch ` mapFromGlobal()`.

QPoint QWindow::mapToGlobal(const QPoint &pos) const

QRegion QWindow::mask() const

Gibt die für das Fenster festgelegte Maske zurück.

Die Maske ist ein Hinweis an das Fenstersystem, dass die Anwendung keine Maus- oder Touch-Eingaben außerhalb des angegebenen Bereichs empfangen möchte.

Siehe auch setMask().

QSize QWindow::maximumSize() const

Gibt die maximale Größe des Fensters zurück.

Siehe auch „ setMaximumSize()“.

QSize QWindow::minimumSize() const

Gibt die minimale Größe des Fensters zurück.

Siehe auch ` setMinimumSize()`.

[signal] void QWindow::modalityChanged(Qt::WindowModality modality)

Dieses Signal wird ausgelöst, wenn sich die Eigenschaft „Qwindow::modality“ auf „ modality “ ändert.

[virtual protected] void QWindow::mouseDoubleClickEvent(QMouseEvent *ev)

Überschreiben Sie diese Funktion, um Doppelklick-Ereignisse der Maus zu verarbeiten (ev).

Siehe auch mousePressEvent() und QStyleHints::mouseDoubleClickInterval().

[virtual protected] void QWindow::mouseMoveEvent(QMouseEvent *ev)

Überschreiben Sie diese Methode, um Mausbewegungsereignisse zu verarbeiten (ev).

[virtual protected] void QWindow::mousePressEvent(QMouseEvent *ev)

Überschreiben Sie diese Methode, um Mausklick-Ereignisse zu verarbeiten (ev).

Siehe auch mouseReleaseEvent().

[virtual protected] void QWindow::mouseReleaseEvent(QMouseEvent *ev)

Überschreiben Sie diese Methode, um Maus-Release-Ereignisse zu verarbeiten (ev).

Siehe auch mousePressEvent().

[virtual protected] void QWindow::moveEvent(QMoveEvent *ev)

Überschreiben Sie diese Methode, um Ereignisse beim Verschieben des Fensters zu verarbeiten (ev).

[virtual protected] bool QWindow::nativeEvent(const QByteArray &eventType, void *message, qintptr *result)

Überschreiben Sie diese Methode, um plattformabhängige Ereignisse zu verarbeiten. Es werden die Methoden „ eventType “, „ message “ und „ result “ übergeben.

Dies kann dazu führen, dass Ihre Anwendung nicht portierbar ist.

Sollte nur dann „true“ zurückgeben, wenn das Ereignis verarbeitet wurde.

[virtual protected, since 6.0] void QWindow::paintEvent(QPaintEvent *ev)

Das „Paint“-Ereignis (ev) wird vom Fenstersystem gesendet, sobald ein Bereich des Fensters neu gezeichnet werden muss, beispielsweise beim ersten Anzeigen des Fensters oder wenn Teile des Fensters durch das Verschieben eines anderen Fensters freigelegt werden.

Von der Anwendung wird erwartet, dass sie als Reaktion auf das „paint“-Ereignis das Fenster rendert, unabhängig davon, ob das Fenster gerade sichtbar ist oder nicht. Ein „paint“-Ereignis kann beispielsweise gesendet werden, bevor das Fenster sichtbar wird, um es für die Darstellung beim Benutzer vorzubereiten.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch ` exposeEvent()`.

QWindow *QWindow::parent(QWindow::AncestorMode mode = ExcludeTransients) const

Gibt das übergeordnete Fenster zurück, sofern vorhanden.

Wenn „ mode “ auf „ IncludeTransients “ gesetzt ist, wird das vorübergehende übergeordnete Fenster zurückgegeben, falls kein übergeordnetes Fenster vorhanden ist.

Ein Fenster ohne übergeordnetes Fenster wird als Fenster der obersten Ebene bezeichnet.

Siehe auch „ setParent()“.

QPoint QWindow::position() const

Gibt die Position des Fensters auf dem Desktop ohne den Fensterrahmen zurück

Siehe auch ` setPosition()`.

[slot] void QWindow::raise()

Das Fenster im Fenstersystem nach oben verschieben.

Fordert an, dass das Fenster nach oben verschoben wird, sodass es über anderen Fenstern angezeigt wird.

[slot] void QWindow::requestActivate()

Fordert an, dass das Fenster aktiviert wird, d. h. den Tastaturfokus erhält.

Siehe auch isActive() und QGuiApplication::focusWindow().

[slot] void QWindow::requestUpdate()

Plant ein „ QEvent::UpdateRequest “-Ereignis, das an dieses Fenster übermittelt werden soll.

Das Ereignis wird auf Plattformen, auf denen dies möglich ist, synchron mit der Bildschirmsynchronisation (vsync) übermittelt. Andernfalls erfolgt die Übermittlung des Ereignisses mit einer Verzögerung von höchstens 5 ms. Wenn der dem Fenster zugeordnete Bildschirm eine Bildwiederhol refresh rate von mehr als 60 Hz meldet, wird das Intervall auf einen Wert unter 5 reduziert. Die zusätzliche Zeit dient dazu, der Ereignisschleife etwas Leerlaufzeit zum Sammeln von Systemereignissen zu geben, und kann mithilfe der Umgebungsvariable `QT_QPA_UPDATE_IDLE_TIME` überschrieben werden.

Bei der Steuerung von Animationen sollte diese Funktion einmalig nach Abschluss des Zeichnungsvorgangs aufgerufen werden. Ein mehrfacher Aufruf dieser Funktion führt dazu, dass ein einzelnes Ereignis an das Fenster übermittelt wird.

Unterklassen von ` QWindow ` sollten ` event()` neu implementieren, das Ereignis abfangen und den Rendering-Code der Anwendung aufrufen, um anschließend die Implementierung der Basisklasse aufzurufen.

QSurfaceFormat QWindow::requestedFormat() const

Gibt das angeforderte Oberflächenformat dieses Fensters zurück.

Wenn das angeforderte Format von der Plattformimplementierung nicht unterstützt wurde, weicht das „requestedFormat“ vom tatsächlichen Fensterformat ab.

Dies ist der Wert, der mit ` setFormat()` festgelegt wurde.

Siehe auch „ setFormat()“ und „ format()“.

void QWindow::resize(const QSize &newSize)

Legen Sie die Größe des Fensters (ohne Fensterrahmen) auf newSize

Siehe auch size() und geometry().

void QWindow::resize(int w, int h)

Lege die Größe des Fensters – ohne Fensterrahmen – auf ein QSize fest, das aus der Breite w und der Höhe h

Informationen zur interaktiven Größenänderung von Fenstern finden Sie unter ` startSystemResize()`.

Siehe auch ` size()` und ` geometry()`.

[virtual protected] void QWindow::resizeEvent(QResizeEvent *ev)

Überschreiben Sie diese Methode, um Ereignisse zur Größenänderung zu verarbeiten (ev).

Das Resize-Ereignis wird immer dann ausgelöst, wenn die Größe des Fensters im Fenstersystem geändert wird – entweder direkt durch die Bestätigung einer Anforderung an ` setGeometry()` oder ` resize()` durch das Fenstersystem oder indirekt durch die manuelle Größenänderung des Fensters durch den Benutzer.

[since 6.9] QMargins QWindow::safeAreaMargins() const

Gibt die Ränder des sicheren Bereichs des Fensters zurück.

Der sichere Bereich stellt den Teil des Fensters dar, in dem Inhalte sicher platziert werden können, ohne dass die Gefahr besteht, dass sie von anderen UI-Elementen, wie z. B. System-UIs, verdeckt werden oder mit diesen in Konflikt geraten.

Die Ränder beziehen sich auf die interne Geometrie des Fensters, d. h. QRect(0, 0, width(), height()).

void PaintDeviceWindow::paintEvent(QPaintEvent *)
{
    QPainter painter(this);
    QRect rect(0, 0, width(), height());
    painter.fillRect(rect, QGradient::SunnyMorning);
    painter.fillRect(rect - safeAreaMargins(), QGradient::DustyGrass);
}

Diese Funktion wurde in Qt 6.9 eingeführt.

Siehe auch geometry() und safeAreaMarginsChanged().

[signal, since 6.9] void QWindow::safeAreaMarginsChanged(QMargins margins)

Dieses Signal wird ausgelöst, wenn sich die Ränder des Sicherheitsbereichs auf „ margins “ geändert haben.

Diese Funktion wurde in Qt 6.9 eingeführt.

Siehe auch „ safeAreaMargins()“.

QScreen *QWindow::screen() const

Gibt den Bildschirm zurück, auf dem das Fenster angezeigt wird, oder null, falls kein Bildschirm vorhanden ist.

Bei untergeordneten Fenstern gibt diese Funktion den Bildschirm des entsprechenden Fensters der obersten Ebene zurück.

Siehe auch „ setScreen()“ und „ QScreen::virtualSiblings()“.

[signal] void QWindow::screenChanged(QScreen *screen)

Dieses Signal wird ausgelöst, wenn sich die Eigenschaft „ screen “ eines Fensters ändert – entweder durch explizite Festlegung mit „ setScreen()“ oder automatisch, wenn der Bildschirm des Fensters entfernt wird.

void QWindow::setBaseSize(const QSize &size)

Legt die Basis size des Fensters fest.

Die Basisgröße wird zur Berechnung einer geeigneten Fenstergröße herangezogen, wenn das Fenster „ sizeIncrement()“ definiert.

Siehe auch „ setMinimumSize()“, „ setMaximumSize()“, „ setSizeIncrement()“ und „ baseSize()“.

void QWindow::setCursor(const QCursor &cursor)

Cursorform für dieses Fenster festlegen

Der Maus cursor us nimmt diese Form an, wenn er sich über diesem Fenster befindet, sofern kein eigener Cursor festgelegt wurde. Eine Auswahl nützlicher Formen finden Sie im „ list of predefined cursor objects “.

Wenn kein Cursor festgelegt wurde oder nach einem Aufruf von ` unsetCursor()`, wird der Cursor des übergeordneten Fensters verwendet.

Standardmäßig hat der Cursor die Form „ Qt::ArrowCursor “.

Einige zugrunde liegende Fensterimplementierungen setzen den Cursor zurück, wenn er ein Fenster verlässt, selbst wenn die Maus erfasst ist. Wenn Sie einen Cursor für alle Fenster festlegen möchten, auch wenn sich dieser außerhalb des Fensters befindet, sollten Sie die Funktion ` QGuiApplication::setOverrideCursor()` in Betracht ziehen.

Siehe auch „ cursor()“ und „ QGuiApplication::setOverrideCursor()“.

void QWindow::setFilePath(const QString &filePath)

Legen Sie den Dateinamen fest, den dieses Fenster darstellt.

Das Fenstersystem verwendet möglicherweise die Funktion ` filePath `, um den Pfad des Dokuments, das dieses Fenster darstellt, in der Kachelleiste anzuzeigen.

Siehe auch ` filePath()`.

void QWindow::setFlag(Qt::WindowType flag, bool on = true)

Setzt das Fenster-Flag „ flag “ für dieses Fenster, wenn „ on “ wahr ist; andernfalls wird das Flag zurückgesetzt.

Siehe auch „ setFlags()“, „ flags()“ und „ type()“.

void QWindow::setFormat(const QSurfaceFormat &format)

Legt das Oberflächen format des Fensters fest.

Das Format bestimmt Eigenschaften wie Farbtiefe, Alpha-Wert, Größe des Tiefen- und Stencil-Puffers usw. Um einem Fenster beispielsweise einen transparenten Hintergrund zu geben (vorausgesetzt, das Fenstersystem unterstützt Compositing und andere Inhalte im Fenster machen es nicht wieder undurchsichtig):

QSurfaceFormat format;
format.setAlphaBufferSize(8);
window.setFormat(format);

Das Oberflächenformat wird in der Funktion ` create()` aufgelöst. Der Aufruf dieser Funktion nach dem Aufruf von ` create()` führt nicht zu einer erneuten Auflösung des Oberflächenformats der nativen Oberfläche.

Wenn das Format nicht explizit über diese Funktion festgelegt wird, wird das von ` QSurfaceFormat::defaultFormat()` zurückgegebene Format verwendet. Das bedeutet, dass bei mehreren Fenstern einzelne Aufrufe dieser Funktion durch einen einzigen Aufruf von ` QSurfaceFormat::setDefaultFormat()` vor dem Erstellen des ersten Fensters ersetzt werden können.

Siehe auch format(), create(), destroy() und QSurfaceFormat::setDefaultFormat().

void QWindow::setFramePosition(const QPoint &point)

Legt die Position der oberen linken Ecke des Fensters (point) einschließlich des Fensterrahmens fest.

Die Position bezieht sich auf die `virtualGeometry()` des jeweiligen Bildschirms.

Siehe auch ` framePosition()`, ` setGeometry()` und ` frameGeometry()`.

[since 6.12] void QWindow::setFramePosition(int x, int y)

Setzt die Position der oberen linken Ecke des Fensters einschließlich seines Fensterrahmens auf ` x`, y

Die Position bezieht sich auf die `virtualGeometry()` des jeweiligen Bildschirms.

Diese Funktion wurde in Qt 6.12 eingeführt.

Siehe auch ` setGeometry()` und ` frameGeometry()`.

[slot] void QWindow::setGeometry(const QRect &rect)

Legt die Geometrie des Fensters (ohne den Fensterrahmen) auf „ rect “ fest.

Die Geometrie bezieht sich auf die `virtualGeometry()` des jeweiligen Bildschirms.

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        window, qOverload(&QWindow::setGeometry));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        window, [receiver = window](const QRect &rect) { receiver->setGeometry(rect); });

Siehe auch ` geometry()`.

[slot] void QWindow::setGeometry(int posx, int posy, int w, int h)

Legt die Geometrie des Fensters – ohne dessen Fensterrahmen – als Rechteck fest, das aus den Werten von „ posx “, „ posy “, „ w “ und „ h “ gebildet wird.

Die Geometrie bezieht sich auf die `virtualGeometry()` des jeweiligen Bildschirms.

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        window, qOverload(&QWindow::setGeometry));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        window, [receiver = window](int posx, int posy, int w, int h) { receiver->setGeometry(posx, posy, w, h); });

Siehe auch ` geometry()`.

void QWindow::setIcon(const QIcon &icon)

Legt das „ icon “ des Fensters im Fenstersystem fest

Das Fenstersymbol kann vom Fenstersystem beispielsweise zur Gestaltung des Fensters und/oder im Task-Umschalter verwendet werden.

Siehe auch „ icon “ () und „ setFilePath “ ().

bool QWindow::setKeyboardGrabEnabled(bool grab)

Legt fest, ob die Tastaturblockierung aktiviert sein soll oder nicht (grab).

Ist der Rückgabewert „true“, empfängt das Fenster alle Tastenereignisse, bis setKeyboardGrabEnabled(false) aufgerufen wird; andere Fenster erhalten überhaupt keine Tastenereignisse. Mausereignisse sind davon nicht betroffen. Verwenden Sie setMouseGrabEnabled(), wenn Sie diese abfangen möchten.

Siehe auch ` setMouseGrabEnabled()`.

void QWindow::setMask(const QRegion &region)

Legt die Maske des Fensters fest.

Die Maske ist ein Hinweis an das Fenstersystem, dass die Anwendung keine Maus- oder Touch-Eingaben außerhalb der angegebenen „ region “ empfangen möchte.

Der Fenstermanager kann entscheiden, ob er Bereiche des Fensters anzeigt, die nicht in der Maske enthalten sind, oder nicht; daher liegt es in der Verantwortung der Anwendung, die Bereiche, die nicht Teil der Maske sind, transparent zu machen.

Siehe auch ` mask()` ().

void QWindow::setMaximumSize(const QSize &size)

Legt die maximale Größe des Fensters fest.

Dies ist ein Hinweis an den Fenstermanager, eine Größenänderung über die angegebene Größe size hinaus zu verhindern.

Siehe auch ` setMinimumSize()` und ` maximumSize()`.

void QWindow::setMinimumSize(const QSize &size)

Legt die Mindestgröße des Fensters fest.

Dies ist ein Hinweis an den Fenstermanager, eine Größenänderung unterhalb der angegebenen Größe size zu verhindern.

Siehe auch ` setMaximumSize()` und ` minimumSize()`.

bool QWindow::setMouseGrabEnabled(bool grab)

Legt fest, ob das „Mouse Grab“ aktiviert sein soll oder nicht (grab).

Ist der Rückgabewert „true“, empfängt das Fenster alle Mausereignisse, bis setMouseGrabEnabled(false) aufgerufen wird; andere Fenster erhalten überhaupt keine Mausereignisse. Tastaturereignisse sind davon nicht betroffen. Verwenden Sie setKeyboardGrabEnabled(), wenn Sie diese abfangen möchten.

Siehe auch ` setKeyboardGrabEnabled()`.

void QWindow::setParent(QWindow *parent)

Legt das Fenster „ parent “ fest. Dadurch übernimmt das Fenstersystem die Verwaltung des Ausschnitts des Fensters, sodass es auf das Fenster „ parent “ zugeschnitten wird.

Wird „ parent “ auf „ nullptr “ gesetzt, wird das Fenster zu einem Fenster der obersten Ebene.

Ist „ parent “ ein mit „ fromWinId()“ erstelltes Fenster, wird das aktuelle Fenster in „ parent “ eingebettet, sofern die Plattform dies unterstützt.

Siehe auch parent().

void QWindow::setPosition(const QPoint &pt)

Die Position des Fensters auf dem Desktop wie folgt festlegen: pt

Die Position bezieht sich auf die `virtualGeometry()` des jeweiligen Bildschirms.

Informationen zum interaktiven Verschieben von Fenstern finden Sie unter startSystemMove(). Informationen zum interaktiven Ändern der Fenstergröße finden Sie unter startSystemResize().

Siehe auch position() und startSystemMove().

void QWindow::setPosition(int posx, int posy)

Die Position des Fensters auf dem Desktop auf „ posx “ festlegen, posy

Die Position bezieht sich auf die `virtualGeometry()` des jeweiligen Bildschirms.

Siehe auch ` position()`.

void QWindow::setScreen(QScreen *newScreen)

Legt den Bildschirm fest, auf dem das Fenster angezeigt werden soll.

Wenn das Fenster bereits erstellt wurde, wird es auf dem Bildschirm „ newScreen “ neu erstellt.

Diese Funktion funktioniert nur für Fenster der obersten Ebene.

Siehe auch ` screen()` und ` QScreen::virtualSiblings()`.

void QWindow::setSizeIncrement(const QSize &size)

Legt die Schrittweite (size) des Fensters fest.

Wenn der Benutzer die Größe des Fensters ändert, erfolgt die Anpassung in Schritten von sizeIncrement().width() Pixel in horizontaler Richtung und sizeIncrement().height() Pixel in vertikaler Richtung, wobei baseSize() als Basis dient.

Standardmäßig enthält diese Eigenschaft eine Größe mit der Breite und Höhe Null.

Das Fenstersystem unterstützt möglicherweise keine Größenschritte.

Siehe auch sizeIncrement(), setBaseSize(), setMinimumSize() und setMaximumSize().

void QWindow::setSurfaceType(QSurface::SurfaceType surfaceType)

Legt die „ surfaceType “ des Fensters fest.

Gibt an, ob das Fenster für die Rasterdarstellung mit ` QBackingStore` oder für die OpenGL-Darstellung mit ` QOpenGLContext` vorgesehen ist.

Die „ surfaceType “ wird verwendet, wenn die native Oberfläche in der Funktion „ create()“ erstellt wird. Wird diese Funktion aufgerufen, nachdem die native Oberfläche bereits erstellt wurde, müssen die Funktionen „ destroy()“ und „ create()“ aufgerufen werden, um die alte native Oberfläche freizugeben und eine neue zu erstellen.

Siehe auch „ surfaceType()“, „ QBackingStore “, „ QOpenGLContext “, „ create()“ und „ destroy()“.

void QWindow::setVulkanInstance(QVulkanInstance *instance)

Ordnet dieses Fenster der angegebenen Vulkan- instance zu.

instance muss gültig bleiben, solange diese „ QWindow “-Instanz existiert.

Siehe auch vulkanInstance().

void QWindow::setWindowState(Qt::WindowState state)

Den Bildschirmbelegungsstatus des Fensters festlegen

Der Fenster state gibt an, ob das Fenster im Fenstersystem als maximiert, minimiert, im Vollbildmodus oder im Normalmodus angezeigt wird.

Der Enum-Wert „ Qt::WindowActive “ ist kein zulässiger Parameter.

Siehe auch windowState(), showNormal(), showFullScreen(), showMinimized(), showMaximized() und setWindowStates().

void QWindow::setWindowStates(Qt::WindowStates state)

Den Bildschirmbelegungsstatus des Fensters festlegen

Die Fenster state n geben an, ob das Fenster im Fenstersystem maximiert, minimiert und/oder im Vollbildmodus angezeigt wird.

Das Fenster kann sich in einer Kombination mehrerer Zustände befinden. Ist das Fenster beispielsweise sowohl minimiert als auch maximiert, wird es minimiert angezeigt; ein Klick auf den Eintrag in der Taskleiste stellt jedoch den maximierten Zustand wieder her.

Der Enum-Wert „ Qt::WindowActive “ sollte nicht gesetzt werden.

Siehe auch windowStates(), showNormal(), showFullScreen(), showMinimized() und showMaximized().

[slot] void QWindow::show()

Zeigt das Fenster an.

Bei untergeordneten Fenstern entspricht dies dem Aufruf von ` showNormal()`. Andernfalls entspricht dies dem Aufruf von ` showFullScreen()`, ` showMaximized()` oder ` showNormal()`, je nach dem Standardverhalten der Plattform für den Fenstertyp und die Flags.

Siehe auch showFullScreen(), showMaximized(), showNormal(), hide(), QStyleHints::showIsFullScreen() und flags().

[virtual protected] void QWindow::showEvent(QShowEvent *ev)

Überschreiben Sie diese Funktion, um „show“-Ereignisse zu verarbeiten (ev).

Die Funktion wird aufgerufen, wenn das Fenster angefordert hat, sichtbar gemacht zu werden.

Wird das Fenster vom Fenstersystem erfolgreich angezeigt, folgen darauf ein Resize- und ein Expose-Ereignis.

[slot] void QWindow::showFullScreen()

Zeigt das Fenster im Vollbildmodus an.

Entspricht dem Aufruf von ` setWindowStates` (Qt::WindowFullScreen) und anschließend von ` setVisible` (true).

Informationen zu plattformspezifischen Aspekten und Einschränkungen finden Sie in der Dokumentation zu ` QWidget::showFullScreen()`.

Siehe auch „ setWindowStates()“ und „ setVisible()“.

[slot] void QWindow::showMaximized()

Zeigt das Fenster in maximierter Ansicht an.

Entspricht dem Aufruf von ` setWindowStates` (Qt::WindowMaximized) und anschließend von ` setVisible(true)`.

Siehe auch ` setWindowStates()` und ` setVisible()`.

[slot] void QWindow::showMinimized()

Zeigt das Fenster minimiert an.

Entspricht dem Aufruf von ` setWindowStates` (Qt::WindowMinimized) und anschließend ` setVisible(true)`.

Siehe auch ` setWindowStates()` und ` setVisible()`.

[slot] void QWindow::showNormal()

Zeigt das Fenster im normalen Modus an, d. h. weder maximiert, minimiert noch im Vollbildmodus.

Entspricht dem Aufruf von ` setWindowStates` (Qt::WindowNoState) und anschließend ` setVisible(true)`.

Siehe auch ` setWindowStates()` und ` setVisible()`.

[override virtual] QSize QWindow::size() const

Implementiert: QSurface::size() const.

Gibt die Größe des Fensters ohne den Fensterrahmen zurück

Siehe auch ` resize()`.

QSize QWindow::sizeIncrement() const

Gibt die Schrittweite der Fenstergröße zurück.

Siehe auch „ setSizeIncrement()“.

[slot] bool QWindow::startSystemMove()

Einen systemspezifischen Verschiebungsvorgang starten

Der Aufruf dieser Methode startet auf Plattformen, die dies unterstützen, einen interaktiven Verschiebevorgang für das Fenster. Das tatsächliche Verhalten kann je nach Plattform variieren. In der Regel folgt das Fenster dabei dem Mauszeiger, bis eine Maustaste losgelassen wird.

Auf Plattformen, die dies unterstützen, wird diese Methode zum Verschieben von Fenstern gegenüber ` setPosition` bevorzugt, da sie ein naturgetreueres Look-and-Feel beim Verschieben von Fenstern ermöglicht, z. B. indem der Fenstermanager dieses Fenster an andere Fenster ausrichtet oder spezielle Anordnungs- oder Größenänderungsfunktionen mit Animationen beim Ziehen an den Bildschirmrand bietet. Darüber hinaus wird auf einigen Plattformen wie Wayland „ setPosition “ nicht unterstützt, sodass dies die einzige Möglichkeit für die Anwendung ist, ihre Position zu beeinflussen.

Gibt „true“ zurück, wenn der Vorgang vom System unterstützt wurde.

[slot] bool QWindow::startSystemResize(Qt::Edges edges)

Einen systemspezifischen Vorgang zur Größenänderung starten

Der Aufruf dieser Funktion startet auf Plattformen, die dies unterstützen, einen interaktiven Vorgang zur Größenänderung des Fensters. Das tatsächliche Verhalten kann je nach Plattform variieren. In der Regel wird das Fenster so in der Größe angepasst, dass sein Rand dem Mauszeiger folgt.

Auf Plattformen, die dies unterstützen, wird diese Methode zur Größenänderung von Fenstern gegenüber ` setGeometry` bevorzugt, da sie ein naturgetreueres Erscheinungsbild bei der Größenänderung von Fenstern ermöglicht, z. B. indem der Fenstermanager dieses Fenster an andere Fenster ausrichtet oder ein spezielles Größenänderungsverhalten mit Animationen beim Ziehen an den Bildschirmrand bietet.

edges sollte entweder eine einzelne Kante oder zwei benachbarte Kanten (eine Ecke) sein. Andere Werte sind nicht zulässig.

Gibt „true“ zurück, wenn der Vorgang vom System unterstützt wurde.

[override virtual] QSurface::SurfaceType QWindow::surfaceType() const

Implementiert neu: ` QSurface::surfaceType()` const.

Gibt den Oberflächentyp des Fensters zurück.

Siehe auch setSurfaceType().

[virtual protected] void QWindow::tabletEvent(QTabletEvent *ev)

Überschreiben Sie diese Methode, um Ereignisse beim Drücken, Bewegen und Loslassen des Tablets zu verarbeiten (ev).

Ereignisse beim Annähern und Verlassen des Bereichs werden nicht an Fenster gesendet, sondern an die Anwendungsinstanz übermittelt.

[virtual protected] void QWindow::touchEvent(QTouchEvent *ev)

Überschreiben Sie diese Methode, um Touch-Ereignisse zu verarbeiten (ev).

Qt::WindowType QWindow::type() const

Gibt den Typ des Fensters zurück.

Dies gibt den Teil der Fensterflags zurück, der angibt, ob es sich bei dem Fenster um ein Dialogfeld, einen Tooltip, ein Popup-Fenster, ein normales Fenster usw. handelt.

Siehe auch „ flags()“ und „ setFlags()“.

void QWindow::unsetCursor()

Stellt den Standard-Pfeilcursor für dieses Fenster wieder her.

QVulkanInstance *QWindow::vulkanInstance() const

Gibt die zugehörige Vulkan-Instanz zurück, sofern eine festgelegt wurde; andernfalls „ nullptr “.

Siehe auch ` setVulkanInstance()`.

[virtual protected] void QWindow::wheelEvent(QWheelEvent *ev)

Überschreiben Sie diese Methode, um Mausrad- oder andere Radereignisse zu verarbeiten (ev).

WId QWindow::winId() const

Gibt die Plattform-ID des Fensters zurück.

Auf Plattformen, auf denen diese ID nützlich sein könnte, repräsentiert der zurückgegebene Wert das Fenster innerhalb des entsprechenden Bildschirms eindeutig.

Siehe auch ` screen()`.

Qt::WindowState QWindow::windowState() const

der Bildschirmbelegungsstatus des Fensters

Siehe auch setWindowState() und windowStates().

[signal] void QWindow::windowStateChanged(Qt::WindowState windowState)

Dieses Signal wird ausgelöst, wenn sich die „ windowState “ ändert – entweder durch explizite Festlegung mit „ setWindowStates()“ oder automatisch, wenn der Benutzer auf eine der Schaltflächen in der Titelleiste klickt oder auf andere Weise.

Qt::WindowStates QWindow::windowStates() const

der Bildschirmbelegungsstatus des Fensters

Das Fenster kann sich in einer Kombination aus mehreren Zuständen befinden. Ist das Fenster beispielsweise sowohl minimiert als auch maximiert, wird es minimiert angezeigt; durch Klicken auf den Eintrag in der Taskleiste wird es jedoch wieder in den maximierten Zustand versetzt.

Siehe auch setWindowStates().