QGIS API Documentation  3.0.2-Girona (307d082)
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...
 

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 (QWidget *parent=nullptr, Qt::WindowFlags flags=nullptr)
 Constructor for QgsDockWidget. More...
 
 QgsDockWidget (const QString &title, QWidget *parent=nullptr, Qt::WindowFlags flags=nullptr)
 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...
 

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 = nullptr 
)
explicit

Constructor for QgsDockWidget.

Parameters
parentparent widget
flagswindow flags

Definition at line 22 of file qgsdockwidget.cpp.

◆ QgsDockWidget() [2/2]

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

Constructor for QgsDockWidget.

Parameters
titledock title
parentparent widget
flagswindow flags

Definition at line 28 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 55 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()

Definition at line 50 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()

◆ 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()

Definition at line 34 of file qgsdockwidget.cpp.

◆ showEvent()

void QgsDockWidget::showEvent ( QShowEvent *  event)
overrideprotected

Definition at line 63 of file qgsdockwidget.cpp.


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