QGIS/python/core/auto_generated/qgsfeaturepickermodelbase.sip.in
Nyall Dawson 3f6b490218 Sipify
2025-04-02 11:11:10 +10:00

339 lines
8.5 KiB
Plaintext

/************************************************************************
* This file has been generated automatically from *
* *
* src/core/qgsfeaturepickermodelbase.h *
* *
* Do not edit manually ! Edit header and run scripts/sipify.py again *
************************************************************************/
class QgsFeaturePickerModelBase : QAbstractItemModel /Abstract/
{
%Docstring(signature="appended")
Provides a list of features based on filter conditions.
Features are fetched asynchronously.
.. versionadded:: 3.14
%End
%TypeHeaderCode
#include "qgsfeaturepickermodelbase.h"
%End
public:
enum class CustomRole
{
IdentifierValue,
IdentifierValues,
Value,
Feature,
FeatureId
};
explicit QgsFeaturePickerModelBase( QObject *parent = 0 );
%Docstring
Create a new QgsFeaturePickerModelBase, optionally specifying a
``parent``.
%End
~QgsFeaturePickerModelBase();
QgsVectorLayer *sourceLayer() const;
%Docstring
The source layer from which features will be fetched.
%End
void setSourceLayer( QgsVectorLayer *sourceLayer );
%Docstring
The source layer from which features will be fetched.
%End
QString displayExpression() const;
%Docstring
The display expression will be used for
- displaying values in the combobox
- filtering based on filterValue
%End
void setDisplayExpression( const QString &displayExpression );
%Docstring
The display expression will be used for
- displaying values in the combobox
- filtering based on filterValue
%End
QString filterValue() const;
%Docstring
This value will be used to filter the features available from this
model. Whenever a substring of the displayExpression of a feature
matches the filter value, it will be accessible by this model.
%End
void setFilterValue( const QString &filterValue );
%Docstring
This value will be used to filter the features available from this
model. Whenever a substring of the displayExpression of a feature
matches the filter value, it will be accessible by this model.
%End
virtual QModelIndex index( int row, int column, const QModelIndex &parent ) const;
virtual QModelIndex parent( const QModelIndex &child ) const;
virtual int rowCount( const QModelIndex &parent ) const;
virtual int columnCount( const QModelIndex &parent ) const;
virtual QVariant data( const QModelIndex &index, int role ) const;
QString filterExpression() const;
%Docstring
An additional filter expression to apply, next to the filterValue. Can
be used for spatial filtering etc.
%End
void setFilterExpression( const QString &filterExpression );
%Docstring
An additional filter expression to apply, next to the filterValue. Can
be used for spatial filtering etc.
%End
QgsFeature formFeature() const;
%Docstring
Returns an attribute form feature to be used with the filter expression.
.. versionadded:: 3.42.2
%End
void setFormFeature( const QgsFeature &feature );
%Docstring
Sets an attribute form ``feature`` to be used with the filter
expression.
.. versionadded:: 3.42.2
%End
QgsFeature parentFormFeature() const;
%Docstring
Returns a parent attribute form feature to be used with the filter
expression.
.. versionadded:: 3.42.2
%End
void setParentFormFeature( const QgsFeature &feature );
%Docstring
Sets a parent attribute form ``feature`` to be used with the filter
expression.
.. versionadded:: 3.42.2
%End
bool isLoading() const;
%Docstring
Indicator if the model is currently performing any feature iteration in
the background.
%End
virtual void setExtraIdentifierValueToNull() = 0;
%Docstring
Allows specifying one value that does not need to match the filter
criteria but will still be available in the model as NULL value(s).
%End
int extraIdentifierValueIndex() const;
%Docstring
The index at which the extra identifier value is available within the
model.
%End
bool extraValueDoesNotExist() const;
%Docstring
Flag indicating that the extraIdentifierValue does not exist in the
data.
%End
bool allowNull() const;
%Docstring
Add a NULL entry to the list.
%End
void setAllowNull( bool allowNull );
%Docstring
Add a NULL entry to the list.
%End
bool fetchGeometry() const;
%Docstring
Returns if the geometry is fetched
%End
void setFetchGeometry( bool fetchGeometry );
%Docstring
Defines if the geometry will be fetched
%End
int fetchLimit() const;
%Docstring
Returns the feature request fetch limit
%End
void setFetchLimit( int fetchLimit );
%Docstring
Defines the feature request fetch limit If set to 0, no limit is applied
when fetching
%End
signals:
void currentFeatureChanged();
%Docstring
Emitted when the current feature in the model has changed This emitted
both when the extra value changes and when the extra value status
changes. It allows being notified when the feature is fetched after the
extra value has been set.
.. versionadded:: 3.16.5
%End
void sourceLayerChanged();
%Docstring
The source layer from which features will be fetched.
%End
void displayExpressionChanged();
%Docstring
The display expression will be used for
- displaying values in the combobox
- filtering based on filterValue
%End
void filterValueChanged();
%Docstring
This value will be used to filter the features available from this
model. Whenever a substring of the displayExpression of a feature
matches the filter value, it will be accessible by this model.
%End
void filterExpressionChanged();
%Docstring
An additional filter expression to apply, next to the filterValue. Can
be used for spatial filtering etc.
%End
void formFeatureChanged();
%Docstring
An attribute form feature to be used alongside the filter expression.
.. versionadded:: 3.42.2
%End
void parentFormFeatureChanged();
%Docstring
A parent attribute form feature to be used alongside the filter
expression.
.. versionadded:: 3.42.2
%End
void isLoadingChanged();
%Docstring
Indicator if the model is currently performing any feature iteration in
the background.
%End
void filterJobCompleted();
%Docstring
Indicates that a filter job has been completed and new data may be
available.
%End
void extraIdentifierValueChanged();
%Docstring
Allows specifying one value that does not need to match the filter
criteria but will still be available in the model.
%End
void extraIdentifierValueIndexChanged( int index );
%Docstring
The index at which the extra identifier value is available within the
model.
%End
void extraValueDoesNotExistChanged( bool found );
%Docstring
Notification whether the model has ``found`` a feature tied to the
extraIdentifierValue or not.
%End
void beginUpdate();
%Docstring
Notification that the model is about to be changed because a job was
completed.
%End
void endUpdate();
%Docstring
Notification that the model change is finished. Will always be emitted
in sync with beginUpdate.
%End
void allowNullChanged();
%Docstring
Add a NULL entry to the list.
%End
void fetchGeometryChanged();
%Docstring
Emitted when the fetching of the geometry changes
%End
void fetchLimitChanged();
%Docstring
Emitted when the fetching limit for the feature request changes
%End
protected:
QVariant extraIdentifierValue() const;
%Docstring
Allows specifying one value that does not need to match the filter
criteria but will still be available in the model.
%End
void setExtraIdentifierValue( const QVariant &extraIdentifierValue );
%Docstring
Allows specifying one value that does not need to match the filter
criteria but will still be available in the model.
%End
virtual void requestToReloadCurrentFeature( QgsFeatureRequest &request ) = 0;
%Docstring
Update the request to match the current feature to be reloaded
%End
void setExtraIdentifierValueUnguarded( const QVariant &identifierValue );
%Docstring
This will set the identifier value to be set in the model even if it
doesn't exist currently in the data
%End
};
/************************************************************************
* This file has been generated automatically from *
* *
* src/core/qgsfeaturepickermodelbase.h *
* *
* Do not edit manually ! Edit header and run scripts/sipify.py again *
************************************************************************/