SearchViewController Class

Member Function Documentation

[invokable] SearchViewController::SearchViewController(QObject *parent = nullptr)

Constructs a new SearchViewController object with a given parent.

[override virtual] SearchViewController::~SearchViewController()

Destructor.

[invokable] void SearchViewController::acceptSuggestion(Esri::ArcGISRuntime::Toolkit::SearchSuggestion *searchSuggestion)

Starts a search using the given suggestion result searchSuggestion.

Esri::ArcGISRuntime::Toolkit::SearchSourceInterface *SearchViewController::activeSource() const

Returns the currently active search source. All sources are used if this property is null.

See also setActiveSource().

[signal] void SearchViewController::activeSourceChanged()

Signal emitted when the activeSource changes.

[invokable] void SearchViewController::clearSearch()

Clears the search. This will clear results , suggestions, selectedResult and currentQuery.

[invokable] void SearchViewController::commitSearch(bool restrictToArea)

Starts a search using the current query. When restrictToArea is true then the query will only look for results within the current queryArea.

QString SearchViewController::currentQuery() const

Returns the current user-entered query.

This property drives both suggestions and searches.

See also setCurrentQuery().

[signal] void SearchViewController::currentQueryChanged()

Signal emitted when the currentQuery changes.

QString SearchViewController::defaultPlaceholder() const

Returns the string shown in the search view when no user query is entered.

Default is "Find a place or address".

See also setDefaultPlaceholder().

[signal] void SearchViewController::defaultPlaceholderChanged()

Signal emitted when the defaultPlaceholder changes.

QObject *SearchViewController::geoView() const

Returns the GeoView as a QObject.

See also setGeoView().

[signal] void SearchViewController::geoViewChanged()

Signal emitted when the geoView changes.

bool SearchViewController::isAutomaticConfigurationEnabled() const

Returns whether automatic configuration is enabled or not. Determines whether the view will update its configuration based on the attached geoview's geomodel automatically. This includes such properties as queryCenter, queryArea, and isEligableForRequery.

Defaults to true.

See also setIsAutomaticConfigurationEnabled().

[signal] void SearchViewController::isAutomaticConfigurationEnabledChanged()

Signal emitted when the isAutomaticConfigurationEnabled property changes.

bool SearchViewController::isEligableForRequery() const

Returns whether the user can perform a requery. A requery will perform the search at the same location, but will only look at results that exist within the current extent, ignoring all other results.

See also setIsEligableForRequery().

[signal] void SearchViewController::isEligableForRequeryChanged()

Signal emitted when the isEligableForRequery property changes.

Esri::ArcGISRuntime::Geometry SearchViewController::queryArea() const

Returns the search area to be used for the current query.

Ignored in most queries, unless the restrictToArea flag is set to true when calling SearchViewController::commitSearch.

This property should be updated as the user navigates the map/scene, or at minimum before calling SearchViewController::commitSearch.

Defaults to a default constructed Geometry.

See also setQueryArea().

[signal] void SearchViewController::queryAreaChanged()

Signal emitted when the queryArea changes.

Esri::ArcGISRuntime::Point SearchViewController::queryCenter() const

Returns the center for the search.

This property is used to weigh results in favour of those results closest to the center. This allows results to be local to the active viewpoint.

This should be updated by the view every time the user navigates the map.

Defaults to a default constructed Point.

See also setQueryCenter().

[signal] void SearchViewController::queryCenterChanged()

Signal emitted when the queryCenter changes.

Esri::ArcGISRuntime::Toolkit::SearchViewController::SearchResultMode SearchViewController::resultMode() const

Returns the mode which dictates how results are displayed.

With SearchResultMode::Automatic, if only a single result is found then this is automatically set as the selected result, otherwise when the is more than one possible result then the results property is populated with all possible results.

With SearchResultMode::Multiple, the results property is always populated with all found results (even if there is only 1 result in the list).

With SearchResultMode::Single, even if multiple results are found, the best result is automatically set as the "selected" result and the results property is never populated.

The default value is SearchResultMode::Automatic.

See also setResultMode().

[signal] void SearchViewController::resultModeChanged()

Signal emitted when the resultMode changes.

Esri::ArcGISRuntime::Toolkit::GenericListModel *SearchViewController::results() const

Returns the collection of found results.

Defaults to an empty list.

Esri::ArcGISRuntime::Toolkit::SearchResult *SearchViewController::selectedResult() const

Returns the selected result from the results collection.

Defaults to null.

See also setSelectedResult() and resultMode.

[signal] void SearchViewController::selectedResultChanged()

Signal emitted when the selectedResult changes.

void SearchViewController::setActiveSource(Esri::ArcGISRuntime::Toolkit::SearchSourceInterface *activeSource)

Sets the currently active search source to activeSource. All sources are used if this property is null.

See also activeSource().

void SearchViewController::setCurrentQuery(QString currentQuery)

Sets the current user-entered query to currentQuery. This should be updated by the view after every key press.

This property drives both suggestions and searches.

See also currentQuery().

void SearchViewController::setDefaultPlaceholder(QString defaultPlaceholder)

Sets the string shown in the search view when no user query is entered to defaultPlaceholder.

See also defaultPlaceholder().

void SearchViewController::setGeoView(QObject *geoView)

Set the GeoView object this Controller uses. This will reset internal state related to the old GeoView, such as the active query location and area.

Internally this is cast to a MapView or SceneView using qobject_cast, which is why the paremeter is of form QObject and not GeoView.

• geoView Object which must inherit from GeoView* and QObject*.

See also geoView().

void SearchViewController::setIsAutomaticConfigurationEnabled(bool isAutomaticConfigurationEnabled)

Sets whether automatic configuration is enabled to isAutomaticConfigurationEnabled.

See also isAutomaticConfigurationEnabled().

void SearchViewController::setIsEligableForRequery(bool isEligableForRequery)

Sets whether the user can perform a requery to isEligableForRequery. When automaticConfigurationEnabled is true, and the user changes the viewpoint, this is automatically set to true. Clearing or changing the current query will set this property to false.

See also isEligableForRequery().

void SearchViewController::setQueryArea(Esri::ArcGISRuntime::Geometry queryArea)

Sets the search area to be used for the current query to queryArea.

This property should be updated as the user navigates the map/scene, or at minimum before calling commitSearch.

See also queryArea().

void SearchViewController::setQueryCenter(Esri::ArcGISRuntime::Point queryCenter)

Sets the center for the search to queryCenter.

This should be updated by the view every time the user navigates the map.

See also queryCenter().

void SearchViewController::setResultMode(Esri::ArcGISRuntime::Toolkit::SearchViewController::SearchResultMode resultMode)

Sets the mode which dictates how results are displayed to resultMode.

See also resultMode().

void SearchViewController::setSelectedResult(Esri::ArcGISRuntime::Toolkit::SearchResult *selectedResult)

Sets the selected result from the results collection to selectedResult.

Selecting a result will trigger changing the viewpoint of the geoView to that result if applicable.

See also selectedResult().

Esri::ArcGISRuntime::Toolkit::GenericListModel *SearchViewController::sources() const

Returns the collection of search sources to be used.

Esri::ArcGISRuntime::Toolkit::GenericListModel *SearchViewController::suggestions() const

Returns the collection of suggestion results from a query.