mirror of
https://github.com/qgis/QGIS.git
synced 2025-10-06 00:07:29 -04:00
259 lines
8.2 KiB
Plaintext
259 lines
8.2 KiB
Plaintext
/************************************************************************
|
|
* This file has been generated automatically from *
|
|
* *
|
|
* src/gui/qgspropertyoverridebutton.h *
|
|
* *
|
|
* Do not edit manually ! Edit header and run scripts/sipify.py again *
|
|
************************************************************************/
|
|
|
|
|
|
|
|
|
|
class QgsPropertyOverrideButton : QToolButton
|
|
{
|
|
%Docstring(signature="appended")
|
|
A button for controlling property overrides which may apply to a widget.
|
|
|
|
:py:class:`QgsPropertyOverrideButton` is designed to be used alongside
|
|
the QGIS properties framework (:py:class:`QgsProperty`,
|
|
:py:class:`QgsPropertyDefinition` and
|
|
:py:class:`QgsPropertyCollection`).
|
|
|
|
It allows users to specify field or expression based overrides which
|
|
should be applied to a property of an object. Eg, this widget is used
|
|
for controlling data defined overrides in symbology, labeling and
|
|
layouts.
|
|
%End
|
|
|
|
%TypeHeaderCode
|
|
#include "qgspropertyoverridebutton.h"
|
|
%End
|
|
public:
|
|
QgsPropertyOverrideButton( QWidget *parent /TransferThis/ = 0, const QgsVectorLayer *layer = 0 );
|
|
%Docstring
|
|
Constructor for QgsPropertyOverrideButton.
|
|
|
|
:param parent: parent widget
|
|
:param layer: associated vector layer
|
|
%End
|
|
|
|
void init( int propertyKey, const QgsProperty &property, const QgsPropertiesDefinition &definitions, const QgsVectorLayer *layer = 0, bool auxiliaryStorageEnabled = false );
|
|
%Docstring
|
|
Initialize a newly constructed property button (useful if button was
|
|
included in a UI layout).
|
|
|
|
:param propertyKey: key for corresponding property
|
|
:param property: initial value of associated property to show in widget
|
|
:param definitions: properties definitions for corresponding collection
|
|
:param layer: associated vector layer
|
|
:param auxiliaryStorageEnabled: If ``True``, activate the button to
|
|
store data defined in auxiliary storage
|
|
%End
|
|
|
|
void init( int propertyKey, const QgsProperty &property, const QgsPropertyDefinition &definition, const QgsVectorLayer *layer = 0, bool auxiliaryStorageEnabled = false );
|
|
%Docstring
|
|
Initialize a newly constructed property button (useful if button was
|
|
included in a UI layout).
|
|
|
|
:param propertyKey: key for corresponding property
|
|
:param property: initial value of associated property to show in widget
|
|
:param definition: properties definition for button
|
|
:param layer: associated vector layer
|
|
:param auxiliaryStorageEnabled: If ``True``, activate the button to
|
|
store data defined in auxiliary storage
|
|
%End
|
|
|
|
void init( int propertyKey, const QgsAbstractPropertyCollection &collection, const QgsPropertiesDefinition &definitions, const QgsVectorLayer *layer = 0, bool auxiliaryStorageEnabled = false );
|
|
%Docstring
|
|
Initialize a newly constructed property button (useful if button was
|
|
included in a UI layout).
|
|
|
|
:param propertyKey: key for corresponding property
|
|
:param collection: associated property collection
|
|
:param definitions: properties definitions for collection
|
|
:param layer: associated vector layer
|
|
:param auxiliaryStorageEnabled: If ``True``, activate the button to
|
|
store data defined in auxiliary storage
|
|
%End
|
|
|
|
QgsProperty toProperty() const;
|
|
%Docstring
|
|
Returns a :py:class:`QgsProperty` object encapsulating the current state
|
|
of the widget.
|
|
|
|
.. seealso:: :py:func:`setToProperty`
|
|
%End
|
|
|
|
void setToProperty( const QgsProperty &property );
|
|
%Docstring
|
|
Sets the widget to reflect the current state of a
|
|
:py:class:`QgsProperty`.
|
|
%End
|
|
|
|
int propertyKey() const;
|
|
%Docstring
|
|
Returns the property key linked to the button.
|
|
%End
|
|
|
|
bool isActive() const;
|
|
%Docstring
|
|
Returns ``True`` if the button has an active property.
|
|
%End
|
|
|
|
QgsPropertyDefinition::DataType validDataType() const;
|
|
%Docstring
|
|
Returns the data type which the widget will accept. This is used to
|
|
filter out fields from the associated vector layer to only show fields
|
|
which are compatible with the property.
|
|
%End
|
|
|
|
QString fullDescription() const;
|
|
%Docstring
|
|
Returns the full definition description and current definition
|
|
(internally generated on a contextual basis).
|
|
%End
|
|
|
|
QString usageInfo() const;
|
|
%Docstring
|
|
Returns usage information for the property.
|
|
|
|
.. seealso:: :py:func:`setUsageInfo`
|
|
%End
|
|
|
|
void setUsageInfo( const QString &info );
|
|
%Docstring
|
|
Set the usage information for the property.
|
|
|
|
.. seealso:: :py:func:`usageInfo`
|
|
%End
|
|
|
|
void setVectorLayer( const QgsVectorLayer *layer );
|
|
%Docstring
|
|
Sets the vector layer associated with the button. This controls which
|
|
fields are displayed within the widget's pop up menu.
|
|
|
|
.. seealso:: :py:func:`vectorLayer`
|
|
%End
|
|
|
|
const QgsVectorLayer *vectorLayer() const;
|
|
%Docstring
|
|
Returns the vector layer associated with the button. This controls which
|
|
fields are displayed within the widget's pop up menu.
|
|
|
|
.. seealso:: :py:func:`setVectorLayer`
|
|
%End
|
|
|
|
void registerCheckedWidget( QWidget *widget, bool natural = true );
|
|
%Docstring
|
|
Register a sibling ``widget`` that gets checked when the property is
|
|
active. if ``natural`` is ``False``, widget gets unchecked when the
|
|
property is active.
|
|
|
|
.. note::
|
|
|
|
this should be called after calling :py:func:`~QgsPropertyOverrideButton.init` to be correctly initialized.
|
|
%End
|
|
|
|
void registerEnabledWidget( QWidget *widget, bool natural = true );
|
|
%Docstring
|
|
Register a sibling ``widget`` that gets enabled when the property is
|
|
active, and disabled when the property is inactive. if ``natural`` is
|
|
``False``, widget gets disabled when the property is active, and enabled
|
|
when the property is inactive.
|
|
|
|
.. note::
|
|
|
|
this should be called after calling :py:func:`~QgsPropertyOverrideButton.init` to be correctly initialized.
|
|
%End
|
|
|
|
void registerVisibleWidget( QWidget *widget, bool natural = true );
|
|
%Docstring
|
|
Register a sibling ``widget`` that gets visible when the property is
|
|
active, and hidden when the property is inactive. if ``natural`` is
|
|
``False``, widget gets hidden when the property is active, and visible
|
|
when the property is inactive.
|
|
|
|
.. note::
|
|
|
|
this should be called after calling :py:func:`~QgsPropertyOverrideButton.init` to be correctly initialized.
|
|
%End
|
|
|
|
void registerExpressionWidget( QWidget *widget );
|
|
%Docstring
|
|
Register a sibling ``widget`` (line edit, text edit) that will receive
|
|
the property as an expression
|
|
|
|
.. note::
|
|
|
|
this should be called after calling :py:func:`~QgsPropertyOverrideButton.init` to be correctly initialized.
|
|
%End
|
|
|
|
void registerExpressionContextGenerator( QgsExpressionContextGenerator *generator );
|
|
%Docstring
|
|
Register an expression context generator class that will be used to
|
|
retrieve an expression context for the button when required.
|
|
%End
|
|
|
|
void registerLinkedWidget( QWidget *widget );
|
|
%Docstring
|
|
Registers a ``widget`` which is linked to this button. The meaning of
|
|
linked widgets depends on the property type, and the type of linked
|
|
widget.
|
|
|
|
For color properties, linking a :py:class:`QgsColorButton` allows the
|
|
color button to correctly reflect the status of the property when it's
|
|
set to follow a project color.
|
|
|
|
.. versionadded:: 3.6
|
|
%End
|
|
|
|
void updateFieldLists();
|
|
%Docstring
|
|
Updates list of fields.
|
|
%End
|
|
|
|
|
|
public slots:
|
|
|
|
void setActive( bool active );
|
|
%Docstring
|
|
Set whether the current property override definition is to be used
|
|
%End
|
|
|
|
|
|
|
|
void aboutToShowMenu();
|
|
void menuActionTriggered( QAction *action );
|
|
|
|
|
|
signals:
|
|
|
|
void changed();
|
|
%Docstring
|
|
Emitted when property definition changes
|
|
%End
|
|
|
|
void activated( bool isActive );
|
|
%Docstring
|
|
Emitted when the activated status of the widget changes
|
|
%End
|
|
|
|
void createAuxiliaryField();
|
|
%Docstring
|
|
Emitted when creating a new auxiliary field
|
|
%End
|
|
|
|
protected:
|
|
virtual void mouseReleaseEvent( QMouseEvent *event );
|
|
|
|
|
|
};
|
|
|
|
/************************************************************************
|
|
* This file has been generated automatically from *
|
|
* *
|
|
* src/gui/qgspropertyoverridebutton.h *
|
|
* *
|
|
* Do not edit manually ! Edit header and run scripts/sipify.py again *
|
|
************************************************************************/
|