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	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...

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	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 22 of file qgsscalewidget.cpp.

Member Function Documentation

◆ 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 93 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.

◆ setMapCanvas()

void QgsScaleWidget::setMapCanvas ( QgsMapCanvas * canvas )

Set the map canvas associated to the current button.

Definition at line 48 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 139 of file qgsscalewidget.h.

◆ 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 62 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 54 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 42 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 110 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 102 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 125 of file qgsscalewidget.h.

Property Documentation

◆ minScale

bool QgsScaleWidget::minScale

readwrite

Definition at line 39 of file qgsscalewidget.h.

◆ scale

bool QgsScaleWidget::scale

readwrite

Definition at line 38 of file qgsscalewidget.h.

◆ showCurrentScaleButton

bool QgsScaleWidget::showCurrentScaleButton

readwrite

Definition at line 37 of file qgsscalewidget.h.

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

/tmp/buildd/qgis-3.6.0+99unstable/src/gui/qgsscalewidget.h
/tmp/buildd/qgis-3.6.0+99unstable/src/gui/qgsscalewidget.cpp

Public Slots

Signals

Public Member Functions

Static Public Member Functions

Properties

Detailed Description

Constructor & Destructor Documentation

◆ QgsScaleWidget()

Member Function Documentation

◆ minScale()

◆ scale()

◆ scaleChanged

◆ scaleString()

◆ setMapCanvas()

◆ setMinScale

◆ setScale

◆ setScaleFromCanvas

◆ setScaleString()

◆ setShowCurrentScaleButton()

◆ showCurrentScaleButton()

◆ toDouble()

◆ toString()

◆ updateScales

Property Documentation

◆ minScale

◆ scale

◆ showCurrentScaleButton