mirror of
				https://github.com/qgis/QGIS.git
				synced 2025-11-04 00:04:25 -05:00 
			
		
		
		
	
		
			
				
	
	
		
			339 lines
		
	
	
		
			8.5 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
			
		
		
	
	
			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 /BaseType=IntEnum/
 | 
						|
    {
 | 
						|
      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   *
 | 
						|
 ************************************************************************/
 |