QGIS API Documentation 3.41.0-Master (181b2f43d8e)
Loading...
Searching...
No Matches
Classes | Public Member Functions | Public Attributes | Properties | List of all members
QgsLocatorResult Class Reference

Encapsulates properties of an individual matching result found by a QgsLocatorFilter. More...

#include <qgslocatorfilter.h>

Classes

struct  ResultAction
 The ResultAction stores basic information for additional actions to be used in a locator widget for the result. More...
 

Public Member Functions

 QgsLocatorResult ()=default
 
 QgsLocatorResult (QgsLocatorFilter *filter, const QString &displayString, const QVariant &userData=QVariant())
 Constructor for QgsLocatorResult.
 
void setUserData (const QVariant &userData)
 Set userData for the locator result.
 
QVariant userData () const
 Returns the userData.
 

Public Attributes

QList< QgsLocatorResult::ResultActionactions
 Additional actions to be used in a locator widget for the given result.
 
QgsLocatorFilterfilter = nullptr
 Filter from which the result was obtained.
 
QIcon icon
 Icon for result.
 

Properties

QString description
 Descriptive text for result.
 
QString displayString
 String displayed for result.
 
QString group
 Group the results by categories If left as empty string, this means that results are all shown without being grouped.
 
double groupScore = 0
 Specifies the score of the group to allow ordering.
 
double score = 0.5
 Match score, from 0 - 1, where 1 represents a perfect match.
 
QVariant userData
 

Detailed Description

Encapsulates properties of an individual matching result found by a QgsLocatorFilter.

Definition at line 37 of file qgslocatorfilter.h.

Constructor & Destructor Documentation

◆ QgsLocatorResult() [1/2]

QgsLocatorResult::QgsLocatorResult ( )
default

◆ QgsLocatorResult() [2/2]

QgsLocatorResult::QgsLocatorResult ( QgsLocatorFilter filter,
const QString &  displayString,
const QVariant &  userData = QVariant() 
)
inline

Constructor for QgsLocatorResult.

Definition at line 55 of file qgslocatorfilter.h.

Member Function Documentation

◆ setUserData()

void QgsLocatorResult::setUserData ( const QVariant &  userData)

Set userData for the locator result.

Since
QGIS 3.34

Definition at line 110 of file qgslocatorfilter.cpp.

◆ userData()

QVariant QgsLocatorResult::userData ( ) const

Returns the userData.

Since
QGIS 3.18

Definition at line 105 of file qgslocatorfilter.cpp.

Member Data Documentation

◆ actions

QList<QgsLocatorResult::ResultAction> QgsLocatorResult::actions

Additional actions to be used in a locator widget for the given result.

They could be displayed in a context menu.

Since
QGIS 3.6

Definition at line 152 of file qgslocatorfilter.h.

◆ filter

QgsLocatorFilter* QgsLocatorResult::filter = nullptr

Filter from which the result was obtained.

This is automatically set.

Definition at line 78 of file qgslocatorfilter.h.

◆ icon

QIcon QgsLocatorResult::icon

Icon for result.

Definition at line 93 of file qgslocatorfilter.h.

Property Documentation

◆ description

QString QgsLocatorResult::description

Descriptive text for result.

Definition at line 43 of file qgslocatorfilter.h.

◆ displayString

QString QgsLocatorResult::displayString

String displayed for result.

Definition at line 42 of file qgslocatorfilter.h.

◆ group

QString QgsLocatorResult::group

Group the results by categories If left as empty string, this means that results are all shown without being grouped.

If a group is given, the results will be grouped by group under a header.

Note
This should be translated.
Since
QGIS 3.2

Definition at line 45 of file qgslocatorfilter.h.

◆ groupScore

double QgsLocatorResult::groupScore = 0

Specifies the score of the group to allow ordering.

Score must be positive, higher scores are shown first. If the scores are left to 0 or are identical, the sorting of groups is made alphabetically.

Since
QGIS 3.40

Definition at line 46 of file qgslocatorfilter.h.

◆ score

double QgsLocatorResult::score = 0.5

Match score, from 0 - 1, where 1 represents a perfect match.

Definition at line 44 of file qgslocatorfilter.h.

◆ userData

QVariant QgsLocatorResult::userData
readwrite

Definition at line 41 of file qgslocatorfilter.h.


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