QGIS API Documentation 3.39.0-Master (e8f1b343c48)
|
A base class for property widgets for layout items. More...
#include <qgslayoutitemwidget.h>
Public Member Functions | |
QgsLayoutItemBaseWidget (QWidget *parent SIP_TRANSFERTHIS, QgsLayoutObject *layoutObject) | |
Constructor for QgsLayoutItemBaseWidget, linked with the specified layoutObject. | |
QgsLayoutObject * | layoutObject () |
Returns the layout object associated with this widget. | |
virtual void | setDesignerInterface (QgsLayoutDesignerInterface *iface) |
Sets the the layout designer interface in which the widget is being shown. | |
bool | setItem (QgsLayoutItem *item) |
Sets the current item to show in the widget. | |
virtual void | setMasterLayout (QgsMasterLayoutInterface *masterLayout) |
Sets the master layout associated with the item. | |
virtual void | setReportTypeString (const QString &string) |
Sets the string to use to describe the current report type (e.g. | |
Public Member Functions inherited from QgsPanelWidget | |
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. | |
Protected Member Functions | |
QgsVectorLayer * | coverageLayer () const |
Returns the current layout context coverage layer (if set). | |
QgsLayoutAtlas * | layoutAtlas () const |
Returns the atlas for the layout (if available) | |
void | registerDataDefinedButton (QgsPropertyOverrideButton *button, QgsLayoutObject::DataDefinedProperty property) |
Registers a data defined button, setting up its initial value, connections and description. | |
virtual bool | setNewItem (QgsLayoutItem *item) |
Attempts to update the widget to show the properties for the specified item. | |
void | updateDataDefinedButton (QgsPropertyOverrideButton *button) |
Updates a previously registered data defined button to reflect the item's current properties. | |
Protected Member Functions inherited from QgsPanelWidget | |
void | keyPressEvent (QKeyEvent *event) override |
Overridden key press event to handle the esc event on the widget. | |
Additional Inherited Members | |
Public Slots inherited from QgsPanelWidget | |
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 inherited from QgsPanelWidget | |
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. | |
Static Public Member Functions inherited from QgsPanelWidget | |
static QgsPanelWidget * | findParentPanel (QWidget *widget) |
Traces through the parents of a widget to find if it is contained within a QgsPanelWidget widget. | |
A base class for property widgets for layout items.
All layout item widgets should inherit from this base class.
Definition at line 120 of file qgslayoutitemwidget.h.
QgsLayoutItemBaseWidget::QgsLayoutItemBaseWidget | ( | QWidget *parent | SIP_TRANSFERTHIS, |
QgsLayoutObject * | layoutObject | ||
) |
Constructor for QgsLayoutItemBaseWidget, linked with the specified layoutObject.
Definition at line 189 of file qgslayoutitemwidget.cpp.
|
protected |
Returns the current layout context coverage layer (if set).
Definition at line 257 of file qgslayoutitemwidget.cpp.
|
protected |
Returns the atlas for the layout (if available)
Definition at line 267 of file qgslayoutitemwidget.cpp.
QgsLayoutObject * QgsLayoutItemBaseWidget::layoutObject | ( | ) |
Returns the layout object associated with this widget.
Definition at line 197 of file qgslayoutitemwidget.cpp.
|
protected |
Registers a data defined button, setting up its initial value, connections and description.
The corresponding property key must be specified.
Definition at line 247 of file qgslayoutitemwidget.cpp.
|
virtual |
Sets the the layout designer interface in which the widget is being shown.
Reimplemented in QgsLayoutElevationProfileWidget, and QgsLayoutMapWidget.
Definition at line 228 of file qgslayoutitemwidget.cpp.
bool QgsLayoutItemBaseWidget::setItem | ( | QgsLayoutItem * | item | ) |
Sets the current item to show in the widget.
If true
is returned, item was an acceptable type for display in this widget and the widget has been updated to match item's properties.
If false
is returned, then the widget could not be successfully updated to show the properties of item.
Definition at line 202 of file qgslayoutitemwidget.cpp.
|
virtual |
Sets the master layout associated with the item.
Reimplemented in QgsLayoutAttributeTableWidget, QgsLayoutElevationProfileWidget, QgsLayoutHtmlWidget, QgsLayoutLabelWidget, QgsLayoutManualTableWidget, QgsLayoutMapWidget, QgsLayoutMarkerWidget, QgsLayoutPictureWidget, QgsLayoutPolygonWidget, QgsLayoutPolylineWidget, QgsLayoutScaleBarWidget, and QgsLayoutShapeWidget.
Definition at line 242 of file qgslayoutitemwidget.cpp.
|
protectedvirtual |
Attempts to update the widget to show the properties for the specified item.
Subclasses can override this if they support changing items in place.
Implementations must return true
if the item was accepted and the widget was updated.
Reimplemented in QgsLayoutMapLabelingWidget, QgsLayoutMapClippingWidget, QgsLayoutAttributeTableWidget, QgsLayoutElevationProfileWidget, QgsLayoutHtmlWidget, QgsLayoutLabelWidget, QgsLayoutManualTableWidget, QgsLayoutMapWidget, QgsLayoutMarkerWidget, QgsLayoutPictureWidget, QgsLayoutPolygonWidget, QgsLayoutPolylineWidget, QgsLayoutScaleBarWidget, and QgsLayoutShapeWidget.
Definition at line 262 of file qgslayoutitemwidget.cpp.
|
virtual |
Sets the string to use to describe the current report type (e.g.
"atlas" or "report"). Subclasses which display this text to users should override this and update their widget labels accordingly.
Reimplemented in QgsLayoutAttributeTableWidget, QgsLayoutElevationProfileWidget, QgsLayoutMapWidget, and QgsLayoutMapClippingWidget.
Definition at line 224 of file qgslayoutitemwidget.cpp.
|
protected |
Updates a previously registered data defined button to reflect the item's current properties.
Definition at line 252 of file qgslayoutitemwidget.cpp.