Base class for any widget that can be shown as a inline panel. More...

#include <qgspanelwidget.h>

Inheritance diagram for QgsPanelWidget:

[legend]

Public Slots
void	acceptPanel ()
	Accept the panel.

void	openPanel (QgsPanelWidget *panel)
	Open a panel or dialog depending on dock mode setting If dock mode is `true` this method will emit the showPanel signal for connected slots to handle the open event.

Signals
void	panelAccepted (QgsPanelWidget *panel)
	Emitted when the panel is accepted by the user.

void	showPanel (QgsPanelWidget *panel)
	Emit when you require a panel to be show in the interface.

void	widgetChanged ()
	Emitted when the widget state changes.

Public Member Functions
	QgsPanelWidget (QWidget *parent=nullptr)
	Base class for any widget that can be shown as a inline panel.

virtual bool	applySizeConstraintsToStack () const
	Returns `true` if the size constraints and hints for the panel widget should be applied to the parent QgsPanelWidgetStack which this panel is shown in.

bool	autoDelete ()
	The the auto delete property on the widget.

void	connectChildPanel (QgsPanelWidget *panel)
	Connect the given sub panel widgets showPanel signals to this current panels main showPanel event to bubble up to the user.

void	connectChildPanels (const QList< QgsPanelWidget * > &panels)
	Connect the given sub panel widgets showPanel signals to this current panels main showPanel event to bubble up to the user.

bool	dockMode ()
	Returns the dock mode state.

virtual QMenu *	menuButtonMenu ()
	Returns the menu to use for the menu button for this panel, or `nullptr` if no menu button is required.

virtual QString	menuButtonTooltip () const
	Returns the (translated) tooltip text to use for the menu button for this panel.

QString	panelTitle ()
	The title of the panel.

void	setAutoDelete (bool autoDelete)
	The the auto delete property on the widget.

virtual void	setDockMode (bool dockMode)
	Set the widget in dock mode which tells the widget to emit panel widgets and not open dialogs.

void	setPanelTitle (const QString &panelTitle)
	Set the title of the panel when shown in the interface.

Static Public Member Functions
static QgsPanelWidget *	findParentPanel (QWidget *widget)
	Traces through the parents of a widget to find if it is contained within a QgsPanelWidget widget.

Protected Member Functions
void	keyPressEvent (QKeyEvent *event) override
	Overridden key press event to handle the esc event on the widget.

Detailed Description

Base class for any widget that can be shown as a inline panel.

Definition at line 29 of file qgspanelwidget.h.

Constructor & Destructor Documentation

◆ QgsPanelWidget()

QgsPanelWidget::QgsPanelWidget ( QWidget * parent = nullptr )

Base class for any widget that can be shown as a inline panel.

Parameters

parent Parent widget.

Definition at line 25 of file qgspanelwidget.cpp.

Member Function Documentation

◆ acceptPanel

void QgsPanelWidget::acceptPanel ( )

slot

Accept the panel.

Causes panelAccepted to be emitted. Widgets are normally removed form the interface using the panel manager or the caller.

Definition at line 113 of file qgspanelwidget.cpp.

◆ applySizeConstraintsToStack()

bool QgsPanelWidget::applySizeConstraintsToStack ( ) const

virtual

Returns true if the size constraints and hints for the panel widget should be applied to the parent QgsPanelWidgetStack which this panel is shown in.

The default behavior is to return false.

Since: QGIS 3.20

Reimplemented in QgsTemporalControllerWidget.

Definition at line 50 of file qgspanelwidget.cpp.

◆ autoDelete()

bool QgsPanelWidget::autoDelete ( )

inline

The the auto delete property on the widget.

true by default. When auto delete is enabled when a panel is removed from the stack it will be deleted.

Returns: The auto delete value for the widget.

Definition at line 109 of file qgspanelwidget.h.

◆ connectChildPanel()

void QgsPanelWidget::connectChildPanel ( QgsPanelWidget * panel )

Connect the given sub panel widgets showPanel signals to this current panels main showPanel event to bubble up to the user.

Use this method if you have children widgets that need to show a panel to the user.

Parameters

panel The panel to connect.

Definition at line 39 of file qgspanelwidget.cpp.

◆ connectChildPanels()

void QgsPanelWidget::connectChildPanels ( const QList< QgsPanelWidget * > & panels )

Connect the given sub panel widgets showPanel signals to this current panels main showPanel event to bubble up to the user.

Use this method if you have children widgets that need to show a panel to the user.

Parameters

panels A list of panel widgets to connect.

Definition at line 30 of file qgspanelwidget.cpp.

◆ dockMode()

bool QgsPanelWidget::dockMode ( )

inline

Returns the dock mode state.

Returns: true if in dock mode. If in dock mode the widget will emit the showPanel signal to handle panel opening If false it will open dialogs when openPanel is called.

Definition at line 93 of file qgspanelwidget.h.

◆ findParentPanel()

QgsPanelWidget * QgsPanelWidget::findParentPanel ( QWidget * widget )

static

Traces through the parents of a widget to find if it is contained within a QgsPanelWidget widget.

Parameters

widget widget which may be contained within a panel widget

Returns: parent panel widget if found, otherwise nullptr

Definition at line 55 of file qgspanelwidget.cpp.

◆ keyPressEvent()

void QgsPanelWidget::keyPressEvent ( QKeyEvent * event )

overrideprotected

Overridden key press event to handle the esc event on the widget.

Parameters

event The key event

Definition at line 118 of file qgspanelwidget.cpp.

◆ menuButtonMenu()

QMenu * QgsPanelWidget::menuButtonMenu ( )

virtual

Returns the menu to use for the menu button for this panel, or nullptr if no menu button is required.

Since: QGIS 3.12

Reimplemented in QgsLabelEngineConfigWidget.

Definition at line 80 of file qgspanelwidget.cpp.

◆ menuButtonTooltip()

QString QgsPanelWidget::menuButtonTooltip ( ) const

virtual

Returns the (translated) tooltip text to use for the menu button for this panel.

This is only used when the panel returns a menuButtonMenu().

Since: QGIS 3.12

Reimplemented in QgsLabelEngineConfigWidget.

Definition at line 75 of file qgspanelwidget.cpp.

◆ openPanel

void QgsPanelWidget::openPanel ( QgsPanelWidget * panel )

slot

Open a panel or dialog depending on dock mode setting If dock mode is true this method will emit the showPanel signal for connected slots to handle the open event.

If dock mode is false this method will open a dialog and block the user.

Parameters

panel The panel widget to open.

Definition at line 85 of file qgspanelwidget.cpp.

◆ panelAccepted

void QgsPanelWidget::panelAccepted ( QgsPanelWidget * panel )

signal

Emitted when the panel is accepted by the user.

Parameters

panel The panel widget that was accepted.

Note: This argument is normally raised with emit panelAccepted(this) so that callers can retrieve the widget easier in calling code.; this is emitted only when this panel is accepted, and is not emitted for child panels. For example, if this panel opens a second stacked panel, then this panel will not emit panelAccepted when the second panel is accepted.

◆ panelTitle()

QString QgsPanelWidget::panelTitle ( )

inline

The title of the panel.

Returns: The title pf the panel.

Definition at line 50 of file qgspanelwidget.h.

◆ setAutoDelete()

void QgsPanelWidget::setAutoDelete ( bool autoDelete )

inline

The the auto delete property on the widget.

true by default. When auto delete is enabled when a panel is removed from the stack it will be deleted.

Parameters

autoDelete Enable or disable auto delete on the panel.

Definition at line 101 of file qgspanelwidget.h.

◆ setDockMode()

void QgsPanelWidget::setDockMode ( bool dockMode )

virtual

Set the widget in dock mode which tells the widget to emit panel widgets and not open dialogs.

Parameters

dockMode true to enable dock mode.

Reimplemented in QgsPointCloudRendererPropertiesWidget, QgsTiledSceneRendererPropertiesWidget, QgsRuleBasedLabelingWidget, QgsLabelingRulePropsWidget, QgsMeshLabelingWidget, QgsPropertyAssistantWidget, QgsTextFormatPanelWidget, QgsInvertedPolygonRendererWidget, QgsLayerPropertiesWidget, QgsMergedFeatureRendererWidget, QgsRendererWidget, QgsRuleBasedRendererWidget, QgsSingleSymbolRendererWidget, and QgsDiagramProperties.

Definition at line 45 of file qgspanelwidget.cpp.

◆ setPanelTitle()

void QgsPanelWidget::setPanelTitle ( const QString & panelTitle )

inline

Set the title of the panel when shown in the interface.

Parameters

panelTitle The panel title.

Definition at line 44 of file qgspanelwidget.h.

◆ showPanel

void QgsPanelWidget::showPanel ( QgsPanelWidget * panel )

signal

Emit when you require a panel to be show in the interface.

Parameters

panel The panel widget to show.

Note: If you are connected to this signal you should also connect given panels showPanel signal as they can be nested.

◆ widgetChanged

void QgsPanelWidget::widgetChanged ( )

signal

Emitted when the widget state changes.

Connect to this to pull any changes off the widget when needed. As panels are non blocking "dialogs" you should listen to this signal to give the user feedback when something changes.

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

/build/qgis-3.41.0+git20241119+45a0abf3bec+99sid/src/gui/qgspanelwidget.h
/build/qgis-3.41.0+git20241119+45a0abf3bec+99sid/src/gui/qgspanelwidget.cpp

Public Slots

Signals

Public Member Functions

Static Public Member Functions

Protected Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ QgsPanelWidget()

Member Function Documentation

◆ acceptPanel

◆ applySizeConstraintsToStack()

◆ autoDelete()

◆ connectChildPanel()

◆ connectChildPanels()

◆ dockMode()

◆ findParentPanel()

◆ keyPressEvent()

◆ menuButtonMenu()

◆ menuButtonTooltip()

◆ openPanel

◆ panelAccepted

◆ panelTitle()

◆ setAutoDelete()

◆ setDockMode()

◆ setPanelTitle()

◆ showPanel

◆ widgetChanged