QgsProjectionSelectionWidget Class Reference

A widget for selecting a projection. More...

#include <qgsprojectionselectionwidget.h>

Inheritance diagram for QgsProjectionSelectionWidget:

Public Types
enum	CrsOption {   LayerCrs, ProjectCrs, CurrentCrs, DefaultCrs,   RecentCrs, CrsNotSet }
	Predefined CRS options shown in widget. More...

Public Slots
void	selectCrs ()
	Opens the dialog for selecting a new CRS. More...
void	setCrs (const QgsCoordinateReferenceSystem &crs)
	Sets the current CRS for the widget. More...
void	setLayerCrs (const QgsCoordinateReferenceSystem &crs)
	Sets the layer CRS for the widget. More...

Signals
void	cleared ()
	Emitted when the not set option is selected. More...
void	crsChanged (const QgsCoordinateReferenceSystem &)
	Emitted when the selected CRS is changed. More...

Public Member Functions
	QgsProjectionSelectionWidget (QWidget *parent=nullptr)
	Constructor for QgsProjectionSelectionWidget. More...
QgsCoordinateReferenceSystem	crs () const
	Returns the currently selected CRS for the widget. More...
bool	optionVisible (CrsOption option) const
	Returns whether the specified CRS option is visible in the widget. More...
void	setMessage (const QString &text)
	Sets a message to show in the dialog. More...
void	setNotSetText (const QString &text)
	Sets the text to show for the not set option. More...
void	setOptionVisible (CrsOption option, bool visible)
	Sets whether a predefined CRS option should be shown in the widget. More...

Static Public Member Functions
static QString	crsOptionText (const QgsCoordinateReferenceSystem &crs)
	Returns display text for the specified crs. More...

Protected Member Functions
void	dragEnterEvent (QDragEnterEvent *event) override
void	dragLeaveEvent (QDragLeaveEvent *event) override
void	dropEvent (QDropEvent *event) override

Detailed Description

A widget for selecting a projection.

Since

QGIS 2.7

Definition at line 38 of file qgsprojectionselectionwidget.h.

Member Enumeration Documentation

CrsOption

enum QgsProjectionSelectionWidget::CrsOption

Predefined CRS options shown in widget.

Enumerator
LayerCrs	Optional layer CRS.
ProjectCrs	Current project CRS (if OTF reprojection enabled)
CurrentCrs	Current user selected CRS.
DefaultCrs	Global default QGIS CRS.
RecentCrs	Recently used CRS.
CrsNotSet	Not set (hidden by default)

Definition at line 46 of file qgsprojectionselectionwidget.h.

Constructor & Destructor Documentation

QgsProjectionSelectionWidget()

QgsProjectionSelectionWidget::QgsProjectionSelectionWidget ( QWidget *  parent = nullptr )

explicit

Constructor for QgsProjectionSelectionWidget.

Definition at line 25 of file qgsprojectionselectionwidget.cpp.

Member Function Documentation

cleared

void QgsProjectionSelectionWidget::cleared ( )

signal

Emitted when the not set option is selected.

Since

QGIS 3.0

crs()

QgsCoordinateReferenceSystem QgsProjectionSelectionWidget::crs

(

)

const

Returns the currently selected CRS for the widget.

Returns

current CRS

Definition at line 66 of file qgsprojectionselectionwidget.cpp.

crsChanged

void QgsProjectionSelectionWidget::crsChanged ( const QgsCoordinateReferenceSystem &  )

signal

Emitted when the selected CRS is changed.

crsOptionText()

QString QgsProjectionSelectionWidget::crsOptionText ( const QgsCoordinateReferenceSystem &  crs )

static

Returns display text for the specified crs.

Note

Not available in Python bindings

Since

QGIS 3.8

Definition at line 379 of file qgsprojectionselectionwidget.cpp.

dragEnterEvent()

void QgsProjectionSelectionWidget::dragEnterEvent ( QDragEnterEvent *  event )

overrideprotected

Definition at line 200 of file qgsprojectionselectionwidget.cpp.

dragLeaveEvent()

void QgsProjectionSelectionWidget::dragLeaveEvent ( QDragLeaveEvent *  event )

overrideprotected

Definition at line 222 of file qgsprojectionselectionwidget.cpp.

dropEvent()

void QgsProjectionSelectionWidget::dropEvent ( QDropEvent *  event )

overrideprotected

Definition at line 236 of file qgsprojectionselectionwidget.cpp.

optionVisible()

bool QgsProjectionSelectionWidget::optionVisible

(

QgsProjectionSelectionWidget::CrsOption

option

)

const

Returns whether the specified CRS option is visible in the widget.

See also

setOptionVisible()

Since

QGIS 3.0

Definition at line 163 of file qgsprojectionselectionwidget.cpp.

selectCrs

void QgsProjectionSelectionWidget::selectCrs ( )

slot

Opens the dialog for selecting a new CRS.

Definition at line 169 of file qgsprojectionselectionwidget.cpp.

setCrs

void QgsProjectionSelectionWidget::setCrs ( const QgsCoordinateReferenceSystem &  crs )

slot

Sets the current CRS for the widget.

Parameters

crs

new CRS

Definition at line 300 of file qgsprojectionselectionwidget.cpp.

setLayerCrs

void QgsProjectionSelectionWidget::setLayerCrs ( const QgsCoordinateReferenceSystem &  crs )

slot

Sets the layer CRS for the widget.

If set, this will be added as an option to the preset CRSes shown in the widget.

Parameters

crs

layer CRS

Definition at line 335 of file qgsprojectionselectionwidget.cpp.

setMessage()

void QgsProjectionSelectionWidget::setMessage

(

const QString &

text

)

Sets a message to show in the dialog.

If an empty string is passed, the message will be a generic 'define the CRS for this layer'.

Since

QGIS 3.0

Definition at line 158 of file qgsprojectionselectionwidget.cpp.

setNotSetText()

void QgsProjectionSelectionWidget::setNotSetText

(

const QString &

text

)

Sets the text to show for the not set option.

Note that this option is not shown by default and must be set visible by calling setOptionVisible().

Since

QGIS 3.0

Definition at line 148 of file qgsprojectionselectionwidget.cpp.

setOptionVisible()

void QgsProjectionSelectionWidget::setOptionVisible	(	const QgsProjectionSelectionWidget::CrsOption	option,
		bool	visible
	)

Sets whether a predefined CRS option should be shown in the widget.

Parameters

option	CRS option to show/hide
visible	whether the option should be shown

See also

optionVisible()

Definition at line 90 of file qgsprojectionselectionwidget.cpp.

---

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

• /build/qgis-3.16.0+99unstable/src/gui/qgsprojectionselectionwidget.h
• /build/qgis-3.16.0+99unstable/src/gui/qgsprojectionselectionwidget.cpp