Class: QgsScaleComboBox

class qgis.gui.QgsScaleComboBox(parent: QWidget = None)

Bases: PyQt5.QtWidgets.QComboBox

Constructor for QgsScaleComboBox.

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

Parameters

parent

actionEvent()
allowNull(self) → bool

Returns True if the combobox can be set to a NULL value.

See also

setAllowNull()

See also

isNull()

See also

setNull()

New in version 3.8.

Return type

bool

changeEvent()
childEvent()
closeEvent()
connectNotify()
contextMenuEvent()
create()
customEvent()
destroy()
disconnectNotify()
dragEnterEvent()
dragLeaveEvent()
dragMoveEvent()
dropEvent()
enterEvent()
focusInEvent()
focusNextChild()
focusNextPrevChild()
focusOutEvent()
focusPreviousChild()
hideEvent()
initPainter()
initStyleOption()
inputMethodEvent()
isNull(self) → bool

Returns true if the combo box is currently set to a “null” value.

See also

setAllowNull()

See also

setNull()

New in version 3.8.

Return type

bool

isSignalConnected()
keyPressEvent()
keyReleaseEvent()
leaveEvent()
metric()
minScale(self) → float

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.

Return type

float

mouseDoubleClickEvent()
mouseMoveEvent()
mousePressEvent()
mouseReleaseEvent()
moveEvent()
nativeEvent()
paintEvent()
receivers()
resizeEvent()
scale(self) → float

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

Return type

float

scaleChanged

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. [signal]

Parameters

scale (float) –

scaleString(self) → str

Returns the selected scale as a string, e.g. “1:150”.

See also

setScaleString()

Return type

str

sender()
senderSignalIndex()
setAllowNull(self, allowNull: bool)

Sets whether the scale combobox can be set to a NULL value.

See also

allowNull()

See also

isNull()

See also

setNull()

New in version 3.8.

Parameters

allowNull (bool) –

setMinScale(self, scale: float)

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.

Parameters

scale (float) –

setNull(self)

Sets the combo box to the null value.

This only has an effect if allowNull() is true.

See also

allowNull()

See also

isNull()

New in version 3.8.

setScale(self, scale: float)

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

Parameters

scale (float) –

setScaleString(self, string: str) → bool

Set the selected scale from a string, e.g. “1:150”.

See also

scaleString()

Parameters

string (str) –

Return type

bool

sharedPainter()
showEvent()
showPopup(self)
tabletEvent()
timerEvent()
toDouble(string: str) → Tuple[float, bool]

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

Parameters

string (str) –

Return type

Tuple[float, bool]

toString(scale: float) → str

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

Parameters

scale (float) –

Return type

str

updateMicroFocus()
updateScales(self, scales: Iterable[str] = [])

Sets the list of predefined scales to show in the combobox. List elements are expected to be valid scale strings, such as “1:1000000”.

Parameters

scales (Iterable[str] = []) –

wheelEvent()