QDockWidget Class

Dokumentation der Member-Funktionen

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

Erstellt ein QDockWidget mit dem übergeordneten Element „ parent “ und den Fensterflags „ flags “. Das Dock-Widget wird im linken Dock-Bereich platziert.

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

Erstellt ein QDockWidget mit dem übergeordneten parent und den Fensterflags flags. Das Dock-Widget wird im linken Dock-Bereich platziert.

Der Fenstertitel wird auf „ title “ gesetzt. Dieser Titel wird verwendet, wenn das QDockWidget angedockt und abgedockt wird. Er wird außerdem im Kontextmenü verwendet, das von „ QMainWindow “ bereitgestellt wird.

Siehe auch setWindowTitle().

[virtual noexcept] QDockWidget::~QDockWidget()

Löscht das Dock-Widget.

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

Dieses Signal wird ausgelöst, wenn sich die Eigenschaft „ allowedAreas “ ändert. Der Parameter „ allowedAreas “ gibt den neuen Wert der Eigenschaft an.

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

Umsetzt: ` QWidget::changeEvent(QEvent *event)`.

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

Umsetzt: ` QWidget::closeEvent(QCloseEvent *event)`.

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

Dieses Signal wird ausgelöst, wenn das Dock-Widget in ein anderes Dock area verschoben oder an eine andere Position innerhalb seines aktuellen Dock-Bereichs verschoben wird. Dies geschieht, wenn das Dock-Widget programmgesteuert verschoben oder vom Benutzer an eine neue Position gezogen wird.

Siehe auch „ dockLocation()“ und „ setDockLocation()“.

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

Umsetzt: ` QWidget::event(QEvent *event)`.

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

Dieses Signal wird ausgelöst, 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 Datei: QDockWidget. Diese Methode ist für Unterklassen nützlich, wenn diese ein ` QStyleOptionDockWidget` benötigen, aber nicht alle Informationen selbst eingeben möchten.

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)

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

[since 6.9] void QDockWidget::setDockLocation(Qt::DockWidgetArea area)

Weist diesem Dock-Widget die Position „ area “ zu. Wenn es an einer anderen Dock-Position angedockt ist, wird es an die Position „ area “ verschoben. Wenn es frei schwebend ist oder Teil frei schwebender Registerkarten ist, wird es beim nächsten Aufruf von „ setFloating(false)“ an die Position „ area “ angedockt.

Diese Funktion wurde in Qt 6.9 eingeführt.

Siehe auch „ dockLocation()“ und „ dockLocationChanged()“.

void QDockWidget::setTitleBarWidget(QWidget *widget)

Legt ein beliebiges „ widget “ als Titelleiste des Dock-Widgets fest. Wenn „ widget “ auf „ nullptr “ gesetzt ist, wird jedes zuvor für das Dock-Widget festgelegte benutzerdefinierte Titelleisten-Widget entfernt, jedoch nicht gelöscht, und stattdessen wird die Standard-Titelleiste verwendet.

Wenn ein Titelleisten-Widget festgelegt ist, verwendet „ QDockWidget “ keine nativen Fensterdekorationen, wenn es frei positioniert wird.

Hier sind einige Tipps zur Implementierung benutzerdefinierter Titelleisten:

• Mausereignisse, die nicht explizit vom Titelleisten-Widget verarbeitet werden, müssen durch den Aufruf von ` QMouseEvent::ignore()` ignoriert werden. Diese Ereignisse werden dann an das übergeordnete ` QDockWidget `-Element weitergeleitet, das sie auf die übliche Weise verarbeitet: Verschieben beim Ziehen der Titelleiste, Andocken und Abdocken beim Doppelklick usw.
• Wenn für ` QDockWidget` die Eigenschaft ` DockWidgetVerticalTitleBar ` gesetzt ist, 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 über gültige Funktionen ` QWidget::sizeHint()` und ` QWidget::minimumSizeHint()` verfügen. Diese Funktionen sollten die aktuelle Ausrichtung der Titelleiste berücksichtigen.
• Es ist nicht möglich, eine Titelleiste aus einem Dock-Widget zu entfernen. Ein ähnlicher Effekt lässt sich jedoch erzielen, indem ein standardmäßig konstruiertes ` QWidget ` als Titelleisten-Widget festgelegt wird.

Bei Verwendung von ` qobject_cast()` wie oben gezeigt hat das Titelleisten-Widget vollen Zugriff auf sein übergeordnetes ` QDockWidget`. Daher kann es als Reaktion auf Benutzeraktionen Vorgänge wie das Andocken und Ausblenden ausfü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 mit „ show()“ ausblenden.

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

Siehe auch ` widget()`.

QWidget *QDockWidget::titleBarWidget() const

Gibt das für die „ QDockWidget “ festgelegte benutzerdefinierte Titelleisten-Widget zurück oder „ nullptr “, falls keine benutzerdefinierte Titelleiste festgelegt wurde.

Siehe auch setTitleBarWidget().

QAction *QDockWidget::toggleViewAction() const

Gibt eine „Checkable“-Aktion zurück, die zu Menüs und Symbolleisten hinzugefügt werden kann, damit der Benutzer dieses Dock-Widget ein- oder ausblenden kann.

Der Text der Aktion entspricht dem Fenstertitel des Dock-Widgets.

Das Objekt „ QAction “ gehört zum „ 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 ausgelöst, wenn sich die Eigenschaft „ floating “ ändert. Der Parameter „ topLevel “ ist „true“, wenn das Dock-Widget nun frei schwebend ist; andernfalls ist er „false“.

Siehe auch „ isWindow()“.

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

Dieses Signal wird ausgelöst, wenn das Dock-Widget „ visible “ (oder unsichtbar) wird. Dies geschieht, wenn das Widget ausgeblendet oder eingeblendet wird, sowie wenn es in einem Dock-Bereich mit Registerkarten angedockt ist und die zugehörige Registerkarte ausgewählt oder die Auswahl aufgehoben wird.

QWidget *QDockWidget::widget() const

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

Siehe auch „ setWidget()“.