QGIS API Documentation  3.18.1-Zürich (202f1bf7e5)
Public Slots | Signals | Public Member Functions | Protected Member Functions | List of all members
QgsDockWidget Class Reference

QgsDockWidget subclass with more fine-grained control over how the widget is closed or opened. More...

#include <qgsdockwidget.h>

Inheritance diagram for QgsDockWidget:
Inheritance graph
[legend]

Public Slots

void setUserVisible (bool visible)
 Sets the dock widget as visible to a user, ie both shown and raised to the front. More...
 
void toggleUserVisible ()
 Toggles whether the dock is user visible. More...
 

Signals

void closed ()
 Emitted when dock widget is closed. More...
 
void closedStateChanged (bool wasClosed)
 Emitted when dock widget is closed (or opened). More...
 
void opened ()
 Emitted when dock widget is opened. More...
 
void openedStateChanged (bool wasOpened)
 Emitted when dock widget is opened (or closed). More...
 

Public Member Functions

 QgsDockWidget (const QString &title, QWidget *parent=nullptr, Qt::WindowFlags flags=Qt::WindowFlags())
 Constructor for QgsDockWidget. More...
 
 QgsDockWidget (QWidget *parent=nullptr, Qt::WindowFlags flags=Qt::WindowFlags())
 Constructor for QgsDockWidget. More...
 
bool isUserVisible () const
 Returns true if the dock is both opened and raised to the front (ie not hidden by any other tabs. More...
 
void setToggleVisibilityAction (QAction *action)
 Links an action to the dock, so that toggling the action will automatically set the dock's visibility to suit (and changing the dock visibility will update the action's state). More...
 
QAction * toggleVisibilityAction ()
 Returns the action linked to the dock. More...
 

Protected Member Functions

void closeEvent (QCloseEvent *) override
 
void showEvent (QShowEvent *event) override
 

Detailed Description

QgsDockWidget subclass with more fine-grained control over how the widget is closed or opened.

Since
QGIS 2.16

Definition at line 31 of file qgsdockwidget.h.

Constructor & Destructor Documentation

◆ QgsDockWidget() [1/2]

QgsDockWidget::QgsDockWidget ( QWidget *  parent = nullptr,
Qt::WindowFlags  flags = Qt::WindowFlags() 
)
explicit

Constructor for QgsDockWidget.

Parameters
parentparent widget
flagswindow flags

Definition at line 23 of file qgsdockwidget.cpp.

◆ QgsDockWidget() [2/2]

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

Constructor for QgsDockWidget.

Parameters
titledock title
parentparent widget
flagswindow flags

Definition at line 29 of file qgsdockwidget.cpp.

Member Function Documentation

◆ closed

void QgsDockWidget::closed ( )
signal

Emitted when dock widget is closed.

See also
closedStateChanged()
opened()

◆ closedStateChanged

void QgsDockWidget::closedStateChanged ( bool  wasClosed)
signal

Emitted when dock widget is closed (or opened).

Parameters
wasClosedwill be true if dock widget was closed, or false if dock widget was opened
See also
closed()
openedStateChanged()

◆ closeEvent()

void QgsDockWidget::closeEvent ( QCloseEvent *  e)
overrideprotected

Definition at line 82 of file qgsdockwidget.cpp.

◆ isUserVisible()

bool QgsDockWidget::isUserVisible ( ) const

Returns true if the dock is both opened and raised to the front (ie not hidden by any other tabs.

See also
setUserVisible()
toggleUserVisible()

Definition at line 56 of file qgsdockwidget.cpp.

◆ opened

void QgsDockWidget::opened ( )
signal

Emitted when dock widget is opened.

See also
openedStateChanged()
closed()

◆ openedStateChanged

void QgsDockWidget::openedStateChanged ( bool  wasOpened)
signal

Emitted when dock widget is opened (or closed).

Parameters
wasOpenedwill be true if dock widget was opened, or false if dock widget was closed
See also
closedStateChanged()
opened()

◆ setToggleVisibilityAction()

void QgsDockWidget::setToggleVisibilityAction ( QAction *  action)

Links an action to the dock, so that toggling the action will automatically set the dock's visibility to suit (and changing the dock visibility will update the action's state).

See also
toggleVisibilityAction()
Since
QGIS 3.4

Definition at line 61 of file qgsdockwidget.cpp.

◆ setUserVisible

void QgsDockWidget::setUserVisible ( bool  visible)
slot

Sets the dock widget as visible to a user, ie both shown and raised to the front.

Parameters
visibleset to true to show the dock to the user, or false to hide the dock. When setting a dock as user visible, the dock will be opened (if it is not already opened) and raised to the front. When setting as hidden, the following logic is used:
  • hiding a dock which is open but not raised (ie hidden by another tab) will have no effect, and the dock will still be opened and hidden by the other tab
  • hiding a dock which is open and raised (ie, user visible) will cause the dock to be closed
  • hiding a dock which is closed has no effect and raises no signals
See also
isUserVisible()
toggleUserVisible()

Definition at line 35 of file qgsdockwidget.cpp.

◆ showEvent()

void QgsDockWidget::showEvent ( QShowEvent *  event)
overrideprotected

Definition at line 90 of file qgsdockwidget.cpp.

◆ toggleUserVisible

void QgsDockWidget::toggleUserVisible ( )
slot

Toggles whether the dock is user visible.

If the dock is not currently user visible (i.e. opened and activated as a tab) then the dock will be opened and raised. If it is currently user visible it will be closed.

See also
setUserVisible()
isUserVisible()
Since
QGIS 3.2

Definition at line 51 of file qgsdockwidget.cpp.

◆ toggleVisibilityAction()

QAction * QgsDockWidget::toggleVisibilityAction ( )

Returns the action linked to the dock.

See also
setToggleVisibilityAction()
Since
QGIS 3.4

Definition at line 77 of file qgsdockwidget.cpp.


The documentation for this class was generated from the following files: