QGIS API Documentation 3.28.0-Firenze (ed3ad0430f)
Public Member Functions | List of all members
QgsPropertyAssistantWidget Class Reference

Shows a user-friendly assistant guiding users through the creation of QgsProperty overrides. More...

#include <qgspropertyassistantwidget.h>

Inheritance diagram for QgsPropertyAssistantWidget:
Inheritance graph
[legend]

Public Member Functions

 QgsPropertyAssistantWidget (QWidget *parent=nullptr, const QgsPropertyDefinition &definition=QgsPropertyDefinition(), const QgsProperty &initialState=QgsProperty(), const QgsVectorLayer *layer=nullptr)
 Constructor for QgsPropertyAssistantWidget. More...
 
void registerExpressionContextGenerator (QgsExpressionContextGenerator *generator)
 Register an expression context generator class that will be used to retrieve an expression context for the button when required. More...
 
void setDockMode (bool dockMode) override
 Set the widget in dock mode which tells the widget to emit panel widgets and not open dialogs. More...
 
void setSymbol (std::shared_ptr< QgsSymbol > symbol)
 Sets a symbol which can be used for previews inside the widget. More...
 
void updateProperty (QgsProperty &property)
 Updates a property in place to corresponding to the current settings shown in the widget. More...
 
- Public Member Functions inherited from QgsPanelWidget
 QgsPanelWidget (QWidget *parent=nullptr)
 Base class for any widget that can be shown as a inline panel. More...
 
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. More...
 
bool autoDelete ()
 The the auto delete property on the widget. More...
 
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. More...
 
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. More...
 
bool dockMode ()
 Returns the dock mode state. More...
 
virtual QMenu * menuButtonMenu ()
 Returns the menu to use for the menu button for this panel, or nullptr if no menu button is required. More...
 
virtual QString menuButtonTooltip () const
 Returns the (translated) tooltip text to use for the menu button for this panel. More...
 
QString panelTitle ()
 The title of the panel. More...
 
void setAutoDelete (bool autoDelete)
 The the auto delete property on the widget. More...
 
virtual void setDockMode (bool dockMode)
 Set the widget in dock mode which tells the widget to emit panel widgets and not open dialogs. More...
 
void setPanelTitle (const QString &panelTitle)
 Set the title of the panel when shown in the interface. More...
 

Additional Inherited Members

- Public Slots inherited from QgsPanelWidget
void acceptPanel ()
 Accept the panel. More...
 
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. More...
 
- Signals inherited from QgsPanelWidget
void panelAccepted (QgsPanelWidget *panel)
 Emitted when the panel is accepted by the user. More...
 
void showPanel (QgsPanelWidget *panel)
 Emit when you require a panel to be show in the interface. More...
 
void widgetChanged ()
 Emitted when the widget state changes. More...
 
- Static Public Member Functions inherited from QgsPanelWidget
static QgsPanelWidgetfindParentPanel (QWidget *widget)
 Traces through the parents of a widget to find if it is contained within a QgsPanelWidget widget. More...
 
- Protected Member Functions inherited from QgsPanelWidget
void keyPressEvent (QKeyEvent *event) override
 Overridden key press event to handle the esc event on the widget. More...
 

Detailed Description

Shows a user-friendly assistant guiding users through the creation of QgsProperty overrides.

Since
QGIS 3.0

Definition at line 114 of file qgspropertyassistantwidget.h.

Constructor & Destructor Documentation

◆ QgsPropertyAssistantWidget()

QgsPropertyAssistantWidget::QgsPropertyAssistantWidget ( QWidget *  parent = nullptr,
const QgsPropertyDefinition definition = QgsPropertyDefinition(),
const QgsProperty initialState = QgsProperty(),
const QgsVectorLayer layer = nullptr 
)

Constructor for QgsPropertyAssistantWidget.

Aside from a parent widget, the constructor accepts a corresponding property definition from which it customizes the displayed options (eg a color based property definition will show an assistant to allow creation of color based properties). The initialState dictates the initial state to show in the widget. A corresponding layer can also be set to allow population of GUI widgets such as field selectors.

Definition at line 31 of file qgspropertyassistantwidget.cpp.

Member Function Documentation

◆ registerExpressionContextGenerator()

void QgsPropertyAssistantWidget::registerExpressionContextGenerator ( QgsExpressionContextGenerator generator)

Register an expression context generator class that will be used to retrieve an expression context for the button when required.

Definition at line 143 of file qgspropertyassistantwidget.cpp.

◆ setDockMode()

void QgsPropertyAssistantWidget::setDockMode ( bool  dockMode)
overridevirtual

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

Parameters
dockModetrue to enable dock mode.

Reimplemented from QgsPanelWidget.

Definition at line 172 of file qgspropertyassistantwidget.cpp.

◆ setSymbol()

void QgsPropertyAssistantWidget::setSymbol ( std::shared_ptr< QgsSymbol symbol)
inline

Sets a symbol which can be used for previews inside the widget.

If not specified, default created symbols will be used instead.

Note
not available in Python bindings

Definition at line 149 of file qgspropertyassistantwidget.h.

◆ updateProperty()

void QgsPropertyAssistantWidget::updateProperty ( QgsProperty property)

Updates a property in place to corresponding to the current settings shown in the widget.

Definition at line 149 of file qgspropertyassistantwidget.cpp.


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