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

#include <qgsdockwidget.h>

Inheritance diagram for QgsDockWidget:

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 (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...

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::QgsDockWidget	(	QWidget *	parent = `nullptr`,
		Qt::WindowFlags	flags = `nullptr`
	)

explicit

Constructor for QgsDockWidget.

Parameters

parent	parent widget
flags	window flags

Definition at line 23 of file qgsdockwidget.cpp.

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

explicit

Constructor for QgsDockWidget.

Parameters

title	dock title
parent	parent widget
flags	window flags

Definition at line 29 of file qgsdockwidget.cpp.

Member Function Documentation

void QgsDockWidget::closed ( )

signal

Emitted when dock widget is closed.

See also: closedStateChanged(); opened()

void QgsDockWidget::closedStateChanged ( bool wasClosed )

signal

Emitted when dock widget is closed (or opened).

Parameters

wasClosed will be true if dock widget was closed, or false if dock widget was opened

See also: closed(); openedStateChanged()

void QgsDockWidget::closeEvent ( QCloseEvent * e )

overrideprotected

Definition at line 82 of file qgsdockwidget.cpp.

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.

void QgsDockWidget::opened ( )

signal

Emitted when dock widget is opened.

See also: openedStateChanged(); closed()

void QgsDockWidget::openedStateChanged ( bool wasOpened )

signal

Emitted when dock widget is opened (or closed).

Parameters

wasOpened will be true if dock widget was opened, or false if dock widget was closed

See also: closedStateChanged(); opened()

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.

void QgsDockWidget::setUserVisible ( bool visible )

slot

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

Parameters

visible

set 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.

void QgsDockWidget::showEvent ( QShowEvent * event )

overrideprotected

Definition at line 90 of file qgsdockwidget.cpp.

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.

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:

/build/qgis-3.4.15+24xenial/src/gui/qgsdockwidget.h
/build/qgis-3.4.15+24xenial/src/gui/qgsdockwidget.cpp

Public Slots

Signals

Public Member Functions

Protected Member Functions

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation