A special locator widget which allows searching for matching results from a QgsLocator and presenting them to users for selection. More...

#include <qgslocatorwidget.h>

Inheritance diagram for QgsLocatorWidget:

[legend]

Public Slots
void	invalidateResults ()
	Invalidates the current search results, e.g.

void	search (const QString &string)
	Triggers the locator widget to focus, open and start searching for a specified string.

Signals
void	configTriggered ()
	Emitted when the configure option is triggered in the widget.

Public Member Functions
	QgsLocatorWidget (QWidget *parent SIP_TRANSFERTHIS=nullptr)
	Constructor for QgsLocatorWidget.

QgsLocator *	locator ()
	Returns a pointer to the locator utilized by this widget.

void	setMapCanvas (QgsMapCanvas *canvas)
	Sets a map canvas to associate with the widget.

void	setPlaceholderText (const QString &text)
	Set placeholder text for the line edit.

void	setResultContainerAnchors (QgsFloatingWidget::AnchorPoint anchorPoint, QgsFloatingWidget::AnchorPoint anchorWidgetPoint)
	Sets the result container anchorPoint and anchorWidgetPoint position.

Protected Member Functions
bool	eventFilter (QObject obj, QEvent event) override

Detailed Description

A special locator widget which allows searching for matching results from a QgsLocator and presenting them to users for selection.

See also: QgsLocator

Definition at line 45 of file qgslocatorwidget.h.

Constructor & Destructor Documentation

◆ QgsLocatorWidget()

QgsLocatorWidget::QgsLocatorWidget ( QWidget *parent SIP_TRANSFERTHIS = nullptr )

Constructor for QgsLocatorWidget.

Definition at line 35 of file qgslocatorwidget.cpp.

Member Function Documentation

◆ configTriggered

void QgsLocatorWidget::configTriggered ( )

signal

Emitted when the configure option is triggered in the widget.

◆ eventFilter()

bool QgsLocatorWidget::eventFilter	(	QObject *	obj,
		QEvent *	event
	)

overrideprotected

Definition at line 251 of file qgslocatorwidget.cpp.

◆ invalidateResults

void QgsLocatorWidget::invalidateResults ( )

slot

Invalidates the current search results, e.g.

as a result of changes to the locator filter settings.

Definition at line 183 of file qgslocatorwidget.cpp.

◆ locator()

QgsLocator * QgsLocatorWidget::locator ( )

Returns a pointer to the locator utilized by this widget.

Definition at line 128 of file qgslocatorwidget.cpp.

◆ search

void QgsLocatorWidget::search ( const QString & string )

slot

Triggers the locator widget to focus, open and start searching for a specified string.

Definition at line 166 of file qgslocatorwidget.cpp.

◆ setMapCanvas()

void QgsLocatorWidget::setMapCanvas ( QgsMapCanvas * canvas )

Sets a map canvas to associate with the widget.

This allows the widget to customize the searches performed by its locator(), such as prioritizing results which are near the current canvas extent.

Definition at line 133 of file qgslocatorwidget.cpp.

◆ setPlaceholderText()

void QgsLocatorWidget::setPlaceholderText ( const QString & text )

Set placeholder text for the line edit.

Since: QGIS 3.36

Definition at line 155 of file qgslocatorwidget.cpp.

◆ setResultContainerAnchors()

void QgsLocatorWidget::setResultContainerAnchors	(	QgsFloatingWidget::AnchorPoint	anchorPoint,
		QgsFloatingWidget::AnchorPoint	anchorWidgetPoint
	)

Sets the result container anchorPoint and anchorWidgetPoint position.

Since: QGIS 3.36

Definition at line 160 of file qgslocatorwidget.cpp.

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

/build/qgis-3.41.0+git20241122+3440c17df1d+99sid/src/gui/locator/qgslocatorwidget.h
/build/qgis-3.41.0+git20241122+3440c17df1d+99sid/src/gui/locator/qgslocatorwidget.cpp

Public Slots

Signals

Public Member Functions

Protected Member Functions