QgsScaleComboBox Class Reference

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

#include <qgsscalecombobox.h>

Inheritance diagram for QgsScaleComboBox:

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	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
	QgsScaleComboBox (QWidget *parent=nullptr)
	Constructor for QgsScaleComboBox. 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...
bool	setScaleString (const QString &string)
	Set the selected scale from a string, e.g. More...

Static Public Member Functions
static double	toDouble (const QString &string, 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...

Protected Member Functions
void	showPopup () override

Properties
double	minScale
double	scale

Detailed Description

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

Definition at line 30 of file qgsscalecombobox.h.

Constructor & Destructor Documentation

QgsScaleComboBox()

QgsScaleComboBox::QgsScaleComboBox

(

QWidget *

parent = nullptr

)

Constructor for QgsScaleComboBox.

Definition at line 27 of file qgsscalecombobox.cpp.

Member Function Documentation

minScale()

double QgsScaleComboBox::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 68 of file qgsscalecombobox.h.

scale()

double QgsScaleComboBox::scale

(

)

const

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

scaleChanged

void QgsScaleComboBox::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 QgsScaleComboBox::scaleString

(

)

const

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

"1:150".

See also

setScaleString()

Definition at line 115 of file qgsscalecombobox.cpp.

setMinScale

void QgsScaleComboBox::setMinScale ( double  scale )

slot

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 236 of file qgsscalecombobox.cpp.

setScale

void QgsScaleComboBox::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 151 of file qgsscalecombobox.cpp.

setScaleString()

bool QgsScaleComboBox::setScaleString

(

const QString &

string

)

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

"1:150".

See also

scaleString()

Definition at line 120 of file qgsscalecombobox.cpp.

showPopup()

void QgsScaleComboBox::showPopup ( )

overrideprotected

Definition at line 83 of file qgsscalecombobox.cpp.

toDouble()

double QgsScaleComboBox::toDouble ( const QString &  string, bool *  ok = nullptr  )

static

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 196 of file qgsscalecombobox.cpp.

toString()

QString QgsScaleComboBox::toString ( double  scale )

static

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 180 of file qgsscalecombobox.cpp.

updateScales

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

slot

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 40 of file qgsscalecombobox.cpp.

Property Documentation

minScale

double QgsScaleComboBox::minScale

readwrite

Definition at line 34 of file qgsscalecombobox.h.

scale

double QgsScaleComboBox::scale

readwrite

Definition at line 33 of file qgsscalecombobox.h.

---

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

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