A combobox which lets the user select map scale from predefined list and highlights nearest to current scale value. More...

#include <qgsscalewidget.h>

Inheritance diagram for QgsScaleWidget:

[legend]

Public Slots
void	setMinScale (double scale)
	Set the minimum allowed scale. More...

void	setNull ()
	Sets the widget to the null value. More...

void	setScale (double scale)
	Set the selected scale from a double. More...

void	setScaleFromCanvas ()
	Assigns the current scale from the map canvas, if set. More...

void	updateScales (const QStringList &scales=QStringList())
	Sets the list of predefined scales to show in the combobox. More...

Signals
void	scaleChanged (double scale)
	Emitted when user has finished editing/selecting a new scale. More...

Public Member Functions
	QgsScaleWidget (QWidget *parent=nullptr)
	QgsScaleWidget creates a combobox which lets the user select map scale from predefined list and highlights nearest to current scale value. More...

bool	allowNull () const
	Returns `true` if the widget can be set to a NULL value. More...

bool	isNull () const
	Returns `true` if the widget is currently set to a "null" value. More...

double	minScale () const
	Returns the minimum scale, or 0 if no minimum scale set. More...

double	scale () const
	Returns the selected scale as a double. More...

QString	scaleString () const
	Returns the selected scale as a string, e.g. More...

void	setAllowNull (bool allowNull)
	Sets whether the scale widget can be set to a NULL value. More...

void	setMapCanvas (QgsMapCanvas *canvas)
	Set the map canvas associated to the current button. More...

bool	setScaleString (const QString &string)
	Set the selected scale from a string, e.g. More...

void	setShowCurrentScaleButton (bool showCurrentScaleButton)
	Sets whether to show a button to set the scale to the current scale of the map canvas next to the combobox. More...

bool	showCurrentScaleButton ()
	Returns whether a button to set the scale from map canvas is shown or not. More...

Static Public Member Functions
static double	toDouble (const QString &scaleString, bool *ok=nullptr)
	Helper function to convert a scale string to double. More...

static QString	toString (double scale)
	Helper function to convert a scale double to scale string. More...

Properties
bool	minScale

bool	scale

bool	showCurrentScaleButton

Detailed Description

A combobox which lets the user select map scale from predefined list and highlights nearest to current scale value.

Definition at line 34 of file qgsscalewidget.h.

Constructor & Destructor Documentation

◆ QgsScaleWidget()

QgsScaleWidget::QgsScaleWidget ( QWidget * parent = nullptr )

explicit

QgsScaleWidget creates a combobox which lets the user select map scale from predefined list and highlights nearest to current scale value.

Definition at line 28 of file qgsscalewidget.cpp.

Member Function Documentation

◆ allowNull()

bool QgsScaleWidget::allowNull ( ) const

Returns true if the widget can be set to a NULL value.

See also: setAllowNull(); isNull(); setNull()

Since: QGIS 3.8

Definition at line 76 of file qgsscalewidget.cpp.

◆ isNull()

bool QgsScaleWidget::isNull ( ) const

Returns true if the widget is currently set to a "null" value.

See also: setAllowNull(); setNull()

Since: QGIS 3.8

Definition at line 66 of file qgsscalewidget.cpp.

◆ minScale()

double QgsScaleWidget::minScale ( ) const

inline

Returns the minimum scale, or 0 if no minimum scale set.

The scale value indicates the scale denominator, e.g. 1000.0 for a 1:1000 map. Any scale lower than the minimum scale will automatically be converted to the minimum scale. Except for 0 which is always allowed.

Definition at line 102 of file qgsscalewidget.h.

◆ scale()

double QgsScaleWidget::scale ( ) const

inline

Returns the selected scale as a double.

The scale value indicates the scale denominator, e.g. 1000.0 for a 1:1000 map.

See also: setScale()

Definition at line 85 of file qgsscalewidget.h.

◆ scaleChanged

void QgsScaleWidget::scaleChanged ( double scale )

signal

Emitted when user has finished editing/selecting a new scale.

The scale value indicates the scale denominator, e.g. 1000.0 for a 1:1000 map.

◆ scaleString()

QString QgsScaleWidget::scaleString ( ) const

inline

Returns the selected scale as a string, e.g.

"1:150".

See also: setScaleString()

Definition at line 72 of file qgsscalewidget.h.

◆ setAllowNull()

void QgsScaleWidget::setAllowNull ( bool allowNull )

Sets whether the scale widget can be set to a NULL value.

See also: allowNull(); isNull(); setNull()

Since: QGIS 3.8

Definition at line 71 of file qgsscalewidget.cpp.

◆ setMapCanvas()

void QgsScaleWidget::setMapCanvas ( QgsMapCanvas * canvas )

Set the map canvas associated to the current button.

Definition at line 60 of file qgsscalewidget.cpp.

◆ setMinScale

void QgsScaleWidget::setMinScale ( double scale )

inlineslot

Set the minimum allowed scale.

Set to 0 to disable the minimum scale. The scale value indicates the scale denominator, e.g. 1000.0 for a 1:1000 map. Any scale lower than the minimum scale will automatically be converted to the minimum scale. Except for 0 which is always allowed.

Definition at line 166 of file qgsscalewidget.h.

◆ setNull

void QgsScaleWidget::setNull ( )

slot

Sets the widget to the null value.

This only has an effect if allowNull() is true.

See also: allowNull(); isNull()

Since: QGIS 3.8

Definition at line 89 of file qgsscalewidget.cpp.

◆ setScale

void QgsScaleWidget::setScale ( double scale )

slot

Set the selected scale from a double.

The scale value indicates the scale denominator, e.g. 1000.0 for a 1:1000 map.

See also: scale()

Definition at line 94 of file qgsscalewidget.cpp.

◆ setScaleFromCanvas

void QgsScaleWidget::setScaleFromCanvas ( )

slot

Assigns the current scale from the map canvas, if set.

See also: setMapCanvas()

Definition at line 81 of file qgsscalewidget.cpp.

◆ setScaleString()

bool QgsScaleWidget::setScaleString ( const QString & string )

inline

Set the selected scale from a string, e.g.

"1:150".

See also: scaleString()

Definition at line 78 of file qgsscalewidget.h.

◆ setShowCurrentScaleButton()

void QgsScaleWidget::setShowCurrentScaleButton ( bool showCurrentScaleButton )

Sets whether to show a button to set the scale to the current scale of the map canvas next to the combobox.

Note: the map canvas must be defined to show the button

See also: showCurrentScaleButton(); setMapCanvas()

Definition at line 54 of file qgsscalewidget.cpp.

◆ showCurrentScaleButton()

bool QgsScaleWidget::showCurrentScaleButton ( )

inline

Returns whether a button to set the scale from map canvas is shown or not.

See also: setShowCurrentScaleButton()

Definition at line 61 of file qgsscalewidget.h.

◆ toDouble()

static double QgsScaleWidget::toDouble	(	const QString &	scaleString,
		bool *	ok = `nullptr`
	)

inlinestatic

Helper function to convert a scale string to double.

The returned value indicates the scale denominator, e.g. 1000.0 for a 1:1000 map. If specified, ok will be set to true if the string was successfully interpreted as a scale.

See also: toString()

Definition at line 119 of file qgsscalewidget.h.

◆ toString()

static QString QgsScaleWidget::toString ( double scale )

inlinestatic

Helper function to convert a scale double to scale string.

The scale value indicates the scale denominator, e.g. 1000.0 for a 1:1000 map.

The returned string will be rounded (e.g. 1:1000, not 1:1000.345).

See also: toDouble()

Definition at line 111 of file qgsscalewidget.h.

◆ updateScales

void QgsScaleWidget::updateScales ( const QStringList & scales = QStringList() )

inlineslot

Sets the list of predefined scales to show in the combobox.

List elements are expected to be valid scale strings, such as "1:1000000".

Definition at line 152 of file qgsscalewidget.h.

Property Documentation

◆ minScale

bool QgsScaleWidget::minScale

readwrite

Definition at line 34 of file qgsscalewidget.h.

◆ scale

bool QgsScaleWidget::scale

readwrite

Definition at line 34 of file qgsscalewidget.h.

◆ showCurrentScaleButton

bool QgsScaleWidget::showCurrentScaleButton

readwrite

Definition at line 34 of file qgsscalewidget.h.

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

/build/qgis-3.28.0+99sid/src/gui/qgsscalewidget.h
/build/qgis-3.28.0+99sid/src/gui/qgsscalewidget.cpp

Public Slots

Signals

Public Member Functions

Static Public Member Functions

Properties

Detailed Description

Constructor & Destructor Documentation

◆ QgsScaleWidget()

Member Function Documentation

◆ allowNull()

◆ isNull()

◆ minScale()

◆ scale()

◆ scaleChanged

◆ scaleString()

◆ setAllowNull()

◆ setMapCanvas()

◆ setMinScale

◆ setNull

◆ setScale

◆ setScaleFromCanvas

◆ setScaleString()

◆ setShowCurrentScaleButton()

◆ showCurrentScaleButton()

◆ toDouble()

◆ toString()

◆ updateScales

Property Documentation

◆ minScale

◆ scale

◆ showCurrentScaleButton