QgsScaleWidget Class Reference

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:

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

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.

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.

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.

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.

void QgsScaleWidget::setMapCanvas

(

QgsMapCanvas *

canvas

)

Set the map canvas associated to the current button.

Definition at line 48 of file qgsscalewidget.cpp.

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.

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.

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.

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.

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.

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.

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.

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.

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

bool QgsScaleWidget::minScale

readwrite

Definition at line 39 of file qgsscalewidget.h.

bool QgsScaleWidget::scale

readwrite

Definition at line 38 of file qgsscalewidget.h.

bool QgsScaleWidget::showCurrentScaleButton

readwrite

Definition at line 37 of file qgsscalewidget.h.

---

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

• /build/qgis-3.4.15+24xenial/src/gui/qgsscalewidget.h
• /build/qgis-3.4.15+24xenial/src/gui/qgsscalewidget.cpp