QGIS API Documentation  3.0.2-Girona (307d082)
Classes | Public Types | Public Slots | Signals | Public Member Functions | Friends | List of all members
QgsAttributeForm Class Reference

#include <qgsattributeform.h>

Inheritance diagram for QgsAttributeForm:
Inheritance graph
[legend]

Public Types

enum  FilterType { ReplaceFilter, FilterAnd, FilterOr }
 Filter types. More...
 
enum  Mode {
  SingleEditMode, AddFeatureMode, MultiEditMode, SearchMode,
  AggregateSearchMode, IdentifyMode
}
 Form modes. More...
 

Public Slots

void changeAttribute (const QString &field, const QVariant &value, const QString &hintText=QString())
 Call this to change the content of a given attribute. More...
 
void refreshFeature ()
 reload current feature More...
 
void resetSearch ()
 Resets the search/filter form values. More...
 
void resetValues ()
 Sets all values to the values of the current feature. More...
 
bool save ()
 Save all the values from the editors to the layer. More...
 
void setFeature (const QgsFeature &feature)
 Update all editors to correspond to a different feature. More...
 

Signals

Q_DECL_DEPRECATED void attributeChanged (const QString &attribute, const QVariant &value)
 Notifies about changes of attributes. More...
 
void beforeSave (bool &ok)
 Will be emitted before the feature is saved. More...
 
void closed ()
 Emitted when the user selects the close option from the form's button bar. More...
 
void featureSaved (const QgsFeature &feature)
 Is emitted, when a feature is changed or added. More...
 
void filterExpressionSet (const QString &expression, QgsAttributeForm::FilterType type)
 Is emitted when a filter expression is set using the form. More...
 
void flashFeatures (const QString &filter)
 Emitted when the user chooses to flash a filtered set of features. More...
 
void modeChanged (QgsAttributeForm::Mode mode)
 Emitted when the form changes mode. More...
 
void widgetValueChanged (const QString &attribute, const QVariant &value, bool attributeChanged)
 Notifies about changes of attributes. More...
 
void zoomToFeatures (const QString &filter)
 Emitted when the user chooses to zoom to a filtered set of features. More...
 

Public Member Functions

 QgsAttributeForm (QgsVectorLayer *vl, const QgsFeature &feature=QgsFeature(), const QgsAttributeEditorContext &context=QgsAttributeEditorContext(), QWidget *parent=nullptr)
 
 ~QgsAttributeForm () override
 
void addInterface (QgsAttributeFormInterface *iface)
 Takes ownership. More...
 
QString aggregateFilter () const
 The aggregate filter is only useful if the form is in AggregateFilter mode. More...
 
void disconnectButtonBox ()
 Disconnects the button box (OK/Cancel) from the accept/resetValues slots If this method is called, you have to create these connections from outside. More...
 
bool editable ()
 Returns if the form is currently in editable mode. More...
 
bool eventFilter (QObject *object, QEvent *event) override
 Intercepts keypress on custom form (escape should not close it) More...
 
const QgsFeaturefeature ()
 
void hideButtonBox ()
 Hides the button box (OK/Cancel) and enables auto-commit. More...
 
QgsVectorLayerlayer ()
 Returns the layer for which this form is shown. More...
 
Mode mode () const
 Returns the current mode of the form. More...
 
void setEditCommandMessage (const QString &message)
 Sets the edit command message (Undo) that will be used when the dialog is accepted. More...
 
void setMessageBar (QgsMessageBar *messageBar)
 Sets the message bar to display feedback from the form in. More...
 
void setMode (Mode mode)
 Sets the current mode of the form. More...
 
void setMultiEditFeatureIds (const QgsFeatureIds &fids)
 Sets all feature IDs which are to be edited if the form is in multiedit mode. More...
 
void showButtonBox ()
 Shows the button box (OK/Cancel) and disables auto-commit. More...
 

Friends

class TestQgsAttributeForm
 
class TestQgsDualView
 

Detailed Description

Definition at line 43 of file qgsattributeform.h.

Member Enumeration Documentation

◆ FilterType

Filter types.

Enumerator
ReplaceFilter 

Filter should replace any existing filter.

FilterAnd 

Filter should be combined using "AND".

FilterOr 

Filter should be combined using "OR".

Definition at line 62 of file qgsattributeform.h.

◆ Mode

Form modes.

Enumerator
SingleEditMode 

Single edit mode, for editing a single feature.

AddFeatureMode 

Add feature mode, for setting attributes for a new feature. In this mode the dialog will be editable even with an invalid feature and will add a new feature when the form is accepted.

MultiEditMode 

Multi edit mode, for editing fields of multiple features at once.

SearchMode 

Form values are used for searching/filtering the layer.

AggregateSearchMode 

Form is in aggregate search mode, show each widget in this mode.

Since
QGIS 3.0
IdentifyMode 

Identify the feature.

Since
QGIS 3.0

Definition at line 50 of file qgsattributeform.h.

Constructor & Destructor Documentation

◆ QgsAttributeForm()

QgsAttributeForm::QgsAttributeForm ( QgsVectorLayer vl,
const QgsFeature feature = QgsFeature(),
const QgsAttributeEditorContext context = QgsAttributeEditorContext(),
QWidget *  parent = nullptr 
)
explicit

Definition at line 57 of file qgsattributeform.cpp.

◆ ~QgsAttributeForm()

QgsAttributeForm::~QgsAttributeForm ( )
override

Definition at line 83 of file qgsattributeform.cpp.

Member Function Documentation

◆ addInterface()

void QgsAttributeForm::addInterface ( QgsAttributeFormInterface iface)

Takes ownership.

Parameters
iface

Definition at line 111 of file qgsattributeform.cpp.

◆ aggregateFilter()

QString QgsAttributeForm::aggregateFilter ( ) const

The aggregate filter is only useful if the form is in AggregateFilter mode.

In this case it will return a combined expression according to the chosen filters on all attribute widgets.

Since
QGIS 3.0

Definition at line 1969 of file qgsattributeform.cpp.

◆ attributeChanged

Q_DECL_DEPRECATED void QgsAttributeForm::attributeChanged ( const QString &  attribute,
const QVariant &  value 
)
signal

Notifies about changes of attributes.

Parameters
attributeThe name of the attribute that changed.
valueThe new value of the attribute.
Deprecated:
since 3.0

◆ beforeSave

void QgsAttributeForm::beforeSave ( bool &  ok)
signal

Will be emitted before the feature is saved.

Use this signal to perform sanity checks. You can set the parameter ok to false to notify the form that you don't want it to be saved. If you want the form to be saved, leave the parameter untouched.

Parameters
okSet this parameter to false if you don't want the form to be saved
Note
not available in Python bindings

◆ changeAttribute

void QgsAttributeForm::changeAttribute ( const QString &  field,
const QVariant &  value,
const QString &  hintText = QString() 
)
slot

Call this to change the content of a given attribute.

Will update the editor(s) related to this field.

Parameters
fieldThe field to change
valueThe new value
hintTextA hint text for non existent joined features

Definition at line 228 of file qgsattributeform.cpp.

◆ closed

void QgsAttributeForm::closed ( )
signal

Emitted when the user selects the close option from the form's button bar.

Since
QGIS 2.16

◆ disconnectButtonBox()

void QgsAttributeForm::disconnectButtonBox ( )

Disconnects the button box (OK/Cancel) from the accept/resetValues slots If this method is called, you have to create these connections from outside.

Definition at line 105 of file qgsattributeform.cpp.

◆ editable()

bool QgsAttributeForm::editable ( )

Returns if the form is currently in editable mode.

Returns
Editable mode of this form

Definition at line 116 of file qgsattributeform.cpp.

◆ eventFilter()

bool QgsAttributeForm::eventFilter ( QObject *  object,
QEvent *  event 
)
override

Intercepts keypress on custom form (escape should not close it)

Parameters
objectThe object for which the event has been sent
eventThe event which is being filtered
Returns
true if the event has been handled (key was ESC)

Definition at line 1841 of file qgsattributeform.cpp.

◆ feature()

const QgsFeature& QgsAttributeForm::feature ( )
inline

Definition at line 75 of file qgsattributeform.h.

◆ featureSaved

void QgsAttributeForm::featureSaved ( const QgsFeature feature)
signal

Is emitted, when a feature is changed or added.

◆ filterExpressionSet

void QgsAttributeForm::filterExpressionSet ( const QString &  expression,
QgsAttributeForm::FilterType  type 
)
signal

Is emitted when a filter expression is set using the form.

Parameters
expressionfilter expression
typefilter type
Since
QGIS 2.16

◆ flashFeatures

void QgsAttributeForm::flashFeatures ( const QString &  filter)
signal

Emitted when the user chooses to flash a filtered set of features.

Since
QGIS 3.0

◆ hideButtonBox()

void QgsAttributeForm::hideButtonBox ( )

Hides the button box (OK/Cancel) and enables auto-commit.

Note
set Embed in QgsAttributeEditorContext in constructor instead

Definition at line 89 of file qgsattributeform.cpp.

◆ layer()

QgsVectorLayer* QgsAttributeForm::layer ( )
inline

Returns the layer for which this form is shown.

Returns
Layer

Definition at line 109 of file qgsattributeform.h.

◆ mode()

Mode QgsAttributeForm::mode ( ) const
inline

Returns the current mode of the form.

Since
QGIS 2.16
See also
setMode()

Definition at line 123 of file qgsattributeform.h.

◆ modeChanged

void QgsAttributeForm::modeChanged ( QgsAttributeForm::Mode  mode)
signal

Emitted when the form changes mode.

Parameters
modenew mode

◆ refreshFeature

void QgsAttributeForm::refreshFeature ( )
slot

reload current feature

Definition at line 1011 of file qgsattributeform.cpp.

◆ resetSearch

void QgsAttributeForm::resetSearch ( )
slot

Resets the search/filter form values.

Since
QGIS 2.16

Definition at line 651 of file qgsattributeform.cpp.

◆ resetValues

void QgsAttributeForm::resetValues ( )
slot

Sets all values to the values of the current feature.

Definition at line 640 of file qgsattributeform.cpp.

◆ save

bool QgsAttributeForm::save ( )
slot

Save all the values from the editors to the layer.

Returns
True if successful

Definition at line 585 of file qgsattributeform.cpp.

◆ setEditCommandMessage()

void QgsAttributeForm::setEditCommandMessage ( const QString &  message)
inline

Sets the edit command message (Undo) that will be used when the dialog is accepted.

Parameters
messageThe message

Definition at line 138 of file qgsattributeform.h.

◆ setFeature

void QgsAttributeForm::setFeature ( const QgsFeature feature)
slot

Update all editors to correspond to a different feature.

Parameters
featureThe feature which will be represented by the form

Definition at line 241 of file qgsattributeform.cpp.

◆ setMessageBar()

void QgsAttributeForm::setMessageBar ( QgsMessageBar messageBar)

Sets the message bar to display feedback from the form in.

This is used in the search/filter mode to display the count of selected features.

Parameters
messageBartarget message bar
Since
QGIS 2.16

Definition at line 1961 of file qgsattributeform.cpp.

◆ setMode()

void QgsAttributeForm::setMode ( QgsAttributeForm::Mode  mode)

Sets the current mode of the form.

Parameters
modeform mode
Since
QGIS 2.16
See also
mode()

Definition at line 121 of file qgsattributeform.cpp.

◆ setMultiEditFeatureIds()

void QgsAttributeForm::setMultiEditFeatureIds ( const QgsFeatureIds fids)

Sets all feature IDs which are to be edited if the form is in multiedit mode.

Parameters
fidsfeature ID list
Since
QGIS 2.16

Definition at line 1914 of file qgsattributeform.cpp.

◆ showButtonBox()

void QgsAttributeForm::showButtonBox ( )

Shows the button box (OK/Cancel) and disables auto-commit.

Note
set Embed in QgsAttributeEditorContext in constructor instead

Definition at line 98 of file qgsattributeform.cpp.

◆ widgetValueChanged

void QgsAttributeForm::widgetValueChanged ( const QString &  attribute,
const QVariant &  value,
bool  attributeChanged 
)
signal

Notifies about changes of attributes.

Parameters
attributeThe name of the attribute that changed.
valueThe new value of the attribute.
attributeChangedIf true, it corresponds to an actual change of the feature attribute
Since
QGIS 3.0.1

◆ zoomToFeatures

void QgsAttributeForm::zoomToFeatures ( const QString &  filter)
signal

Emitted when the user chooses to zoom to a filtered set of features.

Since
QGIS 3.0

Friends And Related Function Documentation

◆ TestQgsAttributeForm

friend class TestQgsAttributeForm
friend

Definition at line 439 of file qgsattributeform.h.

◆ TestQgsDualView

friend class TestQgsDualView
friend

Definition at line 438 of file qgsattributeform.h.


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