QWindow Class

Member Function Dokumentation

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

Erzeugt ein Fenster als oberste Ebene auf targetScreen.

Das Fenster wird erst angezeigt, wenn setVisible(true), show() o.ä. aufgerufen wird.

Siehe auch setScreen().

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

Erzeugt ein Fenster als Kind des angegebenen parent Fensters.

Das Fenster wird in das Elternfenster eingebettet, seine Koordinaten sind relativ zum Elternfenster.

Der Bildschirm wird vom Elternfenster geerbt.

Siehe auch setParent().

[virtual noexcept] QWindow::~QWindow()

Zerstört das Fenster.

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

Bewirkt, dass eine Warnung für msec Millisekunden angezeigt wird. Ist msec gleich 0 (Standardeinstellung), wird die Warnung auf unbestimmte Zeit angezeigt, bis das Fenster wieder aktiv wird. Diese Funktion hat keine Auswirkung auf ein aktives Fenster.

Im Alarmzustand zeigt das Fenster an, dass es Aufmerksamkeit verlangt, z. B. durch Blinken oder Wippen des Taskleisteneintrags.

QSize QWindow::baseSize() const

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

Siehe auch setBaseSize().

[slot] bool QWindow::close()

Schließen Sie das Fenster.

Dies schließt das Fenster, ruft effektiv destroy() auf und beendet möglicherweise die Anwendung. Gibt bei Erfolg true zurück, false, wenn es ein übergeordnetes Fenster hat (in diesem Fall sollte stattdessen das Fenster der obersten Ebene geschlossen werden).

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

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

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

Die Funktion wird aufgerufen, wenn das Fenster zum Schließen aufgefordert wird. Rufen Sie QEvent::ignore() für das Ereignis auf, wenn Sie verhindern wollen, dass das Fenster geschlossen wird.

Siehe auch close().

void QWindow::create()

Weist die mit dem Fenster verbundenen Plattformressourcen zu.

An diesem Punkt 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 normalerweise nicht notwendig 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 destroy() auf, um die Plattformressourcen freizugeben, falls erforderlich.

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 plattformeigenen Ressourcen 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 von dem Bildschirm ab, auf dem sich das Fenster befindet, und kann sich ändern, wenn das Fenster verschoben wird.

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

Siehe auch QScreen::devicePixelRatio().

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

Reimplements: QObject::event(QEvent *e).

Überschreibt dies, um jedes Ereignis (ev) zu behandeln, das an das Fenster gesendet wird. Gibt 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 üblich abgewickelt werden.

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

Das Exposure-Ereignis (ev) wird vom Fenstersystem gesendet, wenn ein Fenster zwischen dem nicht exponierten und dem exponierten Zustand wechselt.

Ein exponiertes Fenster ist für den Benutzer potentiell sichtbar. Wenn das Fenster aus dem Bildschirm verschoben wird, von einem anderen Fenster völlig verdeckt wird, minimiert wird oder ähnliches, kann diese Funktion aufgerufen werden und der Wert von isExposed() kann sich auf false ändern. Sie können dieses Ereignis verwenden, um teure Operationen wie Animationen nur dann auszuführen, wenn das Fenster sichtbar ist.

Dieses Ereignis sollte nicht zum Malen verwendet werden. Um das Malen zu behandeln, 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

der Dateiname, den dieses Fenster darstellt.

Siehe auch setFilePath().

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

Überschreiben Sie dies, um Fokus-Ereignisse zu behandeln (ev).

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

Siehe auch focusOutEvent().

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

Gibt die QObject zurück, die der endgültige Empfänger von Ereignissen ist, die den Fokus binden, wie z. B. Tastenereignisse.

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

Dieses Signal wird ausgegeben, wenn der Endverbraucher von Ereignissen, die an den Fokus gebunden sind, auf object geändert wird.

Siehe auch focusObject().

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

Überschreiben Sie diese Funktion, um Ereignisse zu behandeln, die den Fokus verlieren (ev).

Fokus-Out-Ereignisse werden gesendet, wenn das Fenster den Tastaturfokus verliert.

Siehe auch focusInEvent().

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

Reimplements: QSurface::format() const.

Gibt das aktuelle Format dieses Fensters zurück.

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

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

QRect QWindow::frameGeometry() const

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

Die Geometrie steht in Relation zur virtualGeometry() des Bildschirms.

Siehe auch geometry() und frameMargins().

QMargins QWindow::frameMargins() const

Liefert die Ränder des Fensterrahmens, die das Fenster umgeben.

Siehe auch geometry() und frameGeometry().

QPoint QWindow::framePosition() const

Liefert die obere linke Position des Fensters, einschließlich seines Fensterrahmens.

Dies gibt den gleichen Wert zurück wie frameGeometry().topLeft().

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

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

Erzeugt eine lokale Repräsentation eines Fensters, das von einem anderen Prozess oder durch die Verwendung nativer Bibliotheken unterhalb von Qt erstellt wurde.

Mit dem Handle id zu einem nativen Fenster erzeugt diese Methode ein QWindow Objekt, das verwendet werden kann, um das Fenster beim Aufruf von Methoden wie setParent() und setTransientParent() zu repräsentieren.

Dies kann auf Plattformen, die dies unterstützen, dazu verwendet werden, ein QWindow in ein eigenes Fenster einzubetten oder ein eigenes 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, ohne seinen Fensterrahmen.

Die Geometrie bezieht sich auf die virtualGeometry() des 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 Ausblendungsereignisse zu behandeln (ev).

Die Funktion wird aufgerufen, wenn das Fenster das Ausblenden im Fenstersystem beantragt hat.

QIcon QWindow::icon() const

Liefert das Symbol des Fensters im Windowing-System

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 der gleichen übergeordneten / transienten übergeordneten Kette wie das Fokusfenster befinden.

Normalerweise sollten aktive Fenster aus der Perspektive des Stils aktiv erscheinen.

Um das Fenster zu erhalten, das gerade 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 Vorfahre des angegebenen child ist. Wenn mode gleich IncludeTransients ist, dann werden auch vorübergehende Eltern als Vorfahren betrachtet.

bool QWindow::isExposed() const

Gibt zurück, ob dieses Fenster im Fenstersystem angezeigt wird.

Wenn das Fenster nicht exponiert ist, wird es von der Anwendung angezeigt, aber es ist immer noch nicht im Windowing-System zu sehen, so dass die Anwendung Animationen und andere grafische Aktivitäten minimieren sollte.

Jedes Mal, wenn sich dieser Wert ändert, wird eine exposeEvent() gesendet.

Siehe auch exposeEvent().

bool QWindow::isModal() const

Gibt zurück, ob das Fenster modal ist.

Ein modales Fenster verhindert, dass andere Fenster irgendwelche Eingaben erhalten.

Siehe auch QWindow::modality.

bool QWindow::isTopLevel() const

Gibt zurück, ob das Fenster übergeordnet ist, d. h. kein übergeordnetes Fenster hat.

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

Überschreiben Sie dies, um Tastendruckereignisse zu behandeln (ev).

Siehe auch keyReleaseEvent().

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

Überschreiben Sie diese Funktion, um Ereignisse der Tastenfreigabe zu behandeln (ev).

Siehe auch keyPressEvent().

[slot] void QWindow::lower()

Das Fenster im Fenstersystem absenken.

Verlangt, dass das Fenster so abgesenkt wird, dass es unter anderen Fenstern erscheint.

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

Übersetzt 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

Dies ist eine überladene Funktion.

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

Übersetzt die Fensterkoordinate pos in globale Bildschirmkoordinaten. Zum Beispiel würde mapToGlobal(QPointF(0,0)) die globalen Koordinaten des oberen linken Pixels des Fensters liefern.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch mapFromGlobal().

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

Dies ist eine überladene Funktion.

QRegion QWindow::mask() const

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

Die Maske ist ein Hinweis an das Windowing-System, dass die Anwendung keine Maus- oder Berührungseingaben 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 Mindestgröße des Fensters zurück.

Siehe auch setMinimumSize().

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

Dieses Signal wird ausgegeben, wenn die Eigenschaft Qwindow::modality auf modality wechselt.

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

Überschreiben Sie dies, um Maus-Doppelklick-Ereignisse zu behandeln (ev).

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

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

Überschreiben Sie dies, um Mausbewegungsereignisse zu behandeln (ev).

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

Überschreiben Sie dies, um Mausdruckereignisse zu behandeln (ev).

Siehe auch mouseReleaseEvent().

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

Überschreiben Sie dies, um Mausfreigabeereignisse zu behandeln (ev).

Siehe auch mousePressEvent().

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

Überschreiben Sie dies, um Fensterbewegungsereignisse zu behandeln (ev).

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

Überschreiben Sie dies, um plattformabhängige Ereignisse zu behandeln. Sie erhalten eventType, message und result.

Dies könnte Ihre Anwendung nicht portabel machen.

Sollte nur true zurückgeben, wenn das Ereignis behandelt wurde.

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

Das Malereignis (ev) wird vom Fenstersystem immer dann gesendet, wenn ein Bereich des Fensters neu gezeichnet werden muss, z. B. beim erstmaligen Anzeigen des Fensters oder wenn Teile des Fensters durch das Verschieben eines anderen Fensters freigelegt wurden.

Von der Anwendung wird erwartet, dass sie als Reaktion auf das Malereignis in das Fenster rendert, unabhängig vom Zustand des Fensters. Beispielsweise kann ein paint-Ereignis gesendet werden, bevor das Fenster freigelegt wird, um es für die Anzeige für den 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, falls vorhanden.

Wenn mode IncludeTransients ist, wird das transiente übergeordnete Fenster zurückgegeben, wenn es kein übergeordnetes Fenster gibt.

Ein Fenster ohne Elternteil wird als übergeordnetes Fenster bezeichnet.

Siehe auch setParent().

QPoint QWindow::position() const

Gibt die Position des Fensters auf dem Desktop zurück, ohne Berücksichtigung eines Fensterrahmens

Siehe auch setPosition().

[slot] void QWindow::raise()

Hebt das Fenster im Fenstersystem an.

Verlangt, dass das Fenster angehoben wird, damit es über anderen Fenstern erscheint.

[slot] void QWindow::requestActivate()

Fordert das Fenster auf, aktiviert zu werden, d. h. den Tastaturfokus zu erhalten.

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

[slot] void QWindow::requestUpdate()

Plant ein QEvent::UpdateRequest -Ereignis, das an dieses Fenster übermittelt wird.

Das Ereignis wird auf Plattformen, auf denen dies möglich ist, synchron mit der Anzeige vsync zugestellt. Andernfalls wird das Ereignis mit einer Verzögerung von höchstens 5 ms ausgelöst. Wenn der zugehörige Bildschirm des Fensters eine refresh rate von mehr als 60 Hz meldet, wird das Intervall auf einen Wert kleiner als 5 herabgesenkt. Die zusätzliche Zeit dient dazu, der Ereignisschleife ein wenig Leerlaufzeit zum Sammeln von Systemereignissen zu geben, und kann mit der Umgebungsvariablen QT_QPA_UPDATE_IDLE_TIME überschrieben werden.

Bei der Steuerung von Animationen sollte diese Funktion einmal aufgerufen werden, nachdem das Zeichnen abgeschlossen ist. Ein mehrfacher Aufruf dieser Funktion führt dazu, dass ein einziges Ereignis an das Fenster geliefert wird.

Unterklassen von QWindow sollten event() neu implementieren, das Ereignis abfangen und den Rendering-Code der Anwendung aufrufen, dann die Implementierung der Basisklasse aufrufen.

QSurfaceFormat QWindow::requestedFormat() const

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

Wenn das angeforderte Format von der Plattformimplementierung nicht unterstützt wird, weicht das angeforderteFormat vom tatsächlichen Fensterformat ab.

Dies ist der mit setFormat() gesetzte Wert.

Siehe auch setFormat() und format().

void QWindow::resize(const QSize &newSize)

setzen Sie die Größe des Fensters, ohne Berücksichtigung des Fensterrahmens, auf newSize

Siehe auch size() und geometry().

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

setzt die Größe des Fensters, ohne Berücksichtigung des Fensterrahmens, auf eine QSize, die aus Breite w und Höhe h

Zur interaktiven Größenänderung von Fenstern siehe startSystemResize().

Siehe auch size() und geometry().

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

Überschreiben Sie dies, um Größenänderungsereignisse zu behandeln (ev).

Das Resize-Ereignis wird immer dann aufgerufen, wenn die Größe des Fensters im Fenstersystem geändert wird, entweder direkt durch das Fenstersystem, das eine setGeometry() oder resize()-Anforderung bestätigt, oder indirekt durch den Benutzer, der die Größe des Fensters manuell ändert.

QScreen *QWindow::screen() const

Gibt den Bildschirm zurück, auf dem das Fenster angezeigt wird, oder null, wenn es keinen gibt.

Bei untergeordneten Fenstern wird der Bildschirm des entsprechenden Fensters der obersten Ebene zurückgegeben.

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

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

Dieses Signal wird ausgegeben, wenn sich der screen eines Fensters ändert, entweder durch explizites Setzen mit setScreen(), oder automatisch, wenn der Bildschirm des Fensters entfernt wird.

void QWindow::setBaseSize(const QSize &size)

Legt die Basisgröße size des Fensters fest.

Die Basisgröße wird zur Berechnung der richtigen Fenstergröße verwendet, wenn das Fenster sizeIncrement() definiert.

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

void QWindow::setCursor(const QCursor &cursor)

die Form des Cursors für dieses Fenster festlegen

Die Maus cursor nimmt diese Form an, wenn sie sich über diesem Fenster befindet, es sei denn, es ist ein Override-Cursor eingestellt. Siehe list of predefined cursor objects für eine Reihe von nützlichen Formen.

Wenn kein Cursor gesetzt wurde, oder nach einem Aufruf von unsetCursor(), wird der Cursor des Elternfensters verwendet.

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

Einige zugrundeliegende Fensterimplementierungen setzen den Cursor zurück, wenn er ein Fenster verlässt, auch wenn die Maus gegriffen wird. Wenn Sie einen Cursor für alle Fenster setzen wollen, auch wenn er außerhalb des Fensters ist, sollten Sie QGuiApplication::setOverrideCursor() in Betracht ziehen.

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

void QWindow::setFilePath(const QString &filePath)

den Dateinamen festlegen, den dieses Fenster darstellt.

Das Fenstersystem kann filePath verwenden, 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 Fensterflag flag für dieses Fenster, wenn on wahr ist; andernfalls wird das Flag gelöscht.

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

void QWindow::setFormat(const QSurfaceFormat &format)

Legt die Oberfläche des Fensters format fest.

Das Format bestimmt Eigenschaften wie Farbtiefe, Alpha, Tiefe und Schablonenpuffergröße usw. Zum Beispiel, um einem Fenster einen transparenten Hintergrund zu geben (vorausgesetzt, das Fenstersystem unterstützt Compositing, und vorausgesetzt, 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, nachdem create() aufgerufen wurde, löst das Oberflächenformat der nativen Oberfläche nicht erneut auf.

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 die einzelnen Aufrufe dieser Funktion durch einen einzigen Aufruf von QSurfaceFormat::setDefaultFormat() ersetzt werden können, bevor das erste Fenster erzeugt wird.

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

void QWindow::setFramePosition(const QPoint &point)

Setzt die obere linke Position des Fensters (point) einschließlich seines Fensterrahmens.

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

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

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

Setzt die Geometrie des Fensters mit Ausnahme seines Fensterrahmens auf rect.

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

Siehe auch geometry().

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

Setzt die Geometrie des Fensters, mit Ausnahme seines Fensterrahmens, auf ein Rechteck, das aus posx, posy, w und h konstruiert wird.

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

Siehe auch geometry().

void QWindow::setIcon(const QIcon &icon)

Legt das icon des Fensters im Fenstersystem fest.

Das Fenstersymbol kann vom Fenstersystem z. B. zur Dekoration des Fensters und/oder in der Aufgabenumschaltung verwendet werden.

Siehe auch icon() und setFilePath().

bool QWindow::setKeyboardGrabEnabled(bool grab)

Legt fest, ob Keyboard-Grab aktiviert werden soll oder nicht (grab).

Wenn der Rückgabewert true ist, erhält das Fenster alle Tastenereignisse, bis setKeyboardGrabEnabled(false) aufgerufen wird; andere Fenster erhalten überhaupt keine Tastenereignisse. Mausereignisse sind nicht betroffen. Verwenden Sie setMouseGrabEnabled(), wenn Sie diese abfangen wollen.

Siehe auch setMouseGrabEnabled().

void QWindow::setMask(const QRegion &region)

Setzt die Maske des Fensters.

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

Der Fenstermanager kann entscheiden, ob er die Bereiche des Fensters, die nicht in der Maske enthalten sind, anzeigen will 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 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 unter die angegebene size zu verhindern.

Siehe auch setMaximumSize() und minimumSize().

bool QWindow::setMouseGrabEnabled(bool grab)

Legt fest, ob Mousegrab aktiviert werden soll oder nicht (grab).

Wenn der Rückgabewert true ist, erhält das Fenster alle Mausereignisse, bis setMouseGrabEnabled(false) aufgerufen wird; andere Fenster erhalten überhaupt keine Mausereignisse. Tastaturereignisse sind nicht betroffen. Verwenden Sie setKeyboardGrabEnabled(), wenn Sie diese abfangen wollen.

Siehe auch setKeyboardGrabEnabled().

void QWindow::setParent(QWindow *parent)

Setzt das parent Fenster. Dies führt dazu, dass das Fenstersystem den Ausschnitt des Fensters verwaltet, so dass es an das Fenster parent angehängt wird.

Wenn parent auf nullptr gesetzt wird, wird das Fenster zu einem Fenster der obersten Ebene.

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

Siehe auch parent().

void QWindow::setPosition(const QPoint &pt)

setzt die Position des Fensters auf dem Desktop auf pt

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

Für das interaktive Verschieben von Fenstern, siehe startSystemMove(). Für die interaktive Größenänderung von Fenstern, siehe startSystemResize().

Siehe auch position() und startSystemMove().

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

setzt die Position des Fensters auf dem Desktop auf posx, posy

Die Position bezieht sich auf die virtualGeometry() des 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 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 Größenerhöhung (size) des Fensters fest.

Wenn der Benutzer die Größe des Fensters ändert, wird die Größe in Schritten von sizeIncrement().width() Pixeln horizontal und sizeIncrement().height() Pixeln vertikal verschoben, mit baseSize() als Basis.

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

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

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 das Raster-Rendering mit QBackingStore oder das OpenGL-Rendering mit QOpenGLContext gedacht ist.

Die surfaceType wird verwendet, wenn die native Oberfläche mit der Funktion create() erstellt wird. Der Aufruf dieser Funktion, nachdem die native Oberfläche erstellt wurde, erfordert den Aufruf von destroy() und create(), 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)

Verknüpft dieses Fenster mit dem angegebenen Vulkan instance.

instance muss so lange gültig bleiben, wie diese QWindow Instanz existiert.

Siehe auch vulkanInstance().

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

den Bildschirmbelegungsstatus des Fensters festlegen

Das Fenster state gibt an, ob das Fenster im Fenstersystem als maximiert, minimiert, bildschirmfüllend oder normal erscheint.

Der Enum-Wert Qt::WindowActive ist kein akzeptierter Parameter.

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

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

den Bildschirmbelegungsstatus des Fensters festlegen

Das Fenster state zeigt an, ob das Fenster im Fenstersystem als maximiert, minimiert und/oder bildschirmfüllend erscheint.

Das Fenster kann sich in einer Kombination aus mehreren Zuständen befinden. Wenn das Fenster beispielsweise sowohl minimiert als auch maximiert ist, erscheint das Fenster minimiert, aber ein Klick auf den Eintrag in der Taskleiste bringt es wieder in den maximierten Zustand.

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 ist dies gleichbedeutend mit dem Aufruf von showNormal(). Andernfalls ist es gleichbedeutend mit 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 behandeln (ev).

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

Wenn das Fenster erfolgreich vom Fenstersystem angezeigt wird, folgen ein Resize- und ein Expose-Ereignis.

[slot] void QWindow::showFullScreen()

Zeigt das Fenster im Vollbildmodus an.

Entspricht dem Aufruf von setWindowStates(Qt::WindowFullScreen) und dann setVisible(true).

Siehe die Dokumentation QWidget::showFullScreen() für plattformspezifische Überlegungen und Einschränkungen.

Siehe auch setWindowStates() und setVisible().

[slot] void QWindow::showMaximized()

Zeigt das Fenster in maximierter Form an.

Entspricht dem Aufruf von setWindowStates(Qt::WindowMaximized) und dann setVisible(true).

Siehe auch setWindowStates() und setVisible().

[slot] void QWindow::showMinimized()

Zeigt das Fenster als minimiert an.

Entspricht dem Aufruf von setWindowStates(Qt::WindowMinimized) und dann setVisible(true).

Siehe auch setWindowStates() und setVisible().

[slot] void QWindow::showNormal()

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

Entspricht dem Aufruf von setWindowStates(Qt::WindowNoState) und dann setVisible(true).

Siehe auch setWindowStates() und setVisible().

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

Reimplements: QSurface::size() const.

Liefert die Größe des Fensters ohne Berücksichtigung eines Fensterrahmens.

Siehe auch resize().

QSize QWindow::sizeIncrement() const

Gibt das Größeninkrement des Fensters zurück.

Siehe auch setSizeIncrement().

[slot] bool QWindow::startSystemMove()

Start einer systemspezifischen Verschiebeoperation

Der Aufruf dieses Befehls startet einen interaktiven Verschiebevorgang für das Fenster auf Plattformen, die dies unterstützen. Das tatsächliche Verhalten kann je nach Plattform variieren. Normalerweise wird das Fenster dem Mauszeiger folgen, 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 nativeres Aussehen und Verhalten beim Verschieben von Fenstern ermöglicht, z. B. das Einrasten des Fenstermanagers an anderen Fenstern oder ein spezielles Kachel- oder Größenänderungsverhalten mit Animationen, wenn das Fenster an den Rand des Bildschirms gezogen wird. Außerdem wird auf einigen Plattformen wie Wayland setPosition nicht unterstützt, so dass 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)

Start einer systemspezifischen Größenänderung

Ein Aufruf dieser Funktion startet eine interaktive Größenänderung des Fensters auf Plattformen, die dies unterstützen. Das tatsächliche Verhalten kann je nach Plattform variieren. Normalerweise wird die Größe des Fensters so angepasst, dass der Rand dem Mauszeiger folgt.

Auf Plattformen, die dies unterstützen, wird diese Methode der Größenänderung von Fenstern gegenüber setGeometry bevorzugt, da sie ein nativeres Aussehen und Gefühl bei der Größenänderung von Fenstern ermöglicht, z. B. das Einrasten des Fenstermanagers an anderen Fenstern oder ein spezielles Größenänderungsverhalten mit Animationen, wenn das Fenster an den Rand des Bildschirms gezogen wird.

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

Gibt true zurück, wenn die Operation vom System unterstützt wurde.

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

Reimplements: QSurface::surfaceType() const.

Gibt den Oberflächentyp des Fensters zurück.

Siehe auch setSurfaceType().

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

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

Proximity-Eintritts- und Austrittsereignisse werden nicht an Fenster gesendet, sondern an die Anwendungsinstanz.

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

Überschreiben Sie dies, um Berührungsereignisse zu behandeln (ev).

Qt::WindowType QWindow::type() const

Gibt den Typ des Fensters zurück.

Dies gibt den Teil der Fensterkennzeichen zurück, der angibt, ob es sich um ein Dialogfenster, ein Tooltip-Fenster, 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, falls eine gesetzt wurde, ansonsten nullptr.

Siehe auch setVulkanInstance().

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

Überschreiben Sie dies, um Mausrad- oder andere Rad-Ereignisse zu behandeln (ev).

WId QWindow::winId() const

Gibt die Plattform-ID des Fensters zurück.

Für Plattformen, bei denen diese ID nützlich sein könnte, wird der zurückgegebene Wert das Fenster innerhalb des entsprechenden Bildschirms eindeutig repräsentieren.

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 ausgegeben, wenn sich die windowState ändert, entweder durch explizites Setzen 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

den Zustand des Fensters, in dem es den Bildschirm belegt

Das Fenster kann sich in einer Kombination aus mehreren Zuständen befinden. Wenn das Fenster z. B. sowohl minimiert als auch maximiert ist, erscheint es minimiert, aber wenn Sie auf den Eintrag in der Taskleiste klicken, wird es wieder in den maximierten Zustand versetzt.

Siehe auch setWindowStates().