Class: QgsScaleRangeWidget¶
A widget allowing entry of a range of map scales, e.g. minimum scale and maximum scale.
Class Hierarchy¶
Base classes¶
Methods
Returns the selected maximum scale (i.e. most "zoomed in" scale), or 0 if maximum scale is not set. |
|
Returns the selected minimum scale (i.e. most "zoomed out" scale), or 0 if minimum scale is not set. |
|
Call to reload the preset scales from the current project and apply them to the 2 scales combo boxes. |
|
Sets the map canvas which will be used for the current scale buttons. |
|
Set the maximum scale (i.e. most "zoomed in" scale), or 0 to indicate the minimum is not set. |
|
Set the minimum scale (i.e. most "zoomed out" scale), or 0 to indicate the minimum is not set. |
|
Sets the scale range, from min scale (i.e. most "zoomed out" scale) to max scale (most "zoomed in" scale). |
Signals
Emitted when the scale range set in the widget is changed. |
- class qgis.gui.QgsScaleRangeWidget[source]¶
Bases:
QWidget
- __init__(parent: QWidget | None = None)
Constructor for QgsScaleRangeWidget.
- Parameters:
parent (Optional[QWidget] = None)
- maximumScale(self) float [source]¶
Returns the selected maximum scale (i.e. most “zoomed in” scale), or 0 if maximum scale is not set. The scale value indicates the scale denominator, e.g. 1000.0 for a 1:1000 map.
See also
See also
- Return type:
float
- minimumScale(self) float [source]¶
Returns the selected minimum scale (i.e. most “zoomed out” scale), or 0 if minimum scale is not set. The scale value indicates the scale denominator, e.g. 1000.0 for a 1:1000 map.
See also
See also
- Return type:
float
- signal rangeChanged(min: float, max: float)[source]¶
Emitted when the scale range set in the widget is changed. The scale values indicates the scale denominator, e.g. 1000.0 for a 1:1000 map, or 0 to indicate not set.
- Parameters:
min (float)
max (float)
- reloadProjectScales(self)[source]¶
Call to reload the preset scales from the current project and apply them to the 2 scales combo boxes.
- setMapCanvas(self, canvas: QgsMapCanvas | None)[source]¶
Sets the map
canvas
which will be used for the current scale buttons. If not set, the buttons are hidden.- Parameters:
canvas (Optional[QgsMapCanvas])
- setMaximumScale(self, scale: float)[source]¶
Set the maximum
scale
(i.e. most “zoomed in” scale), or 0 to indicate the minimum is not set. The scale value indicates the scale denominator, e.g. 1000.0 for a 1:1000 map.See also
See also
See also
Warning
Calling
setMinimumScale()
places a restriction on the acceptable maximum scale for the widget, and will alter any previously set maximum scale to pass this constraint. Always callsetMinimumScale()
beforesetMaximumScale()
when restoring a scale range in the widget, or use the convenience methodsetScaleRange()
instead.- Parameters:
scale (float)
- setMinimumScale(self, scale: float)[source]¶
Set the minimum
scale
(i.e. most “zoomed out” scale), or 0 to indicate the minimum is not set. The scale value indicates the scale denominator, e.g. 1000.0 for a 1:1000 map.See also
See also
See also
Warning
Calling
setMinimumScale()
places a restriction on the acceptable maximum scale for the widget, and will alter any previously set maximum scale to pass this constraint. Always callsetMinimumScale()
beforesetMaximumScale()
when restoring a scale range in the widget, or use the convenience methodsetScaleRange()
instead.- Parameters:
scale (float)
- setScaleRange(self, min: float, max: float)[source]¶
Sets the scale range, from
min
scale (i.e. most “zoomed out” scale) tomax
scale (most “zoomed in” scale). The scale values indicates the scale denominator, e.g. 1000.0 for a 1:1000 map, or 0 to indicate not set.See also
See also
- Parameters:
min (float)
max (float)