Skip to content

Class QFieldLocatorFilter

ClassList > QFieldLocatorFilter

More...

  • #include <qfieldlocatorfilter.h>

Inherits the following classes: QgsLocatorFilter

Public Properties

Type Name
property int delay
property QString description
property QString displayName
property LocatorModelSuperBridge * locatorBridge
property QString name
property QVariantMap parameters
property QString prefix
property QUrl source

Public Signals

Type Name
signal void delayChanged
Emitted when the fetch result delay has changed.
signal void descriptionChanged
Emitted when the description has changed.
signal void displayNameChanged
Emitted when the display name has changed.
signal void locatorBridgeChanged
Emitted when the locator bridge has changed.
signal void nameChanged
Emitted when the name has changed.
signal void parametersChanged
Emitted when the parameters object has changed.
signal void prefixChanged
Emitted when the prefix has changed.
signal void sourceChanged
Emitted when the source has changed.

Public Functions

Type Name
QFieldLocatorFilter (QObject * parent=nullptr)
QFieldLocatorFilter * clone () override const
Clone the locator filter.
int delay () const
Returns the delay before which the fetching of results is triggered.
QString description () override const
QString displayName () override const
void fetchResults (const QString & string, const QgsLocatorContext & context, QgsFeedback * feedback) override
LocatorModelSuperBridge * locatorBridge () const
QString name () override const
QVariantMap parameters () const
QString prefix () override const
Priority priority () override const
void setDelay (int delay)
Sets the delay before which the fetching of results is triggered.
void setDescription (const QString & description)
void setDisplayName (const QString & displayName)
void setLocatorBridge (LocatorModelSuperBridge * locatorBridge)
void setName (const QString & name)
void setParameters (const QVariantMap & parameters)
void setPrefix (const QString & prefix)
void setSource (const QUrl & source)
QUrl source () const
void triggerResult (const QgsLocatorResult & result) override
void triggerResultFromAction (const QgsLocatorResult & result, const int actionId) override

Detailed Description

QFieldLocatorFilter is a locator filter item for QField plugins to integrate with locator searches.

Public Properties Documentation

property delay [1/2]

int QFieldLocatorFilter::delay;

property description [1/2]

QString QFieldLocatorFilter::description;

property displayName [1/2]

QString QFieldLocatorFilter::displayName;

property locatorBridge [1/2]

LocatorModelSuperBridge * QFieldLocatorFilter::locatorBridge;

property name [1/2]

QString QFieldLocatorFilter::name;

property parameters [1/2]

QVariantMap QFieldLocatorFilter::parameters;

property prefix [1/2]

QString QFieldLocatorFilter::prefix;

property source [1/2]

QUrl QFieldLocatorFilter::source;

Public Signals Documentation

signal delayChanged

Emitted when the fetch result delay has changed.

void QFieldLocatorFilter::delayChanged;

signal descriptionChanged

Emitted when the description has changed.

void QFieldLocatorFilter::descriptionChanged;

signal displayNameChanged

Emitted when the display name has changed.

void QFieldLocatorFilter::displayNameChanged;

signal locatorBridgeChanged

Emitted when the locator bridge has changed.

void QFieldLocatorFilter::locatorBridgeChanged;

signal nameChanged

Emitted when the name has changed.

void QFieldLocatorFilter::nameChanged;

signal parametersChanged

Emitted when the parameters object has changed.

void QFieldLocatorFilter::parametersChanged;

signal prefixChanged

Emitted when the prefix has changed.

void QFieldLocatorFilter::prefixChanged;

signal sourceChanged

Emitted when the source has changed.

void QFieldLocatorFilter::sourceChanged;

Public Functions Documentation

function QFieldLocatorFilter

explicit QFieldLocatorFilter::QFieldLocatorFilter (
    QObject * parent=nullptr
) 

function clone

Clone the locator filter.

QFieldLocatorFilter * QFieldLocatorFilter::clone () override const

function delay [2/2]

Returns the delay before which the fetching of results is triggered.

inline int QFieldLocatorFilter::delay () const

function description [2/2]

inline QString QFieldLocatorFilter::description () override const

function displayName [2/2]

inline QString QFieldLocatorFilter::displayName () override const

function fetchResults

void QFieldLocatorFilter::fetchResults (
    const QString & string,
    const QgsLocatorContext & context,
    QgsFeedback * feedback
) override

function locatorBridge [2/2]

inline LocatorModelSuperBridge * QFieldLocatorFilter::locatorBridge () const

Returns the locator bridge object.


function name [2/2]

inline QString QFieldLocatorFilter::name () override const

function parameters [2/2]

inline QVariantMap QFieldLocatorFilter::parameters () const

Returns additional locator filter parameters which will possed onto the source QML that will process the locator filter results.


function prefix [2/2]

inline QString QFieldLocatorFilter::prefix () override const

function priority

inline Priority QFieldLocatorFilter::priority () override const

function setDelay

Sets the delay before which the fetching of results is triggered.

void QFieldLocatorFilter::setDelay (
    int delay
) 

function setDescription

void QFieldLocatorFilter::setDescription (
    const QString & description
) 

Sets a description for the filter.


function setDisplayName

void QFieldLocatorFilter::setDisplayName (
    const QString & displayName
) 

Sets a translated, user-friendly name for the filter.


function setLocatorBridge

void QFieldLocatorFilter::setLocatorBridge (
    LocatorModelSuperBridge * locatorBridge
) 

Sets the locator bridge object.


function setName

void QFieldLocatorFilter::setName (
    const QString & name
) 

Sets the unique name of the filter. This should be an untranslated string identifying the filter.


function setParameters

void QFieldLocatorFilter::setParameters (
    const QVariantMap & parameters
) 

Sets additional locator filter parameters which will possed onto the source QML that will process the locator filter results.


function setPrefix

void QFieldLocatorFilter::setPrefix (
    const QString & prefix
) 

Sets the search prefix character(s) for this filter. Prefix a search with these characters will restrict the locator search to only include results from this filter.

Note:

The prefix must be >= 3 characters otherwise it will be ignored.


function setSource

void QFieldLocatorFilter::setSource (
    const QUrl & source
) 

Setsthe source QML file which will process the locator filter results.


function source [2/2]

inline QUrl QFieldLocatorFilter::source () const

Returns the source QML file which will process the locator filter results.


function triggerResult

void QFieldLocatorFilter::triggerResult (
    const QgsLocatorResult & result
) override

function triggerResultFromAction

void QFieldLocatorFilter::triggerResultFromAction (
    const QgsLocatorResult & result,
    const int actionId
) override


The documentation for this class was generated from the following file src/core/locator/qfieldlocatorfilter.h