QWidget Class

Dokumentation der Mitgliedsfunktionen

Diese Komfortfunktionen erstellen eine neue Aktion mit dem Text text, dem Symbol icon und dem Kürzel shortcut, falls vorhanden.

Die Funktionen fügen die neu erstellte Aktion zur Liste der Aktionen des Widgets hinzu und geben sie zurück.

QWidget übernimmt das Eigentum an der zurückgegebenen QAction.

Diese Funktion wurde in Qt 6.3 eingeführt.

Dies ist eine überladene Funktion.

Diese Komfortfunktion erstellt eine neue Aktion mit dem Text text, dem Symbol icon und dem Kürzel shortcut, falls vorhanden.

Das Signal triggered() der Aktion wird mit dem receiver's member Slot verbunden. Die Funktion fügt die neu erstellte Aktion zur Liste der Aktionen des Widgets hinzu und gibt sie zurück.

QWidget übernimmt das Eigentum an der zurückgegebenen QAction.

Diese Funktion wurde in Qt 6.3 eingeführt.

Dies ist eine überladene Funktion.

Diese Komfortfunktionen erstellen eine neue Aktion mit dem Text text, dem Symbol icon und dem Kürzel shortcut, falls vorhanden.

Das Signal triggered() der Aktion wird wie durch einen Aufruf von QObject::connect(action, &QAction::triggered, args...) verbunden, wobei args perfekt weitergeleitet wird, einschließlich einer möglichen Qt::ConnectionType.

Die Funktion fügt die neu erstellte Aktion zur Liste der Aktionen des Widgets hinzu und gibt sie zurück.

QWidget übernimmt das Eigentum an der zurückgegebenen QAction.

Diese Funktion wurde in Qt 6.3 eingeführt.

[explicit] QWidget::QWidget(QWidget *parent = nullptr, Qt::WindowFlags f = Qt::WindowFlags())

Konstruiert ein Widget, das ein Kind von parent ist, wobei die Widget-Flags auf f gesetzt sind.

Wenn parent nullptr ist, wird das neue Widget ein Fenster. Wenn parent ein anderes Widget ist, wird dieses Widget ein untergeordnetes Fenster innerhalb von parent. Das neue Widget wird gelöscht, wenn sein parent gelöscht wird.

Das Argument für die Widget-Flags, f, ist normalerweise 0, aber es kann gesetzt werden, um den Rahmen eines Fensters anzupassen (d.h. parent muss nullptr sein). Um den Rahmen anzupassen, verwenden Sie einen Wert, der sich aus dem bitweisen ODER einer der window flags zusammensetzt.

Wenn Sie ein untergeordnetes Widget zu einem bereits sichtbaren Widget hinzufügen, müssen Sie das untergeordnete Widget explizit anzeigen, um es sichtbar zu machen.

Beachten Sie, dass die X11-Version von Qt möglicherweise nicht alle Kombinationen von Style-Flags auf allen Systemen bereitstellen kann. Das liegt daran, dass Qt unter X11 nur den Fenstermanager fragen kann, und der Fenstermanager kann die Einstellungen der Anwendung außer Kraft setzen. Unter Windows kann Qt alle Flags setzen, die Sie wollen.

Siehe auch windowFlags.

[virtual noexcept] QWidget::~QWidget()

Zerstört das Widget.

Alle Kinder dieses Widgets werden zuerst gelöscht. Die Anwendung wird beendet, wenn dieses Widget das Hauptwidget ist.

[virtual protected] void QWidget::actionEvent(QActionEvent *event)

Dieser Event-Handler wird mit dem angegebenen event aufgerufen, wenn die Aktionen des Widgets geändert werden.

Siehe auch addAction(), insertAction(), removeAction(), actions(), und QActionEvent.

QList<QAction *> QWidget::actions() const

Gibt die (möglicherweise leere) Liste der Aktionen dieses Widgets zurück.

Siehe auch contextMenuPolicy, insertAction(), und removeAction().

void QWidget::activateWindow()

Legt fest, dass das Top-Level-Widget, das dieses Widget enthält, das aktive Fenster ist.

Ein aktives Fenster ist ein sichtbares Fenster der obersten Ebene, das den Fokus der Tastatureingabe hat.

Diese Funktion führt die gleiche Operation aus wie ein Mausklick auf die Titelleiste eines Fensters der obersten Ebene. Unter X11 hängt das Ergebnis vom Fenstermanager ab. Wenn Sie sicherstellen wollen, dass das Fenster auch oben gestapelt wird, sollten Sie auch raise() aufrufen. Beachten Sie, dass das Fenster sichtbar sein muss, sonst hat activateWindow() keine Wirkung.

Wenn Sie diese Funktion unter Windows aufrufen, während die Anwendung noch nicht aktiv ist, wird sie nicht zum aktiven Fenster. Es wird die Farbe des Taskleisteneintrags ändern, um anzuzeigen, dass sich das Fenster in irgendeiner Weise geändert hat. Dies liegt daran, dass Microsoft nicht zulässt, dass eine Anwendung unterbricht, was der Benutzer gerade in einer anderen Anwendung tut.

Siehe auch isActiveWindow(), window(), und show().

void QWidget::addAction(QAction *action)

Hängt die Aktion action an die Liste der Aktionen des Widgets an.

Alle QWidgets haben eine Liste von QActions. Sie können jedoch auf viele verschiedene Arten grafisch dargestellt werden. Die Standardverwendung der QAction Liste (wie von actions() zurückgegeben) ist es, einen Kontext QMenu zu erstellen.

Ein QWidget sollte von jeder Aktion nur eine haben und das Hinzufügen einer Aktion, die es bereits hat, führt nicht dazu, dass dieselbe Aktion zweimal im Widget ist.

Der Besitz von action wird nicht auf dieses QWidget übertragen.

Siehe auch removeAction(), insertAction(), actions(), und QMenu.

void QWidget::addActions(const QList<QAction *> &actions)

Hängt die Aktionen actions an die Liste der Aktionen dieses Widgets an.

Siehe auch removeAction(), QMenu, und addAction().

void QWidget::adjustSize()

Passt die Größe des Widgets an seinen Inhalt an.

Diese Funktion verwendet sizeHint(), wenn sie gültig ist, d.h. wenn die Breite und Höhe des Größenhinweises >= 0 sind. Andernfalls setzt sie die Größe auf das Kinderrechteck, das alle Kinderwidgets abdeckt (die Vereinigung aller Kinderrechtecke der Widgets).

Bei Fenstern wird auch die Bildschirmgröße berücksichtigt. Wenn sizeHint() kleiner als (200, 100) ist und die Größenpolitik expanding lautet, wird das Fenster mindestens (200, 100) groß sein. Die maximale Größe eines Fensters beträgt 2/3 der Breite und Höhe des Bildschirms.

Siehe auch sizeHint() und childrenRect().

QPalette::ColorRole QWidget::backgroundRole() const

Gibt die Hintergrundrolle des Widgets zurück.

Die Hintergrundrolle definiert den Pinsel aus dem palette des Widgets, der zum Rendern des Hintergrunds verwendet wird.

Wenn keine explizite Hintergrundrolle gesetzt ist, erbt das Widget die Hintergrundrolle seines Eltern-Widgets.

Siehe auch setBackgroundRole() und foregroundRole().

QBackingStore *QWidget::backingStore() const

Gibt die QBackingStore zurück, in die dieses Widget gezeichnet wird.

[virtual protected] void QWidget::changeEvent(QEvent *event)

Dieser Event-Handler kann neu implementiert werden, um Zustandsänderungen zu behandeln.

Der in diesem Ereignis geänderte Zustand kann über die mitgelieferte event abgerufen werden.

Zu den Änderungsereignissen gehören: QEvent::ToolBarChange, QEvent::ActivationChange, QEvent::EnabledChange, QEvent::FontChange, QEvent::StyleChange, QEvent::PaletteChange, QEvent::WindowTitleChange, QEvent::IconTextChange, QEvent::ModifiedChange, QEvent::MouseTrackingChange, QEvent::ParentChange, QEvent::WindowStateChange, QEvent::LanguageChange, QEvent::LocaleChange, QEvent::LayoutDirectionChange, QEvent::ReadOnlyChange.

QWidget *QWidget::childAt(int x, int y) const

Gibt das sichtbare untergeordnete Widget an der Position (x, y) im Koordinatensystem des Widgets zurück. Gibt es kein sichtbares untergeordnetes Widget an der angegebenen Position, gibt die Funktion nullptr zurück.

QWidget *QWidget::childAt(const QPoint &p) const

Dies ist eine überladene Funktion.

Gibt das sichtbare untergeordnete Widget am Punkt p im eigenen Koordinatensystem zurück.

[since 6.8] QWidget *QWidget::childAt(const QPointF &p) const

Dies ist eine überladene Funktion.

Gibt das sichtbare untergeordnete Widget am Punkt p im eigenen Koordinatensystem zurück.

Diese Funktion wurde in Qt 6.8 eingeführt.

void QWidget::clearFocus()

Nimmt den Tastatureingabefokus vom Widget.

Wenn das Widget den aktiven Fokus hat, wird eine focus out event an dieses Widget gesendet, um ihm mitzuteilen, dass es den Fokus verloren hat.

Dieses Widget muss die Fokuseinstellung aktivieren, um den Tastatureingabefokus zu erhalten; das heißt, es muss setFocusPolicy() aufrufen.

Siehe auch hasFocus(), setFocus(), focusInEvent(), focusOutEvent(), setFocusPolicy(), und QApplication::focusWidget().

void QWidget::clearMask()

Entfernt alle Masken, die mit setMask() gesetzt wurden.

Siehe auch setMask().

[slot] bool QWidget::close()

Schließt dieses Widget. Gibt true zurück, wenn das Widget geschlossen wurde; andernfalls gibt es false zurück.

Zuerst sendet es dem Widget ein QCloseEvent. Das Widget ist hidden, wenn es accepts das Schließereignis. Wenn es ignores das Ereignis, passiert nichts. Die Standardimplementierung von QWidget::closeEvent() akzeptiert das Schließereignis.

Wenn das Widget das Qt::WA_DeleteOnClose Flag hat, wird das Widget auch gelöscht. Ein Schließereignis wird an das Widget übermittelt, unabhängig davon, ob das Widget sichtbar ist oder nicht.

Das Signal QGuiApplication::lastWindowClosed() wird ausgegeben, wenn das letzte sichtbare primäre Fenster (d.h. ein Fenster ohne Elternteil) mit dem Attribut Qt::WA_QuitOnClose geschlossen wird. Standardmäßig ist dieses Attribut für alle Widgets gesetzt, außer für vorübergehende Fenster wie Splash-Screens, Werkzeugfenster und Popup-Menüs.

[virtual protected] void QWidget::closeEvent(QCloseEvent *event)

Dieser Event-Handler wird mit der angegebenen event aufgerufen, wenn Qt eine Anforderung zum Schließen eines Fensters für ein Top-Level-Widget vom Fenstersystem erhält.

Standardmäßig wird das Ereignis akzeptiert und das Widget wird geschlossen. Sie können diese Funktion neu implementieren, um die Art und Weise zu ändern, wie das Widget auf Anfragen zum Schließen des Fensters reagiert. Sie können zum Beispiel das Schließen des Fensters verhindern, indem Sie ignore() bei allen Ereignissen aufrufen.

Hauptfensteranwendungen verwenden typischerweise Reimplementierungen dieser Funktion, um zu prüfen, ob die Arbeit des Benutzers gespeichert wurde, und um vor dem Schließen um Erlaubnis zu fragen.

Siehe auch event(), hide(), close(), und QCloseEvent.

QMargins QWidget::contentsMargins() const

Die Funktion contentsMargins gibt die Inhaltsränder des Widgets zurück.

Siehe auch setContentsMargins() und contentsRect().

QRect QWidget::contentsRect() const

Gibt den Bereich innerhalb der Ränder des Widgets zurück.

Siehe auch setContentsMargins() und contentsMargins().

[virtual protected] void QWidget::contextMenuEvent(QContextMenuEvent *event)

Dieser Ereignishandler für das Ereignis event kann in einer Unterklasse neu implementiert werden, um Ereignisse des Widget-Kontextmenüs zu empfangen.

Der Handler wird aufgerufen, wenn die contextMenuPolicy des Widgets Qt::DefaultContextMenu ist.

Die Standardimplementierung ignoriert das Kontextereignis. Siehe die QContextMenuEvent Dokumentation für weitere Details.

Siehe auch event(), QContextMenuEvent, und customContextMenuRequested().

[protected] void QWidget::create(WId window = 0, bool initializeWindow = true, bool destroyOldWindow = true)

Erzeugt ein neues Widget-Fenster.

Die Parameter window, initializeWindow und destroyOldWindow werden in Qt 5 ignoriert. Bitte verwenden Sie QWindow::fromWinId(), um ein QWindow zu erstellen, das ein fremdes Fenster umhüllt und übergeben Sie es stattdessen an QWidget::createWindowContainer().

Siehe auch createWindowContainer() und QWindow::fromWinId().

[static] QWidget *QWidget::createWindowContainer(QWindow *window, QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())

Erzeugt ein QWidget, das es ermöglicht, window in eine QWidget-basierte Anwendung einzubetten.

Der Fenster-Container wird als Kind von parent und mit Fenster-Flags flags erstellt.

Sobald das Fenster in den Container eingebettet ist, kontrolliert der Container die Geometrie und Sichtbarkeit des Fensters. Explizite Aufrufe von QWindow::setGeometry(), QWindow::show() oder QWindow::hide() für ein eingebettetes Fenster werden nicht empfohlen.

Der Container übernimmt die Kontrolle über window. Das Fenster kann mit einem Aufruf von QWindow::setParent() aus dem Fenster-Container entfernt werden.

Der Fenster-Container ist als natives Kindfenster an das Toplevel-Fenster angehängt, dessen Kind er ist. Wenn ein Fenster-Container als Kind eines QAbstractScrollArea oder QMdiArea verwendet wird, erstellt er ein native window für jedes Widget in seiner Elternkette, um in diesem Anwendungsfall ein korrektes Stapeln und Beschneiden zu ermöglichen. Das Erstellen eines nativen Fensters für den Fenster-Container ermöglicht ebenfalls ein korrektes Stapeln und Beschneiden. Dies muss geschehen, bevor der Fenster-Container angezeigt wird. Anwendungen mit vielen nativen Kindfenstern können unter Leistungsproblemen leiden.

Der Fenster-Container hat eine Reihe von bekannten Einschränkungen:

• Stapelreihenfolge: Das eingebettete Fenster wird als undurchsichtige Box über der Widget-Hierarchie gestapelt. Die Stapelreihenfolge mehrerer sich überlappender Fenster-Container-Instanzen ist undefiniert.
• Rendering-Integration; Der Fenster-Container arbeitet nicht mit QGraphicsProxyWidget, QWidget::render() oder ähnlichen Funktionen zusammen.
• Fokus-Handling; Es ist möglich, die Fenster-Container-Instanz eine beliebige Fokus-Policy haben zu lassen und sie wird den Fokus an das Fenster über einen Aufruf von QWindow::requestActivate() delegieren. Wie auch immer, die Rückkehr zur normalen Fokuskette von der QWindow Instanz wird von der QWindow Instanzimplementierung selbst abhängen. Wenn man z.B. ein Qt Quick basiertes Fenster mit Tabulatorfokus betritt, ist es sehr wahrscheinlich, dass weitere Tabulatordrücke nur innerhalb der QML-Anwendung durchlaufen werden. Auch ob QWindow::requestActivate() dem Fenster tatsächlich den Fokus gibt, ist plattformabhängig.
• Die Verwendung vieler Fenster-Container-Instanzen in einer QWidget-basierten Anwendung kann die Gesamtleistung der Anwendung stark beeinträchtigen.
• Seit 6.7 wird kein Container mehr erstellt, wenn window zu einem Widget gehört (d.h. window wurde durch den Aufruf von windowHandle() empfangen). Stattdessen wird diese Funktion das Widget selbst zurückgeben, nachdem es an parent repariert wurde. Da kein Container erstellt wird, wird flags ignoriert. Mit anderen Worten, wenn window zu einem Widget gehört, sollten Sie erwägen, dieses Widget an parent zu reparieren, anstatt diese Funktion zu verwenden.

[signal] void QWidget::customContextMenuRequested(const QPoint &pos)

Dieses Signal wird ausgegeben, wenn contextMenuPolicy des Widgets Qt::CustomContextMenu ist und der Benutzer ein Kontextmenü für das Widget angefordert hat. Die Position pos ist die Position des Kontextmenü-Ereignisses, das das Widget empfängt. Normalerweise ist dies in den Koordinaten des Widgets. Die Ausnahme von dieser Regel ist QAbstractScrollArea und seine Unterklassen, die das Kontextmenüereignis auf die Koordinaten von viewport() abbilden.

Siehe auch mapToGlobal(), QMenu, und contextMenuPolicy.

[protected] void QWidget::destroy(bool destroyWindow = true, bool destroySubWindows = true)

Gibt die Systemressourcen des Fensters frei. Zerstört das Widget-Fenster, wenn destroyWindow wahr ist.

destroy() ruft sich selbst rekursiv für alle untergeordneten Widgets auf und übergibt destroySubWindows für den Parameter destroyWindow. Um mehr Kontrolle über die Zerstörung von Subwidgets zu haben, zerstören Sie die Subwidgets zuerst selektiv.

Diese Funktion wird normalerweise vom QWidget destructor aufgerufen.

[virtual protected] void QWidget::dragEnterEvent(QDragEnterEvent *event)

Dieser Event-Handler wird aufgerufen, wenn ein Ziehen im Gange ist und die Maus in dieses Widget eintritt. Das Ereignis wird mit dem Parameter event übergeben.

Wenn das Ereignis ignoriert wird, erhält das Widget keine drag move events.

In der Drag-and-drop-Dokumentation finden Sie einen Überblick darüber, wie Sie Drag-and-drop in Ihrer Anwendung bereitstellen können.

Siehe auch QDrag und QDragEnterEvent.

[virtual protected] void QWidget::dragLeaveEvent(QDragLeaveEvent *event)

Dieser Event-Handler wird aufgerufen, wenn ein Ziehen im Gange ist und die Maus dieses Widget verlässt. Das Ereignis wird mit dem Parameter event übergeben.

In der Drag-and-drop-Dokumentation finden Sie einen Überblick darüber, wie Sie Drag-and-drop in Ihrer Anwendung bereitstellen können.

Siehe auch QDrag und QDragLeaveEvent.

[virtual protected] void QWidget::dragMoveEvent(QDragMoveEvent *event)

Dieser Event-Handler wird aufgerufen, wenn ein Ziehen im Gange ist und wenn eine der folgenden Bedingungen eintritt: der Cursor betritt dieses Widget, der Cursor bewegt sich innerhalb dieses Widgets oder eine Modifier-Taste wird auf der Tastatur gedrückt, während dieses Widget den Fokus hat. Das Ereignis wird mit dem Parameter event übergeben.

In der Drag-and-drop-Dokumentation finden Sie einen Überblick darüber, wie Sie Drag-and-drop in Ihrer Anwendung bereitstellen können.

Siehe auch QDrag und QDragMoveEvent.

[virtual protected] void QWidget::dropEvent(QDropEvent *event)

Dieser Event-Handler wird aufgerufen, wenn das Ziehen auf diesem Widget abgesetzt wird. Das Ereignis wird mit dem Parameter event übergeben.

In der Drag-and-Drop-Dokumentation finden Sie einen Überblick darüber, wie Sie Drag-and-Drop in Ihrer Anwendung anbieten können.

Siehe auch QDrag und QDropEvent.

WId QWidget::effectiveWinId() const

Gibt den effektiven Fenstersystembezeichner des Widgets zurück, d.h. den Fenstersystembezeichner des nativen Elternteils.

Wenn das Widget nativ ist, gibt diese Funktion die native Widget-ID zurück. Andernfalls wird die Fenster-ID des ersten nativen übergeordneten Widgets zurückgegeben, d. h. des Widgets der obersten Ebene, das dieses Widget enthält.

Siehe auch nativeParentWidget().

void QWidget::ensurePolished() const

Stellt sicher, dass das Widget und seine Kinder von QStyle aufpoliert wurden (d.h. eine korrekte Schriftart und Palette haben).

QWidget ruft diese Funktion auf, nachdem das Widget vollständig konstruiert wurde, aber bevor es das erste Mal angezeigt wird. Sie können diese Funktion aufrufen, wenn Sie sicherstellen wollen, dass das Widget poliert ist, bevor Sie eine Operation durchführen, z.B. könnte die korrekte Schriftgröße in der sizeHint() Reimplementierung des Widgets benötigt werden. Beachten Sie, dass diese Funktion von der Standardimplementierung von sizeHint() aufgerufen wird.

Polishing ist nützlich für die endgültige Initialisierung, die erfolgen muss, nachdem alle Konstruktoren (sowohl von Basisklassen als auch von Unterklassen) aufgerufen wurden.

Wenn Sie einige Einstellungen ändern müssen, wenn ein Widget poliert wird, implementieren Sie event() neu und behandeln Sie den Ereignistyp QEvent::Polish.

Hinweis: Die Funktion ist als const deklariert, so dass sie von anderen const-Funktionen (z. B. sizeHint()) aufgerufen werden kann.

Siehe auch event().

[virtual protected] void QWidget::enterEvent(QEnterEvent *event)

Dieser Event-Handler kann in einer Unterklasse neu implementiert werden, um Widget-Entry-Ereignisse zu empfangen, die mit dem Parameter event übergeben werden.

Ein Ereignis wird an das Widget gesendet, wenn der Mauszeiger das Widget betritt.

Siehe auch leaveEvent(), mouseMoveEvent(), und event().

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

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

Dies ist der Hauptereignishandler; er behandelt das Ereignis event. Sie können diese Funktion in einer Unterklasse reimplementieren, aber wir empfehlen, stattdessen einen der spezialisierten Event-Handler zu verwenden.

Ereignisse zum Drücken und Loslassen von Tasten werden anders behandelt als andere Ereignisse. event() prüft auf Tab und Shift+Tab und versucht, den Fokus entsprechend zu verschieben. Wenn es kein Widget gibt, in das der Fokus verschoben werden kann (oder der Tastendruck nicht Tab oder Shift+Tab ist), ruft event() keyPressEvent() auf.

Die Behandlung von Maus- und Tablett-Ereignissen ist ebenfalls etwas speziell: nur wenn das Widget enabled ist, ruft event() die speziellen Handler wie mousePressEvent() auf; andernfalls wird das Ereignis verworfen.

Diese Funktion gibt true zurück, wenn das Ereignis erkannt wurde, andernfalls gibt sie false zurück. Wenn das erkannte Ereignis akzeptiert wurde (siehe QEvent::accepted), wird jede weitere Verarbeitung, wie z. B. die Weitergabe von Ereignissen an das übergeordnete Widget, beendet.

Siehe auch closeEvent(), focusInEvent(), focusOutEvent(), enterEvent(), keyPressEvent(), keyReleaseEvent(), leaveEvent(), mouseDoubleClickEvent(), mouseMoveEvent(), mousePressEvent(), mouseReleaseEvent(), moveEvent(), paintEvent(), resizeEvent(), QObject::event(), und QObject::timerEvent().

[static] QWidget *QWidget::find(WId id)

Gibt einen Zeiger auf das Widget mit dem Fensterbezeichner/Handle id zurück.

Der Typ des Fensterkennzeichens hängt vom zugrunde liegenden Fenstersystem ab, siehe qwindowdefs.h für die aktuelle Definition. Falls es kein Widget mit dieser Kennung gibt, wird nullptr zurückgegeben.

[virtual protected] void QWidget::focusInEvent(QFocusEvent *event)

Dieser Eventhandler kann in einer Unterklasse neu implementiert werden, um Tastaturfokusereignisse (Fokus erhalten) für das Widget zu empfangen. Das Ereignis wird mit dem Parameter event übergeben.

Ein Widget muss normalerweise setFocusPolicy() an etwas anderes als Qt::NoFocus übergeben, um Fokusereignisse zu empfangen. (Beachten Sie, dass der Anwendungsprogrammierer setFocus() für jedes Widget aufrufen kann, auch für solche, die normalerweise keinen Fokus empfangen).

Die Standardimplementierung aktualisiert das Widget (außer für Fenster, die kein focusPolicy() angeben).

Siehe auch focusOutEvent(), setFocusPolicy(), keyPressEvent(), keyReleaseEvent(), event(), und QFocusEvent.

[protected] bool QWidget::focusNextChild()

Findet ein neues Widget, dem der Tastaturfokus gegeben werden kann, wie es für Tab angemessen ist, und gibt true zurück, wenn es ein neues Widget findet, oder false, wenn es das nicht kann.

Siehe auch focusPreviousChild().

[virtual protected] bool QWidget::focusNextPrevChild(bool next)

Findet ein neues Widget, dem der Tastaturfokus gegeben werden soll, wie es für Tab und Shift+Tab angemessen ist, und gibt true zurück, wenn es ein neues Widget findet, oder false, wenn es nicht gefunden wird.

Wenn next wahr ist, sucht diese Funktion vorwärts, wenn next falsch ist, sucht sie rückwärts.

Manchmal werden Sie diese Funktion neu implementieren wollen. Zum Beispiel könnte ein Webbrowser sie neu implementieren, um seinen "aktuellen aktiven Link" vorwärts oder rückwärts zu bewegen und focusNextPrevChild() nur dann aufzurufen, wenn er den letzten oder ersten Link auf der "Seite" erreicht.

Kind-Widgets rufen focusNextPrevChild() bei ihren Eltern-Widgets auf, aber nur das Fenster, das die Kind-Widgets enthält, entscheidet, wohin der Fokus umgeleitet wird. Indem Sie diese Funktion für ein Objekt reimplementieren, erhalten Sie die Kontrolle über den Fokus-Traversal für alle Child-Widgets.

Siehe auch focusNextChild() und focusPreviousChild().

[virtual protected] void QWidget::focusOutEvent(QFocusEvent *event)

Dieser Ereignishandler kann in einer Unterklasse neu implementiert werden, um Tastaturfokusereignisse (Fokus verloren) für das Widget zu empfangen. Die Ereignisse werden mit dem Parameter event übergeben.

Ein Widget muss normalerweise setFocusPolicy() an etwas anderes als Qt::NoFocus übergeben, um Fokusereignisse zu empfangen. (Beachten Sie, dass der Anwendungsprogrammierer setFocus() auf jedem Widget aufrufen kann, auch auf solchen, die normalerweise keinen Fokus akzeptieren).

Die Standardimplementierung aktualisiert das Widget (außer für Fenster, die kein focusPolicy() angeben).

Siehe auch focusInEvent(), setFocusPolicy(), keyPressEvent(), keyReleaseEvent(), event(), und QFocusEvent.

[protected] bool QWidget::focusPreviousChild()

Findet ein neues Widget, dem der Tastaturfokus gegeben werden kann, wie es für Shift+Tab angemessen ist, und gibt true zurück, wenn es ein neues Widget findet, oder false, wenn es nicht gefunden wird.

Siehe auch focusNextChild().

QWidget *QWidget::focusProxy() const

Gibt den Fokus-Proxy zurück, oder nullptr, wenn es keinen Fokus-Proxy gibt.

Siehe auch setFocusProxy().

QWidget *QWidget::focusWidget() const

Gibt das letzte Kind dieses Widgets zurück, für das setFocus aufgerufen wurde. Für Widgets der obersten Ebene ist dies das Widget, das den Fokus erhält, wenn dieses Fenster aktiviert wird.

Dies ist nicht dasselbe wie QApplication::focusWidget(), das das Fokus-Widget im derzeit aktiven Fenster zurückgibt.

QFontInfo QWidget::fontInfo() const

Gibt die Schriftartinformationen für die aktuelle Schriftart des Widgets zurück. Äquivalent zu QFontInfo(widget->font()).

Siehe auch font(), fontMetrics(), und setFont().

QFontMetrics QWidget::fontMetrics() const

Gibt die Schriftmetrik für die aktuelle Schrift des Widgets zurück. Äquivalent zu QFontMetrics(widget->font()).

Siehe auch font(), fontInfo(), und setFont().

QPalette::ColorRole QWidget::foregroundRole() const

Gibt die Vordergrundrolle zurück.

Die Vordergrundrolle definiert die Farbe aus dem palette des Widgets, die zum Zeichnen des Vordergrunds verwendet wird.

Wenn keine explizite Vordergrundrolle gesetzt ist, gibt die Funktion eine Rolle zurück, die mit der Hintergrundrolle kontrastiert.

Siehe auch setForegroundRole() und backgroundRole().

[invokable] QPixmap QWidget::grab(const QRect &rectangle = QRect(QPoint(0, 0), QSize(-1, -1)))

Rendert das Widget in eine Pixmap, die durch die angegebene rectangle begrenzt ist. Wenn das Widget Kinder hat, werden diese ebenfalls an den entsprechenden Positionen gezeichnet.

Wenn ein Rechteck mit einer ungültigen Größe angegeben wird (die Vorgabe), wird das gesamte Widget gezeichnet.

Siehe auch render() und QPixmap.

void QWidget::grabGesture(Qt::GestureType gesture, Qt::GestureFlags flags = Qt::GestureFlags())

Abonniert das Widget auf ein bestimmtes gesture mit spezifischer flags.

Siehe auch ungrabGesture() und QGestureEvent.

void QWidget::grabKeyboard()

Erfasst die Tastatureingabe.

Dieses Widget empfängt alle Tastaturereignisse, bis releaseKeyboard() aufgerufen wird; andere Widgets erhalten überhaupt keine Tastaturereignisse. Mausereignisse sind nicht betroffen. Verwenden Sie grabMouse(), wenn Sie diese abfangen wollen.

Das Fokus-Widget ist nicht betroffen, außer dass es keine Tastaturereignisse empfängt. setFocus() verschiebt den Fokus wie üblich, aber das neue Fokus-Widget empfängt Tastaturereignisse erst, nachdem releaseKeyboard() aufgerufen wurde.

Wenn ein anderes Widget gerade Tastatureingaben abgreift, wird der Zugriff dieses Widgets zuerst freigegeben.

Siehe auch releaseKeyboard(), grabMouse(), releaseMouse(), und focusWidget().

void QWidget::grabMouse()

Ergreift die Mauseingabe.

Dieses Widget empfängt alle Mausereignisse, bis releaseMouse() aufgerufen wird; andere Widgets erhalten überhaupt keine Mausereignisse. Tastaturereignisse sind nicht betroffen. Verwenden Sie grabKeyboard(), wenn Sie diese abfangen wollen.

Bei der Verwendung von Qt ist es nur selten notwendig, die Maus zu greifen, da Qt sie vernünftig greift und loslässt. Insbesondere ergreift Qt die Maus, wenn eine Maustaste gedrückt wird und behält sie, bis die letzte Taste losgelassen wird.

Siehe auch releaseMouse(), grabKeyboard(), und releaseKeyboard().

void QWidget::grabMouse(const QCursor &cursor)

Diese Funktion überlastet grabMouse().

Ergreift die Mauseingabe und ändert die Form des Cursors.

Der Cursor nimmt die Form cursor an (solange der Mausfokus gegriffen wird) und dieses Widget ist das einzige, das Mausereignisse empfängt, bis releaseMouse() aufgerufen wird().

Siehe auch releaseMouse(), grabKeyboard(), releaseKeyboard(), und setCursor().

int QWidget::grabShortcut(const QKeySequence &key, Qt::ShortcutContext context = Qt::WindowShortcut)

Fügt dem Qt-Verknüpfungssystem eine Verknüpfung hinzu, die nach der angegebenen key -Sequenz in der angegebenen context sucht. Wenn context Qt::ApplicationShortcut ist, gilt die Verknüpfung für die gesamte Anwendung. Andernfalls ist sie entweder lokal für dieses Widget, Qt::WidgetShortcut, oder für das Fenster selbst, Qt::WindowShortcut.

Wenn dieselbe key Sequenz von mehreren Widgets gegriffen wurde, wird beim Auftreten der key Sequenz ein QEvent::Shortcut Ereignis an alle Widgets gesendet, auf die es zutrifft, in einer nicht-deterministischen Reihenfolge, aber mit dem ``ambiguous'' Flag auf true gesetzt.

Siehe auch releaseShortcut() und setShortcutEnabled().

QGraphicsEffect *QWidget::graphicsEffect() const

Die Funktion graphicsEffect gibt einen Zeiger auf den Grafikeffekt des Widgets zurück.

Wenn das Widget keinen Grafikeffekt hat, wird nullptr zurückgegeben.

Siehe auch setGraphicsEffect().

QGraphicsProxyWidget *QWidget::graphicsProxyWidget() const

Gibt das Proxy-Widget für das entsprechende eingebettete Widget in einer Grafikansicht zurück; andernfalls wird nullptr zurückgegeben.

Siehe auch QGraphicsProxyWidget::createProxyForChildWidget() und QGraphicsScene::addWidget().

bool QWidget::hasEditFocus() const

Gibt true zurück, wenn dieses Widget gerade den Bearbeitungsfokus hat; andernfalls false.

Diese Funktion ist nur in Qt for Embedded Linux verfügbar.

Siehe auch setEditFocus() und QApplication::navigationMode().

[virtual] bool QWidget::hasHeightForWidth() const

Gibt true zurück, wenn die bevorzugte Höhe des Widgets von seiner Breite abhängt; andernfalls wird false zurückgegeben.

[virtual] int QWidget::heightForWidth(int w) const

Gibt die bevorzugte Höhe für dieses Widget in Abhängigkeit von der Breite w zurück.

Wenn dieses Widget ein Layout hat, gibt die Standardimplementierung die bevorzugte Höhe des Layouts zurück. Wenn es kein Layout gibt, gibt die Standardimplementierung -1 zurück und zeigt damit an, dass die bevorzugte Höhe nicht von der Breite abhängt.

[slot] void QWidget::hide()

Blendet das Widget aus. Diese Funktion ist äquivalent zu setVisible(false).

Siehe auch hideEvent(), isHidden(), show(), setVisible(), isVisible(), und close().

[virtual protected] void QWidget::hideEvent(QHideEvent *event)

Dieser Event-Handler kann in einer Unterklasse neu implementiert werden, um Ereignisse zum Ausblenden von Widgets zu empfangen. Das Ereignis wird mit dem Parameter event übergeben.

Ausblendungsereignisse werden an Widgets sofort gesendet, nachdem sie ausgeblendet worden sind.

Hinweis: Ein Widget empfängt spontane Ein- und Ausblendungsereignisse, wenn sein Zuordnungsstatus durch das Fenstersystem geändert wird, z. B. ein spontanes Ausblendungsereignis, wenn der Benutzer das Fenster minimiert, und ein spontanes Einblendungsereignis, wenn das Fenster wiederhergestellt wird. Nach dem Empfang eines spontanen Ausblendungsereignisses wird ein Widget weiterhin als sichtbar im Sinne von isVisible() betrachtet.

Siehe auch visible, event(), und QHideEvent.

[override virtual protected] void QWidget::initPainter(QPainter *painter) const

Initialisiert den painter Stift, den Hintergrund und die Schriftart auf die gleichen Werte wie das angegebene Widget. Diese Funktion wird automatisch aufgerufen, wenn der Painter auf einer QWidget geöffnet wird.

[virtual protected] void QWidget::inputMethodEvent(QInputMethodEvent *event)

Dieser Event-Handler für das Ereignis event kann in einer Unterklasse reimplementiert werden, um Ereignisse zur Zusammensetzung der Eingabemethode zu empfangen. Dieser Handler wird aufgerufen, wenn sich der Zustand der Eingabemethode ändert.

Beachten Sie, dass bei der Erstellung von benutzerdefinierten Textbearbeitungs-Widgets das Attribut Qt::WA_InputMethodEnabled window explizit gesetzt werden muss (mit der Funktion setAttribute()), um Eingabemethoden-Ereignisse zu empfangen.

Die Standardimplementierung ruft event->ignore() auf, wodurch das Input Method-Ereignis zurückgewiesen wird. Weitere Einzelheiten finden Sie in der Dokumentation QInputMethodEvent.

Siehe auch event() und QInputMethodEvent.

[virtual] QVariant QWidget::inputMethodQuery(Qt::InputMethodQuery query) const

Diese Methode ist nur für Eingabe-Widgets relevant. Sie wird von der Eingabemethode verwendet, um eine Reihe von Eigenschaften des Widgets abzufragen, damit komplexe Eingabemethoden wie die Unterstützung von umgebendem Text und Rückumwandlungen unterstützt werden können.

query gibt an, welche Eigenschaft abgefragt wird.

Siehe auch inputMethodEvent(), QInputMethodEvent, QInputMethodQueryEvent, und inputMethodHints.

void QWidget::insertAction(QAction *before, QAction *action)

Fügt die Aktion action in die Liste der Aktionen dieses Widgets ein, vor der Aktion before. Es fügt die Aktion an, wenn before nullptr ist oder before keine gültige Aktion für dieses Widget ist.

Ein QWidget sollte nur eine von jeder Aktion haben.

Siehe auch removeAction(), addAction(), QMenu, contextMenuPolicy, und actions().

void QWidget::insertActions(QAction *before, const QList<QAction *> &actions)

Fügt die Aktion actions in die Liste der Aktionen dieses Widgets ein, vor der Aktion before. Es fügt die Aktion an, wenn before nullptr ist oder before keine gültige Aktion für dieses Widget ist.

Ein QWidget kann höchstens eine von jeder Aktion haben.

Siehe auch removeAction(), QMenu, insertAction(), und contextMenuPolicy.

bool QWidget::isAncestorOf(const QWidget *child) const

Gibt true zurück, wenn dieses Widget ein Elternteil (oder Großelternteil und so weiter auf jeder Ebene) des angegebenen child ist und beide Widgets sich im selben Fenster befinden; andernfalls wird false zurückgegeben.

bool QWidget::isEnabledTo(const QWidget *ancestor) const

Gibt true zurück, wenn dieses Widget aktiviert werden würde, wenn ancestor aktiviert ist; andernfalls wird false zurückgegeben.

Dies ist der Fall, wenn weder das Widget selbst noch alle übergeordneten Elemente bis auf ancestor explizit deaktiviert worden sind.

isEnabledTo(0) gibt false zurück, wenn dieses Widget oder einer seiner Vorfahren explizit deaktiviert wurde.

Das Wort Vorgänger bedeutet hier ein übergeordnetes Widget innerhalb desselben Fensters.

Daher bleibt isEnabledTo(0) bei dem Fenster dieses Widgets stehen, im Gegensatz zu isEnabled(), das auch übergeordnete Fenster in Betracht zieht.

Siehe auch setEnabled() und enabled.

bool QWidget::isHidden() const

Gibt true zurück, wenn das Widget versteckt ist, andernfalls false.

Ein verstecktes Widget wird nur sichtbar, wenn show() aufgerufen wird. Es wird nicht automatisch angezeigt, wenn das übergeordnete Widget angezeigt wird.

Um die Sichtbarkeit zu prüfen, verwenden Sie stattdessen !isVisible() (beachten Sie das Ausrufezeichen).

isHidden() impliziert !isVisible(), aber ein Widget kann gleichzeitig nicht sichtbar und nicht versteckt sein. Dies ist der Fall für Widgets, die Kinder von Widgets sind, die nicht sichtbar sind.

Widgets sind versteckt, wenn:

• sie als unabhängige Fenster erstellt wurden,
• sie als Kinder von sichtbaren Widgets erstellt wurden,
• hide() oder setVisible(false) aufgerufen wurde.

bool QWidget::isVisibleTo(const QWidget *ancestor) const

Gibt true zurück, wenn dieses Widget sichtbar werden würde, wenn ancestor eingeblendet wird; andernfalls wird false zurückgegeben.

Der wahre Fall tritt ein, wenn weder das Widget selbst noch ein übergeordnetes Fenster bis auf ancestor explizit verborgen wurde.

Diese Funktion gibt immer noch true zurück, wenn das Widget von anderen Fenstern auf dem Bildschirm verdeckt wird, aber physisch sichtbar sein könnte, wenn es oder diese bewegt werden.

isVisibleTo(0) ist identisch mit isVisible().

Siehe auch show(), hide(), und isVisible().

bool QWidget::isWindow() const

Gibt true zurück, wenn das Widget ein unabhängiges Fenster ist, andernfalls wird false zurückgegeben.

Ein Fenster ist ein Widget, das visuell nicht das Kind eines anderen Widgets ist und das normalerweise einen Rahmen und ein window title hat.

Ein Fenster kann ein parent widget haben. Es wird dann mit seinem Elternteil gruppiert und gelöscht, wenn das Elternteil gelöscht wird, minimiert, wenn das Elternteil minimiert wird usw. Wenn es vom Fenstermanager unterstützt wird, hat es auch einen gemeinsamen Taskleisteneintrag mit seinem Elternteil.

QDialog und QMainWindow Widgets sind standardmäßig Fenster, auch wenn ein übergeordnetes Widget im Konstruktor angegeben ist. Dieses Verhalten wird durch das Qt::Window Flag festgelegt.

Siehe auch window(), isModal(), und parentWidget().

[virtual protected] void QWidget::keyPressEvent(QKeyEvent *event)

Dieser Event-Handler für das Ereignis event kann in einer Unterklasse neu implementiert werden, um Tastendruck-Ereignisse für das Widget zu empfangen.

Ein Widget muss setFocusPolicy() aufrufen, um den Fokus anfangs zu akzeptieren und den Fokus zu haben, um ein Tastendruckereignis zu empfangen.

Wenn Sie diesen Handler neu implementieren, ist es sehr wichtig, dass Sie die Implementierung der Basisklasse aufrufen, wenn Sie nicht auf die Taste reagieren.

Die Standardimplementierung schließt Popup-Widgets, wenn der Benutzer die Tastenfolge für QKeySequence::Cancel drückt (normalerweise die Escape-Taste). Andernfalls wird das Ereignis ignoriert, so dass die übergeordnete Klasse des Widgets es interpretieren kann.

Beachten Sie, dass QKeyEvent mit isAccepted() == true beginnt, so dass Sie nicht QKeyEvent::accept() aufrufen müssen - rufen Sie einfach nicht die Implementierung der Basisklasse auf, wenn Sie auf die Taste reagieren.

Siehe auch keyReleaseEvent(), setFocusPolicy(), focusInEvent(), focusOutEvent(), event(), und QKeyEvent.

[virtual protected] void QWidget::keyReleaseEvent(QKeyEvent *event)

Dieser Ereignishandler für das Ereignis event kann in einer Unterklasse neu implementiert werden, um Tastenfreigabeereignisse für das Widget zu empfangen.

Ein Widget muss zunächst accept focus und have focus aufrufen, um ein Tastenfreigabeereignis zu empfangen.

Wenn Sie diesen Handler neu implementieren, ist es sehr wichtig, dass Sie die Implementierung der Basisklasse aufrufen, wenn Sie nicht auf die Taste reagieren.

Die Standardimplementierung ignoriert das Ereignis, so dass die übergeordnete Klasse des Widgets es interpretieren kann.

Beachten Sie, dass QKeyEvent mit isAccepted() == true beginnt, so dass Sie nicht QKeyEvent::accept() aufrufen müssen - rufen Sie einfach nicht die Implementierung der Basisklasse auf, wenn Sie auf die Taste reagieren.

Siehe auch keyPressEvent(), QEvent::ignore(), setFocusPolicy(), focusInEvent(), focusOutEvent(), event(), und QKeyEvent.

[static] QWidget *QWidget::keyboardGrabber()

Gibt das Widget zurück, das gerade die Tastatureingabe abgreift.

Wenn kein Widget in dieser Anwendung gerade die Tastatur abgreift, wird nullptr zurückgegeben.

Siehe auch grabMouse() und mouseGrabber().

QLayout *QWidget::layout() const

Gibt den Layout-Manager zurück, der auf diesem Widget installiert ist, oder nullptr, wenn kein Layout-Manager installiert ist.

Der Layout-Manager legt die Geometrie der Kinder des Widgets fest, die dem Layout hinzugefügt wurden.

Siehe auch setLayout(), sizePolicy(), und Layout-Verwaltung.

[virtual protected] void QWidget::leaveEvent(QEvent *event)

Dieser Event-Handler kann in einer Unterklasse neu implementiert werden, um Widget Leave-Ereignisse zu empfangen, die im Parameter event übergeben werden.

Ein Verlassen-Ereignis wird an das Widget gesendet, wenn der Mauszeiger das Widget verlässt.

Siehe auch enterEvent(), mouseMoveEvent(), und event().

[slot] void QWidget::lower()

Senkt das Widget an das Ende des Stapels des übergeordneten Widgets.

Nach diesem Aufruf befindet sich das Widget visuell hinter allen überlappenden Geschwisterwidgets (und wird daher von diesen verdeckt).

Siehe auch raise() und stackUnder().

[since 6.0] QPointF QWidget::mapFrom(const QWidget *parent, const QPointF &pos) const

Übersetzt die Widget-Koordinate pos aus dem Koordinatensystem von parent in das Koordinatensystem dieses Widgets. Das parent darf nicht nullptr sein und muss ein Elternteil des aufrufenden Widgets sein.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch mapTo(), mapFromParent(), mapFromGlobal(), und underMouse().

QPoint QWidget::mapFrom(const QWidget *parent, const QPoint &pos) const

Dies ist eine überladene Funktion.

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

Übersetzt die globalen Bildschirmkoordinaten pos in Widget-Koordinaten.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch mapToGlobal(), mapFrom(), und mapFromParent().

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

Dies ist eine überladene Funktion.

[since 6.0] QPointF QWidget::mapFromParent(const QPointF &pos) const

Übersetzt die Koordinaten des übergeordneten Widgets pos in Widget-Koordinaten.

Dasselbe wie mapFromGlobal(), wenn das Widget kein Elternteil hat.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch mapToParent(), mapFrom(), mapFromGlobal(), und underMouse().

QPoint QWidget::mapFromParent(const QPoint &pos) const

Dies ist eine überladene Funktion.

[since 6.0] QPointF QWidget::mapTo(const QWidget *parent, const QPointF &pos) const

Übersetzt die Widget-Koordinate pos in das Koordinatensystem von parent. parent darf nicht nullptr sein und muss ein Elternteil des aufrufenden Widgets sein.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch mapFrom(), mapToParent(), mapToGlobal(), und underMouse().

QPoint QWidget::mapTo(const QWidget *parent, const QPoint &pos) const

Dies ist eine überladene Funktion.

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

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

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch mapFromGlobal(), mapTo(), und mapToParent().

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

Dies ist eine überladene Funktion.

[since 6.0] QPointF QWidget::mapToParent(const QPointF &pos) const

Übersetzt die Widget-Koordinate pos in eine Koordinate im übergeordneten Widget.

Dasselbe wie mapToGlobal(), wenn das Widget kein Elternteil hat.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch mapFromParent(), mapTo(), mapToGlobal(), und underMouse().

QPoint QWidget::mapToParent(const QPoint &pos) const

Dies ist eine überladene Funktion.

QRegion QWidget::mask() const

Gibt die Maske zurück, die derzeit für ein Widget gesetzt ist. Wenn keine Maske gesetzt ist, ist der Rückgabewert ein leerer Bereich.

Siehe auch setMask(), clearMask(), und QRegion::isEmpty().

[override virtual protected] int QWidget::metric(QPaintDevice::PaintDeviceMetric m) const

Reimplements: QPaintDevice::metric(QPaintDevice::PaintDeviceMetric metric) const.

Interne Implementierung der virtuellen Funktion QPaintDevice::metric().

m ist die zu ermittelnde Metrik.

[virtual protected] void QWidget::mouseDoubleClickEvent(QMouseEvent *event)

Dieser Event-Handler für das Ereignis event kann in einer Unterklasse neu implementiert werden, um Maus-Doppelklick-Ereignisse für das Widget zu empfangen.

Die Standardimplementierung ruft mousePressEvent() auf.

Siehe auch mousePressEvent(), mouseReleaseEvent(), mouseMoveEvent(), event(), und QMouseEvent.

[static] QWidget *QWidget::mouseGrabber()

Gibt das Widget zurück, das gerade die Mauseingabe ergreift.

Wenn kein Widget in dieser Anwendung gerade die Maus greift, wird nullptr zurückgegeben.

Siehe auch grabMouse() und keyboardGrabber().

[virtual protected] void QWidget::mouseMoveEvent(QMouseEvent *event)

Dieser Eventhandler für das Ereignis event kann in einer Unterklasse neu implementiert werden, um Mausbewegungsereignisse für das Widget zu empfangen.

Wenn die Mausverfolgung ausgeschaltet ist, treten Mausbewegungsereignisse nur auf, wenn eine Maustaste gedrückt wird, während die Maus bewegt wird. Wenn die Mausverfolgung eingeschaltet ist, treten Mausbewegungsereignisse auch dann auf, wenn keine Maustaste gedrückt wird.

QMouseEvent::pos() meldet die Position des Mauszeigers, relativ zu diesem Widget. Bei Drücken- und Loslassen-Ereignissen ist die Position in der Regel dieselbe wie beim letzten Mausbewegungsereignis, sie kann aber auch anders sein, wenn die Hand des Benutzers zittert. Dies ist eine Eigenschaft des zugrunde liegenden Fenstersystems, nicht von Qt.

Wenn Sie einen Tooltip sofort anzeigen wollen, während sich die Maus bewegt (z.B. um die Mauskoordinaten mit QMouseEvent::pos() zu ermitteln und sie als Tooltip anzuzeigen), müssen Sie zunächst die Mausverfolgung wie oben beschrieben aktivieren. Um sicherzustellen, dass der Tooltip sofort aktualisiert wird, müssen Sie dann QToolTip::showText() statt setToolTip() in Ihrer Implementierung von mouseMoveEvent() aufrufen.

Siehe auch setMouseTracking(), mousePressEvent(), mouseReleaseEvent(), mouseDoubleClickEvent(), event(), QMouseEvent, und Scribble Example.

[virtual protected] void QWidget::mousePressEvent(QMouseEvent *event)

Dieser Event-Handler für das Ereignis event kann in einer Unterklasse neu implementiert werden, um Mausdruckereignisse für das Widget zu empfangen.

Wenn Sie neue Widgets im mousePressEvent() erstellen, kann es sein, dass mouseReleaseEvent() nicht dort landet, wo Sie es erwarten, abhängig vom zugrundeliegenden Fenstersystem (oder X11-Fenstermanager), der Position der Widgets und vielleicht mehr.

Die Standardimplementierung implementiert das Schließen von Popup-Widgets, wenn Sie außerhalb des Fensters klicken. Für andere Widget-Typen tut sie nichts.

Siehe auch mouseReleaseEvent(), mouseDoubleClickEvent(), mouseMoveEvent(), event(), QMouseEvent, und Scribble Example.

[virtual protected] void QWidget::mouseReleaseEvent(QMouseEvent *event)

Dieser Ereignisbehandler für das Ereignis event kann in einer Unterklasse neu implementiert werden, um Mausfreigabeereignisse für das Widget zu empfangen.

Siehe auch mousePressEvent(), mouseDoubleClickEvent(), mouseMoveEvent(), event(), QMouseEvent, und Scribble Example.

void QWidget::move(int x, int y)

Dies ist eine überladene Funktion.

Sie entspricht der Funktion move(QPoint(x, y)).

[virtual protected] void QWidget::moveEvent(QMoveEvent *event)

Dieser Event-Handler kann in einer Unterklasse neu implementiert werden, um Ereignisse zum Verschieben von Widgets zu empfangen, die im Parameter event übergeben werden. Wenn das Widget dieses Ereignis empfängt, befindet es sich bereits an der neuen Position.

Die alte Position ist über QMoveEvent::oldPos() zugänglich.

Siehe auch resizeEvent(), event(), move(), und QMoveEvent.

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

Dieser spezielle Event-Handler kann in einer Unterklasse neu implementiert werden, um native Plattformereignisse zu empfangen, die durch eventType identifiziert und im Parameter message übergeben werden.

Wenn Sie in Ihrer Neuimplementierung dieser Funktion die Behandlung des Ereignisses durch Qt beenden möchten, geben Sie true zurück und setzen Sie result. Der Parameter result hat nur unter Windows eine Bedeutung. Wenn Sie false zurückgeben, wird dieses native Ereignis an Qt zurückgegeben, das das Ereignis in ein Qt-Ereignis übersetzt und es an das Widget sendet.

Siehe auch QAbstractNativeEventFilter.

QWidget *QWidget::nativeParentWidget() const

Gibt das ursprüngliche Elternteil für dieses Widget zurück, d. h. das nächste Vorgänger-Widget, das einen Systembezeichner hat, oder nullptr, wenn es kein eigenes Elternteil hat.

Siehe auch effectiveWinId().

QWidget *QWidget::nextInFocusChain() const

Gibt das nächste Widget in der Fokuskette dieses Widgets zurück.

Siehe auch previousInFocusChain().

void QWidget::overrideWindowFlags(Qt::WindowFlags flags)

Setzt die Fenster-Flags für das Widget auf flags, ohne das Fenstersystem zu informieren.

Siehe auch setWindowFlags().

[override virtual] QPaintEngine *QWidget::paintEngine() const

Reimplements: QPaintDevice::paintEngine() const.

Liefert die Paint-Engine des Widgets.

Beachten Sie, dass diese Funktion nicht explizit vom Benutzer aufgerufen werden sollte, da sie nur für Reimplementierungszwecke gedacht ist. Die Funktion wird von Qt intern aufgerufen, und die Standardimplementierung gibt möglicherweise nicht immer einen gültigen Zeiger zurück.

[virtual protected] void QWidget::paintEvent(QPaintEvent *event)

Dieser Event-Handler kann in einer Unterklasse neu implementiert werden, um Paint-Ereignisse zu empfangen, die in event übergeben werden.

Ein Malereignis ist eine Aufforderung, ein Widget ganz oder teilweise neu zu malen. Dies kann aus einem der folgenden Gründe geschehen:

• repaint() oder update() wurde aufgerufen,
• das Widget war verdeckt und wurde nun wieder aufgedeckt, oder
• viele andere Gründe.

Viele Widgets können einfach ihre gesamte Oberfläche neu malen, wenn sie dazu aufgefordert werden, aber einige langsame Widgets müssen optimiert werden, indem sie nur den angeforderten Bereich malen: QPaintEvent::region(). Diese Geschwindigkeitsoptimierung ändert das Ergebnis nicht, da das Malen während der Ereignisverarbeitung auf diesen Bereich beschränkt wird. QListView und QTableView tun dies zum Beispiel.

Qt versucht auch, das Malen zu beschleunigen, indem es mehrere Malereignisse zu einem einzigen zusammenfasst. Wenn update() mehrmals aufgerufen wird oder das Fenstersystem mehrere Malereignisse sendet, fasst Qt diese Ereignisse zu einem Ereignis mit einem größeren Bereich zusammen (siehe QRegion::united()). Die Funktion repaint() erlaubt diese Optimierung nicht, daher empfehlen wir, wann immer möglich update() zu verwenden.

Wenn das Malereignis eintritt, wurde der Aktualisierungsbereich normalerweise gelöscht, so dass Sie auf den Hintergrund des Widgets malen.

Der Hintergrund kann mit setBackgroundRole() und setPalette() eingestellt werden.

Seit Qt 4.0 puffert QWidget die Malvorgänge automatisch doppelt, so dass es nicht notwendig ist, in paintEvent() Code für die doppelte Pufferung zu schreiben, um Flackern zu vermeiden.

Siehe auch event(), repaint(), update(), QPainter, QPixmap, QPaintEvent, und Analog Clock.

QWidget *QWidget::parentWidget() const

Gibt das übergeordnete Widget dieses Widgets zurück, oder nullptr, wenn es kein übergeordnetes Widget hat.

QWidget *QWidget::previousInFocusChain() const

Die Funktion previousInFocusChain gibt das vorherige Widget in der Fokuskette dieses Widgets zurück.

Siehe auch nextInFocusChain().

[slot] void QWidget::raise()

Erhöht dieses Widget an die Spitze des Stapels des übergeordneten Widgets.

Nach diesem Aufruf befindet sich das Widget visuell vor allen überlappenden Geschwister-Widgets.

Siehe auch lower() und stackUnder().

void QWidget::releaseKeyboard()

Hebt den Tastaturgriff auf.

Siehe auch grabKeyboard(), grabMouse(), und releaseMouse().

void QWidget::releaseMouse()

Hebt den Mausgriff auf.

Siehe auch grabMouse(), grabKeyboard(), und releaseKeyboard().

void QWidget::releaseShortcut(int id)

Entfernt die Tastenkombination mit der angegebenen id aus dem Qt-Verknüpfungssystem. Das Widget empfängt keine QEvent::Shortcut Ereignisse mehr für die Tastenfolge des Shortcuts (es sei denn, es hat andere Shortcuts mit der gleichen Tastenfolge).

Siehe auch grabShortcut() und setShortcutEnabled().

void QWidget::removeAction(QAction *action)

Entfernt die Aktion action aus der Liste der Aktionen in diesem Widget.

Siehe auch insertAction(), actions(), und insertAction().

void QWidget::render(QPaintDevice *target, const QPoint &targetOffset = QPoint(), const QRegion &sourceRegion = QRegion(), QWidget::RenderFlags renderFlags = RenderFlags(DrawWindowBackground | DrawChildren))

Rendert die sourceRegion dieses Widgets in die target unter Verwendung von renderFlags, um zu bestimmen, wie gerendert werden soll. Das Rendern beginnt bei targetOffset in der target. Zum Beispiel:

QPixmap pixmap(widget->size());
widget->render(&pixmap);

Wenn sourceRegion eine Null-Region ist, verwendet diese Funktion QWidget::rect() als Region, d. h. das gesamte Widget.

Stellen Sie sicher, dass Sie QPainter::end() für den aktiven Painter des target Geräts (falls vorhanden) vor dem Rendern aufrufen. Ein Beispiel:

QPainter painter(this);
...
painter.end();
myWidget->render(this);

void QWidget::render(QPainter *painter, const QPoint &targetOffset = QPoint(), const QRegion &sourceRegion = QRegion(), QWidget::RenderFlags renderFlags = RenderFlags(DrawWindowBackground | DrawChildren))

Dies ist eine überladene Funktion.

Rendert das Widget in das painter's QPainter::device().

Die auf painter angewendeten Transformationen und Einstellungen werden beim Rendern verwendet.

Siehe auch QPainter::device().

[slot] void QWidget::repaint()

Zeichnet das Widget direkt neu, indem es paintEvent() sofort aufruft, es sei denn, Aktualisierungen sind deaktiviert oder das Widget ist ausgeblendet.

Wir empfehlen, repaint() nur dann zu verwenden, wenn Sie eine sofortige Neuzeichnung benötigen, zum Beispiel während einer Animation. In den meisten Fällen ist update() besser, da es Qt erlaubt, die Geschwindigkeit zu optimieren und das Flimmern zu minimieren.

Siehe auch update(), paintEvent(), und setUpdatesEnabled().

void QWidget::repaint(const QRect &rect)

Dies ist eine überladene Funktion.

In dieser Version wird ein Rechteck rect innerhalb des Widgets neu gezeichnet.

void QWidget::repaint(const QRegion &rgn)

Dies ist eine überladene Funktion.

In dieser Version wird ein Bereich rgn innerhalb des Widgets neu gezeichnet.

void QWidget::repaint(int x, int y, int w, int h)

Dies ist eine überladene Funktion.

Diese Version malt ein Rechteck (x, y, w, h) innerhalb des Widgets neu.

Wenn w negativ ist, wird es durch width() - x ersetzt, und wenn h negativ ist, wird es durch die Breite height() - y ersetzt.

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

Dies ist eine überladene Funktion.

Sie entspricht der Funktion resize(QSize(w, h)).

[virtual protected] void QWidget::resizeEvent(QResizeEvent *event)

Dieser Event-Handler kann in einer Unterklasse neu implementiert werden, um Widget-Größenänderungsereignisse zu empfangen, die im Parameter event übergeben werden. Wenn resizeEvent() aufgerufen wird, hat das Widget bereits seine neue Geometrie. Die alte Größe ist über QResizeEvent::oldSize() zugänglich.

Das Widget wird gelöscht und erhält unmittelbar nach der Verarbeitung des Größenänderungsereignisses ein Malereignis. Innerhalb dieses Handlers muss (oder sollte) nicht gezeichnet werden.

Siehe auch moveEvent(), event(), resize(), QResizeEvent, paintEvent(), und Scribble Example.

bool QWidget::restoreGeometry(const QByteArray &geometry)

Stellt die Geometrie und den Zustand der Widgets der obersten Ebene wieder her, die im Byte-Array geometry gespeichert sind. Gibt bei Erfolg true zurück, andernfalls false.

Wenn die wiederhergestellte Geometrie außerhalb des Bildschirms liegt, wird sie so geändert, dass sie innerhalb der verfügbaren Bildschirmgeometrie liegt.

Um eine mit QSettings gespeicherte Geometrie wiederherzustellen, können Sie Code wie den folgenden verwenden:

QSettings settings("MyCompany", "MyApp");
myWidget->restoreGeometry(settings.value("myWidget/geometry").toByteArray());

Einen Überblick über die Geometrieprobleme bei Fenstern finden Sie in der Dokumentation Fenstergeometrie.

Verwenden Sie QMainWindow::restoreState(), um die Geometrie und den Zustand von Symbolleisten und Docking-Widgets wiederherzustellen.

Siehe auch saveGeometry(), QSettings, QMainWindow::saveState(), und QMainWindow::restoreState().

QByteArray QWidget::saveGeometry() const

Speichert die aktuelle Geometrie und den Status für Widgets der obersten Ebene.

Um die Geometrie zu speichern, wenn das Fenster geschlossen wird, können Sie ein Schließereignis wie dieses implementieren:

void MyWidget::closeEvent(QCloseEvent *event)
{
    QSettings settings("MyCompany", "MyApp");
    settings.setValue("geometry", saveGeometry());
    QWidget::closeEvent(event);
}

Einen Überblick über Geometrieprobleme bei Fenstern finden Sie in der Dokumentation Fenstergeometrie.

Verwenden Sie QMainWindow::saveState(), um die Geometrie und den Zustand von Symbolleisten und Docking-Widgets zu speichern.

Siehe auch restoreGeometry(), QMainWindow::saveState(), und QMainWindow::restoreState().

QScreen *QWidget::screen() const

Gibt den Bildschirm zurück, auf dem sich das Widget befindet.

Siehe auch setScreen() und windowHandle().

void QWidget::scroll(int dx, int dy)

Scrollt das Widget einschließlich seiner Kinder dx Pixel nach rechts und dy nach unten. Sowohl dx als auch dy können negativ sein.

Nach dem Scrollen erhalten die Widgets Paint-Events für die Bereiche, die neu gezeichnet werden müssen. Bei Widgets, von denen Qt weiß, dass sie undurchsichtig sind, sind dies nur die neu freigelegten Teile. Wenn zum Beispiel ein opakes Widget 8 Pixel nach links gescrollt wird, muss nur ein 8 Pixel breiter Streifen am rechten Rand aktualisiert werden.

Da Widgets standardmäßig den Inhalt ihrer Eltern weitergeben, müssen Sie die Eigenschaft autoFillBackground setzen oder setAttribute() verwenden, um das Attribut Qt::WA_OpaquePaintEvent zu setzen, um ein Widget undurchsichtig zu machen.

Bei Widgets, die die Weitergabe von Inhalten verwenden, führt ein Bildlauf zu einer Aktualisierung des gesamten Bildlaufbereichs.

Siehe auch Transparency and Double Buffering.

void QWidget::scroll(int dx, int dy, const QRect &r)

Dies ist eine überladene Funktion.

Diese Version scrollt nur r und verschiebt nicht die Kinder des Widgets.

Wenn r leer oder ungültig ist, ist das Ergebnis undefiniert.

Siehe auch QScrollArea.

void QWidget::setAttribute(Qt::WidgetAttribute attribute, bool on = true)

Setzt das Attribut attribute für dieses Widget, wenn on wahr ist; andernfalls wird das Attribut gelöscht.

Siehe auch testAttribute().

void QWidget::setBackgroundRole(QPalette::ColorRole role)

Setzt die Hintergrundrolle des Widgets auf role.

Die Hintergrundrolle definiert den Pinsel aus dem palette des Widgets, der zum Rendern des Hintergrunds verwendet wird.

Wenn role gleich QPalette::NoRole ist, dann erbt das Widget die Hintergrundrolle seines Elternteils.

Beachten Sie, dass es den Stilen freisteht, eine beliebige Farbe aus der Palette zu wählen. Sie können die Palette ändern oder eine Stilvorlage festlegen, wenn Sie mit setBackgroundRole() nicht das gewünschte Ergebnis erzielen.

Siehe auch backgroundRole() und foregroundRole().

void QWidget::setBaseSize(int basew, int baseh)

Dies ist eine überladene Funktion.

Sie entspricht setBaseSize(QSize(basew, baseh)). Setzt die Basisgröße des Widgets auf Breite basew und Höhe baseh.

void QWidget::setContentsMargins(int left, int top, int right, int bottom)

Legt die Ränder um den Inhalt des Widgets so fest, dass sie die Größen left, top, right, und bottom haben. Die Ränder werden vom Layoutsystem verwendet und können von Unterklassen verwendet werden, um den Bereich festzulegen, in dem gezeichnet werden soll (z. B. ohne den Rahmen).

Das Ändern der Ränder löst eine resizeEvent() aus.

Siehe auch contentsRect() und contentsMargins().

void QWidget::setContentsMargins(const QMargins &margins)

Dies ist eine überladene Funktion.

Die Funktion setContentsMargins legt die Ränder um den Inhalt des Widgets fest.

Setzt die Ränder um den Inhalt des Widgets so, dass sie die von margins festgelegten Größen haben. Die Ränder werden vom Layoutsystem verwendet und können von Unterklassen verwendet werden, um den Bereich festzulegen, in dem gezeichnet werden soll (z. B. ohne den Rahmen).

Das Ändern der Ränder löst eine resizeEvent() aus.

Siehe auch contentsRect() und contentsMargins().

[slot] void QWidget::setDisabled(bool disable)

Deaktiviert Widget-Eingabeereignisse, wenn disable wahr ist; andernfalls werden Eingabeereignisse aktiviert.

Siehe die Dokumentation enabled für weitere Informationen.

Siehe auch isEnabledTo(), QKeyEvent, QMouseEvent, und changeEvent().

void QWidget::setEditFocus(bool enable)

Wenn enable wahr ist, hat dieses Widget den Bearbeitungsfokus. In diesem Fall werden Qt::Key_Up und Qt::Key_Down normal an das Widget übergeben; andernfalls werden Qt::Key_Up und Qt::Key_Down verwendet, um den Fokus zu ändern.

Dieses Feature ist nur in Qt for Embedded Linux verfügbar.

Siehe auch hasEditFocus() und QApplication::navigationMode().

void QWidget::setFixedHeight(int h)

Setzt sowohl die minimale als auch die maximale Höhe des Widgets auf h, ohne die Breiten zu ändern. Wird der Einfachheit halber bereitgestellt.

Siehe auch sizeHint(), minimumSize(), maximumSize(), und setFixedSize().

void QWidget::setFixedSize(const QSize &s)

Setzt sowohl die minimale als auch die maximale Größe des Widgets auf s und verhindert damit, dass es jemals wächst oder schrumpft.

Dadurch werden die standardmäßigen Größenbeschränkungen, die durch QLayout festgelegt wurden, außer Kraft gesetzt.

Um die Beschränkungen aufzuheben, setzen Sie die Größe auf QWIDGETSIZE_MAX.

Wenn Sie möchten, dass das Widget eine feste Größe hat, die auf seinem Inhalt basiert, können Sie alternativ QLayout::setSizeConstraint(QLayout::SetFixedSize) aufrufen;

Siehe auch maximumSize und minimumSize.

void QWidget::setFixedSize(int w, int h)

Dies ist eine überladene Funktion.

Setzt die Breite des Widgets auf w und die Höhe auf h.

void QWidget::setFixedWidth(int w)

Setzt sowohl die minimale als auch die maximale Breite des Widgets auf w, ohne die Höhen zu ändern. Wird der Einfachheit halber bereitgestellt.

Siehe auch sizeHint(), minimumSize(), maximumSize(), und setFixedSize().

void QWidget::setFocus(Qt::FocusReason reason)

Gibt diesem Widget (oder seinem Fokus-Proxy) den Tastatureingabe-Fokus, wenn dieses Widget oder eines seiner Elternteile das active window ist. Das Argument reason wird an jedes Fokus-Ereignis übergeben, das von dieser Funktion gesendet wird; es wird verwendet, um eine Erklärung dafür zu geben, warum das Widget den Fokus erhalten hat. Wenn das Fenster nicht aktiv ist, erhält das Widget den Fokus, wenn das Fenster aktiv wird.

Zunächst wird ein Fokus-zu-ändern-Ereignis an das Fokus-Widget (falls vorhanden) gesendet, um ihm mitzuteilen, dass es den Fokus verlieren wird. Dann wird der Fokus gewechselt, ein focus out-Ereignis wird an das vorherige Fokuselement gesendet und ein focus in-Ereignis wird an das neue Element gesendet, um ihm mitzuteilen, dass es gerade den Fokus erhalten hat. (Es passiert nichts, wenn die Widgets mit und ohne Fokus identisch sind).

setFocus() gibt einem Widget den Fokus, unabhängig von seiner Fokus-Policy, aber löscht keinen Tastaturgrab (siehe grabKeyboard()).

Seien Sie sich bewusst, dass das Widget, wenn es versteckt ist, den Fokus nicht akzeptiert, bis es eingeblendet wird.

Siehe auch hasFocus(), clearFocus(), focusInEvent(), focusOutEvent(), setFocusPolicy(), focusWidget(), QApplication::focusWidget(), grabKeyboard(), grabMouse(), Tastaturfokus in Widgets, und QEvent::RequestSoftwareInputPanel.

[slot] void QWidget::setFocus()

Dies ist eine überladene Funktion.

Gibt den Tastatureingabefokus an dieses Widget (oder seinen Fokus-Proxy), wenn dieses Widget oder eines seiner Elternteile das active window ist.

void QWidget::setFocusProxy(QWidget *w)

Setzt den Fokus-Proxy des Widgets auf das Widget w. Wenn w nullptr ist, setzt die Funktion dieses Widget so zurück, dass es keinen Fokus-Proxy hat.

Einige Widgets können "den Fokus haben", aber ein untergeordnetes Widget, wie z.B. QLineEdit, erstellen, um den Fokus zu verwalten. In diesem Fall kann das Widget die Zeilenbearbeitung als seinen Fokus-Proxy festlegen.

setFocusProxy() legt das Widget fest, das tatsächlich den Fokus erhält, wenn "dieses Widget" ihn erhält. Wenn es einen Fokus-Proxy gibt, arbeiten setFocus() und hasFocus() mit dem Fokus-Proxy. Wenn "dieses Widget" das Fokus-Widget ist, dann verschiebt setFocusProxy() den Fokus auf den neuen Fokus-Proxy.

Siehe auch focusProxy().

void QWidget::setForegroundRole(QPalette::ColorRole role)

Setzt die Vordergrundrolle des Widgets auf role.

Die Vordergrundrolle definiert die Farbe aus der palette des Widgets, die zum Zeichnen des Vordergrunds verwendet wird.

Wenn role QPalette::NoRole ist, verwendet das Widget eine Vordergrundrolle, die mit der Hintergrundrolle kontrastiert.

Beachten Sie, dass es den Stilen freisteht, eine beliebige Farbe aus der Palette zu wählen. Sie können die Palette ändern oder eine Stilvorlage festlegen, wenn Sie mit setForegroundRole() nicht das gewünschte Ergebnis erzielen.

Siehe auch foregroundRole() und backgroundRole().

void QWidget::setGeometry(int x, int y, int w, int h)

Dies ist eine überladene Funktion.

Sie entspricht der Funktion setGeometry(QRect(x, y, w, h)).

void QWidget::setGraphicsEffect(QGraphicsEffect *effect)

Die Funktion setGraphicsEffect dient zum Einstellen des Grafikeffekts des Widgets.

Setzt effect als den Effekt des Widgets. Wenn bereits ein Effekt auf diesem Widget installiert ist, wird QWidget den bestehenden Effekt löschen, bevor der neue effect installiert wird.

Wenn effect der installierte Effekt auf einem anderen Widget ist, entfernt setGraphicsEffect() den Effekt von diesem Widget und installiert ihn auf diesem Widget.

QWidget übernimmt den Besitz von effect.

Siehe auch graphicsEffect().

[slot] void QWidget::setHidden(bool hidden)

Convenience-Funktion, entspricht setVisible(!hidden).

Siehe auch isHidden().

void QWidget::setLayout(QLayout *layout)

Setzt den Layout-Manager für dieses Widget auf layout.

Wenn bereits ein Layout-Manager auf diesem Widget installiert ist, lässt QWidget Sie keinen weiteren installieren. Sie müssen zuerst den vorhandenen Layout-Manager löschen (zurückgegeben von layout()), bevor Sie setLayout() mit dem neuen Layout aufrufen können.

Wenn layout der Layout-Manager für ein anderes Widget ist, wird setLayout() das Layout reparieren und es zum Layout-Manager für dieses Widget machen.

Beispiel:

    QVBoxLayout *layout = new QVBoxLayout;
    layout->addWidget(formWidget);
    setLayout(layout);

Eine Alternative zum Aufruf dieser Funktion besteht darin, dieses Widget an den Konstruktor des Layouts zu übergeben.

QWidget wird Eigentümer von layout.

Siehe auch layout() und Layout-Verwaltung.

void QWidget::setMask(const QBitmap &bitmap)

Bewirkt, dass nur die Pixel des Widgets sichtbar sind, für die bitmap ein entsprechendes 1-Bit hat. Wenn die Region Pixel außerhalb der rect() des Widgets enthält, können die Steuerelemente des Fenstersystems in diesem Bereich je nach Plattform sichtbar sein oder nicht.

Beachten Sie, dass dieser Effekt langsam sein kann, wenn der Bereich besonders komplex ist.

Der folgende Code zeigt, wie ein Bild mit einem Alphakanal verwendet werden kann, um eine Maske für ein Widget zu erzeugen:

    QLabel topLevelLabel;
    QPixmap pixmap(":/images/tux.png");
    topLevelLabel.setPixmap(pixmap);
    topLevelLabel.setMask(pixmap.mask());

Die in diesem Code gezeigte Beschriftung wird mit dem darin enthaltenen Bild maskiert, wodurch der Eindruck entsteht, dass ein unregelmäßig geformtes Bild direkt auf den Bildschirm gezeichnet wird.

Maskierte Widgets empfangen Mausereignisse nur auf ihren sichtbaren Teilen.

Siehe auch mask(), clearMask(), und windowOpacity().

void QWidget::setMask(const QRegion &region)

Dies ist eine überladene Funktion.

Bewirkt, dass nur die Teile des Widgets, die region überlappen, sichtbar sind. Wenn die Region Pixel außerhalb von rect() des Widgets enthält, können die Steuerelemente des Fenstersystems in diesem Bereich je nach Plattform sichtbar sein oder nicht.

Da QRegion die Erstellung beliebig komplexer Regionen erlaubt, können Widget-Masken so gestaltet werden, dass sie sich den unkonventionellsten Fensterformen anpassen und sogar die Anzeige von Widgets mit Löchern ermöglichen. Beachten Sie, dass dieser Effekt langsam sein kann, wenn die Region besonders komplex ist.

Widgetmasken werden verwendet, um dem Fenstersystem mitzuteilen, dass die Anwendung keine Mausereignisse für Bereiche außerhalb der Maske wünscht. Auf den meisten Systemen führen sie auch zu einer groben visuellen Beschneidung. Um glatte Fensterränder zu erhalten, verwenden Sie stattdessen einen transluzenten Hintergrund und eine Anti-Aliasing-Malerei, wie im Beispiel Transluzenter Hintergrund gezeigt.

Siehe auch windowOpacity.

void QWidget::setMaximumSize(int maxw, int maxh)

Dies ist eine überladene Funktion.

Diese Funktion entspricht der Funktion setMaximumSize(QSize(maxw, maxh)). Setzt die maximale Breite auf maxw und die maximale Höhe auf maxh.

void QWidget::setMinimumSize(int minw, int minh)

Dies ist eine überladene Funktion.

Diese Funktion entspricht setMinimumSize(QSize(minw, minh)). Setzt die Mindestbreite auf minw und die Mindesthöhe auf minh.

void QWidget::setParent(QWidget *parent)

Setzt das Elternteil des Widgets auf parent und setzt die Fensterflags zurück. Das Widget wird an die Position (0, 0) in seinem neuen Elternteil verschoben.

Wenn sich das neue übergeordnete Widget in einem anderen Fenster befindet, werden das reparierte Widget und seine Kinder an das Ende von tab chain des neuen übergeordneten Widgets angehängt, in der gleichen internen Reihenfolge wie zuvor. Wenn eines der verschobenen Widgets den Tastaturfokus hatte, ruft setParent() clearFocus() für dieses Widget auf.

Befindet sich das neue übergeordnete Widget im selben Fenster wie das alte übergeordnete Widget, ändert das Setzen des übergeordneten Widgets weder die Tabulatorreihenfolge noch den Tastaturfokus.

Wenn das "neue" übergeordnete Widget das alte übergeordnete Widget ist, bewirkt diese Funktion nichts.

Siehe auch setWindowFlags().

void QWidget::setParent(QWidget *parent, Qt::WindowFlags f)

Dies ist eine überladene Funktion.

Diese Funktion nimmt auch Widget-Flags, f als Argument.

void QWidget::setScreen(QScreen *screen)

Setzt den Bildschirm, auf dem das Widget angezeigt werden soll, auf screen.

Die Einstellung des Bildschirms ist nur für Fenster sinnvoll. Falls erforderlich, wird das Fenster des Widgets auf screen neu erstellt.

Siehe auch screen() und QWindow::setScreen().

void QWidget::setShortcutAutoRepeat(int id, bool enable = true)

Wenn enable true ist, wird die automatische Wiederholung der Verknüpfung mit der angegebenen id aktiviert; andernfalls ist sie deaktiviert.

Siehe auch grabShortcut() und releaseShortcut().

void QWidget::setShortcutEnabled(int id, bool enable = true)

Wenn enable true ist, wird die Verknüpfung mit der angegebenen id aktiviert; andernfalls wird die Verknüpfung deaktiviert.

Siehe auch grabShortcut() und releaseShortcut().

void QWidget::setSizeIncrement(int w, int h)

Dies ist eine überladene Funktion.

Setzt das x (Breite) Größeninkrement auf w und das y (Höhe) Größeninkrement auf h.

void QWidget::setSizePolicy(QSizePolicy::Policy horizontal, QSizePolicy::Policy vertical)

Dies ist eine überladene Funktion.

Setzt die Größenpolitik des Widgets auf horizontal und vertical, mit Standard-Stretch und ohne Höhe-für-Breite.

Siehe auch QSizePolicy::QSizePolicy().

void QWidget::setStyle(QStyle *style)

Setzt den GUI-Stil des Widgets auf style. Der Besitz des Stilobjekts wird nicht übertragen.

Wenn kein Stil gesetzt ist, verwendet das Widget stattdessen den Stil der Anwendung QApplication::style().

Das Setzen des Stils eines Widgets hat keine Auswirkung auf bestehende oder zukünftige Kind-Widgets.

Siehe auch style(), QStyle, QApplication::style(), und QApplication::setStyle().

[static] void QWidget::setTabOrder(QWidget *first, QWidget *second)

Setzt das Widget second in der Fokusreihenfolge hinter das Widget first.

Dadurch wird das Widget second aus seiner Fokuskette entfernt und nach dem Widget first eingefügt.

Beachten Sie, dass Sie die Kette wie folgt anordnen sollten, da die Tabulatorreihenfolge des Widgets second geändert wird:

setTabOrder(a, b); // a to b
setTabOrder(b, c); // a to b to c
setTabOrder(c, d); // a to b to c to d

und nicht wie hier:

// WRONG
setTabOrder(c, d); // c to d
setTabOrder(a, b); // a to b AND c to d
setTabOrder(b, c); // a to b to c, but not c to d

Wenn first oder second einen Fokus-Proxy hat, ersetzt setTabOrder() den Proxy korrekt.

Siehe auch setFocusPolicy(), setFocusProxy(), und Tastaturfokus in Widgets.

[static, since 6.6] void QWidget::setTabOrder(std::initializer_list<QWidget *> widgets)

Dies ist eine überladene Funktion.

Legt die Tabulatorreihenfolge für die Widgets in der Liste widgets fest, indem sie QWidget::setTabOrder(QWidget *, QWidget *) für jedes aufeinanderfolgende Paar von Widgets aufruft.

Anstatt jedes Paar manuell zu setzen wie hier:

setTabOrder(a, b); // a to b
setTabOrder(b, c); // a to b to c
setTabOrder(c, d); // a to b to c to d

können Sie aufrufen:

setTabOrder({a, b, c, d}); // a to b to c to d

Der Aufruf erzeugt keine geschlossene Tabulator-Fokus-Schleife. Wenn es mehrere Widgets mit Qt::TabFocus Fokus-Policy gibt, wird der Tabulator auf d den Fokus zu einem dieser Widgets verschieben, nicht zurück zu a.

Diese Funktion wurde in Qt 6.6 eingeführt.

Siehe auch setFocusPolicy(), setFocusProxy(), und Tastaturfokus in Widgets.

void QWidget::setWindowFlag(Qt::WindowType flag, bool on = true)

Setzt das Fenster-Flag flag auf diesem Widget, wenn on wahr ist; andernfalls wird das Flag gelöscht.

Siehe auch setWindowFlags(), windowFlags(), und windowType().

void QWidget::setWindowRole(const QString &role)

Setzt die Rolle des Fensters auf role. Dies ist nur für Fenster unter X11 sinnvoll.

Siehe auch windowRole().

void QWidget::setWindowState(Qt::WindowStates windowState)

Setzt den Fensterstatus auf windowState. Der Fensterstatus ist eine ODER-Kombination aus Qt::WindowState: Qt::WindowMinimized, Qt::WindowMaximized, Qt::WindowFullScreen, und Qt::WindowActive.

Wenn das Fenster nicht sichtbar ist (d.h. isVisible() gibt false zurück), wird der Fensterstatus wirksam, wenn show() aufgerufen wird. Bei sichtbaren Fenstern erfolgt die Änderung sofort. Um beispielsweise zwischen dem Vollbildmodus und dem normalen Modus umzuschalten, verwenden Sie den folgenden Code:

w->setWindowState(w->windowState() ^ Qt::WindowFullScreen);

Um ein minimiertes Fenster wiederherzustellen und zu aktivieren (unter Beibehaltung seines maximierten und/oder bildschirmfüllenden Zustands), verwenden Sie den folgenden Code:

w->setWindowState((w->windowState() & ~Qt::WindowMinimized) | Qt::WindowActive);

Durch den Aufruf dieser Funktion wird das Widget ausgeblendet. Sie müssen show() aufrufen, um das Widget wieder sichtbar zu machen.

Wenn sich der Zustand des Fensters ändert, erhält das Widget eine changeEvent() vom Typ QEvent::WindowStateChange.

Siehe auch Qt::WindowState und windowState().

void QWidget::setupUi(QWidget *widget)

Richtet die Benutzeroberfläche für das angegebene widget ein.

Siehe auch Verwendung einer Designer UI-Datei in Ihrer Anwendung.

[slot] void QWidget::show()

Zeigt das Widget und seine untergeordneten Widgets an.

Für untergeordnete Fenster ist dies gleichbedeutend mit dem Aufruf von setVisible(true). Andernfalls ist es gleichbedeutend mit dem Aufruf von showFullScreen(), showMaximized() oder setVisible(true), je nach dem Standardverhalten der Plattform für die Fensterflags.

Siehe auch raise(), showEvent(), hide(), setVisible(), showMinimized(), showMaximized(), showNormal(), isVisible(), und windowFlags().

[virtual protected] void QWidget::showEvent(QShowEvent *event)

Dieser Event-Handler kann in einer Unterklasse neu implementiert werden, um Show-Ereignisse von Widgets zu empfangen, die mit dem Parameter event übergeben werden.

Nicht-spontane Show-Ereignisse werden an Widgets gesendet, unmittelbar bevor sie angezeigt werden. Die spontanen Show-Ereignisse von Fenstern werden danach geliefert.

Hinweis: Ein Widget erhält spontane Show- und Hide-Ereignisse, wenn sein Zuordnungsstatus vom Fenstersystem geändert wird, z. B. ein spontanes Hide-Ereignis, wenn der Benutzer das Fenster minimiert, und ein spontanes Show-Ereignis, wenn das Fenster wiederhergestellt wird. Nach dem Empfang eines spontanen Ausblendungsereignisses wird ein Widget weiterhin als sichtbar im Sinne von isVisible() betrachtet.

Siehe auch visible, event(), und QShowEvent.

[slot] void QWidget::showFullScreen()

Zeigt das Widget im Vollbildmodus an.

Der Aufruf dieser Funktion wirkt sich nur auf windows aus.

Um aus dem Vollbildmodus zurückzukehren, rufen Sie showNormal() oder close() auf.

Eine Alternative wäre, den Fenstermanager komplett zu umgehen und ein Fenster mit dem Qt::X11BypassWindowManagerHint Flag zu erstellen. Dies bringt jedoch andere schwerwiegende Probleme mit sich, wie z.B. die Unterbrechung des Tastaturfokus und sehr seltsame Effekte bei Änderungen auf dem Desktop oder wenn der Benutzer andere Fenster hochzieht.

X11-Fenstermanager, die den modernen Post-ICCCM-Spezifikationen folgen, unterstützen den Vollbildmodus korrekt.

Unter macOS versetzt das Anzeigen eines Fensters im Vollbildmodus die gesamte Anwendung in den Vollbildmodus und stellt ihr einen eigenen Schreibtisch zur Verfügung. Wenn ein anderes Fenster angezeigt wird, während die Anwendung im Vollbildmodus läuft, wird dieses Fenster möglicherweise automatisch ebenfalls zum Vollbild. Um dies zu verhindern, beenden Sie den Vollbildmodus durch den Aufruf von showNormal() oder durch close() auf dem Vollbildfenster, bevor Sie ein anderes Fenster anzeigen.

Siehe auch showNormal(), showMaximized(), show(), isVisible(), und close().

[slot] void QWidget::showMaximized()

Zeigt das Widget maximiert an.

Der Aufruf dieser Funktion betrifft nur windows.

Unter X11 kann diese Funktion bei bestimmten Fenstermanagern nicht richtig funktionieren. Siehe die Dokumentation Window Geometry für eine Erklärung.

Siehe auch setWindowState(), showNormal(), showMinimized(), show(), hide(), und isVisible().

[slot] void QWidget::showMinimized()

Zeigt das Widget minimiert als Symbol an.

Der Aufruf dieser Funktion wirkt sich nur auf windows aus.

Siehe auch showNormal(), showMaximized(), show(), hide(), isVisible(), und isMinimized().

[slot] void QWidget::showNormal()

Stellt das Widget wieder her, nachdem es maximiert oder minimiert worden ist.

Der Aufruf dieser Funktion wirkt sich nur auf windows aus.

Siehe auch setWindowState(), showMinimized(), showMaximized(), show(), hide(), und isVisible().

void QWidget::stackUnder(QWidget *w)

Platziert das Widget unter w im Stapel des übergeordneten Widgets.

Damit dies funktioniert, müssen das Widget selbst und w Geschwister sein.

Siehe auch raise() und lower().

QStyle *QWidget::style() const

Siehe auch QWidget::setStyle(), QApplication::setStyle(), und QApplication::style().

[virtual protected] void QWidget::tabletEvent(QTabletEvent *event)

Dieser Event-Handler für das Ereignis event kann in einer Unterklasse neu implementiert werden, um Tablet-Ereignisse für das Widget zu empfangen.

Wenn Sie diesen Handler neu implementieren, ist es sehr wichtig, dass Sie ignore() das Ereignis, wenn Sie es nicht behandeln, so dass die Eltern des Widgets es interpretieren können.

Die Standardimplementierung ignoriert das Ereignis.

Wenn die Tablettenverfolgung ausgeschaltet ist, treten Tablettenbewegungsereignisse nur dann auf, wenn der Stift in Kontakt mit dem Tablett ist oder mindestens eine Stifttaste gedrückt wird, während der Stift bewegt wird. Wenn die Tablettenverfolgung eingeschaltet ist, treten Tablettenbewegungsereignisse auch dann auf, wenn der Stift in der Nähe des Tabletts schwebt, ohne dass Tasten gedrückt werden.

Siehe auch QEvent::ignore(), QEvent::accept(), event(), setTabletTracking(), und QTabletEvent.

bool QWidget::testAttribute(Qt::WidgetAttribute attribute) const

Gibt true zurück, wenn das Attribut attribute für dieses Widget gesetzt ist; andernfalls wird false zurückgegeben.

Siehe auch setAttribute().

bool QWidget::underMouse() const

Gibt true zurück, wenn sich das Widget unter dem Mauszeiger befindet; andernfalls wird false zurückgegeben.

Dieser Wert wird bei Drag&Drop-Vorgängen nicht richtig aktualisiert.

Siehe auch enterEvent() und leaveEvent().

void QWidget::ungrabGesture(Qt::GestureType gesture)

Meldet das Widget von einem bestimmten gesture Typ ab.

Siehe auch grabGesture() und QGestureEvent.

[slot] void QWidget::update()

Aktualisiert das Widget, es sei denn, Updates sind deaktiviert oder das Widget ist versteckt.

Diese Funktion führt nicht zu einem sofortigen Neuanstrich, sondern plant ein Malereignis für die Verarbeitung, wenn Qt zur Hauptereignisschleife zurückkehrt. Dies erlaubt Qt, mehr Geschwindigkeit und weniger Flimmern zu erreichen als bei einem Aufruf von repaint().

Ein mehrmaliger Aufruf von update() resultiert normalerweise in nur einem paintEvent()-Aufruf.

Qt löscht normalerweise den Bereich des Widgets vor dem Aufruf von paintEvent(). Wenn das Qt::WA_OpaquePaintEvent Widget-Attribut gesetzt ist, ist das Widget dafür verantwortlich, alle seine Pixel mit einer opaken Farbe zu malen.

Siehe auch repaint(), paintEvent(), setUpdatesEnabled(), und Analog Clock.

void QWidget::update(const QRect &rect)

Dies ist eine überladene Funktion.

Diese Version aktualisiert ein Rechteck rect innerhalb des Widgets.

void QWidget::update(const QRegion &rgn)

Dies ist eine überladene Funktion.

In dieser Version wird ein Bereich rgn innerhalb des Widgets neu gezeichnet.

void QWidget::update(int x, int y, int w, int h)

Dies ist eine überladene Funktion.

Diese Version aktualisiert ein Rechteck (x, y, w, h) innerhalb des Widgets.

void QWidget::updateGeometry()

Benachrichtigt das Layoutsystem, dass sich dieses Widget geändert hat und möglicherweise eine andere Geometrie benötigt.

Rufen Sie diese Funktion auf, wenn sich sizeHint() oder sizePolicy() geändert haben.

Für explizit ausgeblendete Widgets ist updateGeometry() ein No-op. Das Layoutsystem wird benachrichtigt, sobald das Widget angezeigt wird.

[protected slot] void QWidget::updateMicroFocus(Qt::InputMethodQuery query = Qt::ImQueryAll)

Aktualisiert den Mikrofokus des Widgets und informiert die Eingabemethoden, dass sich der durch query angegebene Zustand geändert hat.

QRegion QWidget::visibleRegion() const

Gibt den nicht verdeckten Bereich zurück, in dem Malereignisse auftreten können.

Bei sichtbaren Widgets ist dies ein Näherungswert für den Bereich, der nicht von anderen Widgets bedeckt wird; andernfalls ist dies ein leerer Bereich.

Die Funktion repaint() ruft diese Funktion bei Bedarf auf, so dass Sie sie im Allgemeinen nicht aufrufen müssen.

[virtual protected] void QWidget::wheelEvent(QWheelEvent *event)

Dieser Event-Handler für das Ereignis event kann in einer Unterklasse neu implementiert werden, um Rad-Ereignisse für das Widget zu empfangen.

Wenn Sie diesen Handler neu implementieren, ist es sehr wichtig, dass Sie ignore() das Ereignis, wenn Sie es nicht behandeln, so dass die Eltern des Widgets es interpretieren können.

Die Standardimplementierung ignoriert das Ereignis.

Siehe auch QEvent::ignore(), QEvent::accept(), event(), und QWheelEvent.

WId QWidget::winId() const

Gibt den Fenstersystembezeichner des Widgets zurück.

Im Prinzip portabel, aber wenn Sie es verwenden, sind Sie wahrscheinlich dabei, etwas nicht-Portables zu tun. Seien Sie vorsichtig.

Wenn ein Widget nicht nativ (fremd) ist und winId() für dieses Widget aufgerufen wird, erhält dieses Widget ein natives Handle.

Dieser Wert kann sich während der Laufzeit ändern. Ein Ereignis des Typs QEvent::WinIdChange wird an das Widget gesendet, wenn sich der Window System Identifier ändert.

Siehe auch find().

QWidget *QWidget::window() const

Gibt das Fenster für dieses Widget zurück, d.h. das nächste Vorgänger-Widget, das einen Fenstersystem-Rahmen hat (oder haben könnte).

Wenn das Widget ein Fenster ist, wird das Widget selbst zurückgegeben.

Typische Verwendung ist das Ändern des Fenstertitels:

aWidget->window()->setWindowTitle("New Window Title");

Siehe auch isWindow().

QWindow *QWidget::windowHandle() const

Wenn dies ein natives Widget ist, wird das zugehörige QWindow zurückgegeben. Andernfalls wird null zurückgegeben.

Native Widgets umfassen Toplevel-Widgets, QGLWidget und Child-Widgets, auf denen winId() aufgerufen wurde.

Siehe auch winId() und screen().