QGIS API Documentation 3.37.0-Master (fdefdf9c27f)
Public Slots | Signals | Public Member Functions | Static Public Member Functions | Properties | List of all members
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:
Inheritance graph
[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: