QDockWidget Class

Member Function Dokumentation

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

Konstruiert ein QDockWidget mit dem Elternteil parent und den Fensterflags flags. Das Dock-Widget wird im linken Bereich des Dock-Widgets platziert.

[explicit] QDockWidget::QDockWidget(const QString &title, QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())

Konstruiert ein QDockWidget mit dem Elternteil parent und den Fensterflags flags. Das DockWidget wird im linken DockWidget-Bereich platziert.

Der Fenstertitel wird auf title gesetzt. Dieser Titel wird verwendet, wenn das QDockWidget angedockt und abgedockt wird. Er wird auch in dem von QMainWindow bereitgestellten Kontextmenü verwendet.

Siehe auch setWindowTitle().

[virtual noexcept] QDockWidget::~QDockWidget()

Zerstört das Dock-Widget.

[signal] void QDockWidget::allowedAreasChanged(Qt::DockWidgetAreas allowedAreas)

Dieses Signal wird ausgesendet, wenn sich die Eigenschaft allowedAreas ändert. Der Parameter allowedAreas gibt den neuen Wert der Eigenschaft an.

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

Reimplements: QWidget::changeEvent(QEvent *Event).

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

Reimplements: QWidget::closeEvent(QCloseEvent *event).

[signal] void QDockWidget::dockLocationChanged(Qt::DockWidgetArea area)

Dieses Signal wird ausgegeben, wenn das Dock-Widget in ein anderes Dock area oder an eine andere Stelle in seinem aktuellen Dockbereich verschoben wird. Dies geschieht, wenn das Dock-Widget programmatisch verschoben wird oder vom Benutzer an eine neue Position gezogen wird.

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

Reimplements: QWidget::event(QEvent *Event).

[signal] void QDockWidget::featuresChanged(QDockWidget::DockWidgetFeatures features)

Dieses Signal wird ausgesendet, wenn sich die Eigenschaft features ändert. Der Parameter features gibt den neuen Wert der Eigenschaft an.

[virtual protected] void QDockWidget::initStyleOption(QStyleOptionDockWidget *option) const

Initialisieren Sie option mit den Werten aus dieser QDockWidget. Diese Methode ist nützlich für Unterklassen, wenn sie eine QStyleOptionDockWidget benötigen, aber nicht alle Informationen selbst eingeben wollen.

Siehe auch QStyleOption::initFrom().

bool QDockWidget::isAreaAllowed(Qt::DockWidgetArea area) const

Gibt true zurück, wenn dieses Dock-Widget in der angegebenen area platziert werden kann; andernfalls wird false zurückgegeben.

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

Reimplements: QWidget::paintEvent(QPaintEvent *event).

void QDockWidget::setTitleBarWidget(QWidget *widget)

Setzt eine beliebige widget als Titelleiste des Dock-Widgets. Wenn widget nullptr ist, wird jedes benutzerdefinierte Titelleisten-Widget, das zuvor für das Dock-Widget festgelegt wurde, entfernt, aber nicht gelöscht, und stattdessen wird die Standard-Titelleiste verwendet.

Wenn ein Titelleisten-Widget gesetzt ist, verwendet QDockWidget keine nativen Fensterdekorationen, wenn es schwebend ist.

Hier sind einige Tipps für die Implementierung eigener Titelleisten:

• Mausereignisse, die nicht explizit durch das Titelleisten-Widget behandelt werden, müssen durch den Aufruf von QMouseEvent::ignore() ignoriert werden. Diese Ereignisse werden dann an das übergeordnete Widget QDockWidget weitergeleitet, das sie auf die übliche Weise behandelt: Bewegen, wenn die Titelleiste gezogen wird, Andocken und Abdocken, wenn sie doppelt angeklickt wird, usw.
• Wenn DockWidgetVerticalTitleBar auf QDockWidget gesetzt wird, wird das Titelleisten-Widget entsprechend neu positioniert. In resizeEvent() sollte die Titelleiste prüfen, welche Ausrichtung sie annehmen soll:

  QDockWidget *dockWidget = qobject_cast<QDockWidget*>(parentWidget());
  if (dockWidget->features() & QDockWidget::DockWidgetVerticalTitleBar) {
      // I need to be vertical
  } else {
      // I need to be horizontal
  }

• Das Titelleisten-Widget muss eine gültige QWidget::sizeHint() und QWidget::minimumSizeHint() haben. Diese Funktionen sollten die aktuelle Ausrichtung der Titelleiste berücksichtigen.
• Es ist nicht möglich, eine Titelleiste aus einem Docking Widget zu entfernen. Ein ähnlicher Effekt kann jedoch erzielt werden, indem ein standardmäßig konstruiertes QWidget als Titelleisten-Widget festgelegt wird.

Durch die Verwendung von qobject_cast() wie oben gezeigt, hat das Titelleisten-Widget vollen Zugriff auf seine übergeordnete QDockWidget. Daher kann es Operationen wie das Andocken und Ausblenden als Reaktion auf Benutzeraktionen durchführen.

Siehe auch titleBarWidget() und DockWidgetVerticalTitleBar.

void QDockWidget::setWidget(QWidget *widget)

Setzt das Widget für das Dock-Widget auf widget.

Wenn das Dock-Widget sichtbar ist, wenn widget hinzugefügt wird, müssen Sie es explizit show().

Beachten Sie, dass Sie das Layout von widget hinzufügen müssen, bevor Sie diese Funktion aufrufen; andernfalls wird widget nicht sichtbar sein.

Siehe auch widget().

QWidget *QDockWidget::titleBarWidget() const

Gibt das benutzerdefinierte Titelleisten-Widget zurück, das auf QDockWidget festgelegt wurde, oder nullptr, wenn keine benutzerdefinierte Titelleiste festgelegt wurde.

Siehe auch setTitleBarWidget().

QAction *QDockWidget::toggleViewAction() const

Gibt eine ankreuzbare Aktion zurück, die zu Menüs und Symbolleisten hinzugefügt werden kann, damit der Benutzer dieses Andock-Widget anzeigen oder schließen kann.

Der Text der Aktion wird auf den Fenstertitel des Docking-Widgets gesetzt.

Das Objekt QAction ist Eigentum des QDockWidget. Es wird automatisch gelöscht, wenn das QDockWidget zerstört wird.

Siehe auch QAction::text und QWidget::windowTitle.

[signal] void QDockWidget::topLevelChanged(bool topLevel)

Dieses Signal wird ausgesendet, wenn sich die Eigenschaft floating ändert. Der Parameter topLevel ist true, wenn das Dock-Widget jetzt schwebend ist; andernfalls ist er false.

Siehe auch isWindow().

[signal] void QDockWidget::visibilityChanged(bool visible)

Dieses Signal wird ausgegeben, wenn das Docking Widget visible (oder unsichtbar) wird. Dies geschieht, wenn das Widget ein- oder ausgeblendet wird, sowie wenn es in einem Andockbereich mit Registerkarten angedockt ist und seine Registerkarte ausgewählt oder nicht ausgewählt wird.

QWidget *QDockWidget::widget() const

Gibt das Widget für das Andock-Widget zurück. Diese Funktion gibt Null zurück, wenn das Widget nicht gesetzt wurde.

Siehe auch setWidget().