Subgroup: Layout

Class: QgsLayoutUnitsComboBox

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

Bases: PyQt5.QtWidgets.QComboBox

Constructor for QgsLayoutUnitsComboBox.

A custom combo box for selecting units for layout settings.

New in version 3.0: Methods

actionEvent
changeEvent
childEvent
closeEvent
connectNotify
contextMenuEvent
converter Returns the converter used when automatically converting units for linked widgets.
create
customEvent
destroy
disconnectNotify
dragEnterEvent
dragLeaveEvent
dragMoveEvent
dropEvent
enterEvent
focusInEvent
focusNextChild
focusNextPrevChild
focusOutEvent
focusPreviousChild
hideEvent
initPainter
initStyleOption
inputMethodEvent
isSignalConnected
keyPressEvent
keyReleaseEvent
leaveEvent
linkToWidget Registers a spin box widget as linked with the combo box.
metric
mouseDoubleClickEvent
mouseMoveEvent
mousePressEvent
mouseReleaseEvent
moveEvent
nativeEvent
paintEvent
receivers
resizeEvent
sender
senderSignalIndex
setConverter Sets a converter to use when automatically converting units for linked widgets.
setUnit Sets the unit currently selected in the combo box.
sharedPainter
showEvent
tabletEvent
timerEvent
unit Returns the unit currently selected in the combo box.
updateMicroFocus
wheelEvent

Signals

changed Emitted when the unit is changed.

Attributes

actionEvent()
changeEvent()
changed

Emitted when the unit is changed. [signal]

childEvent()
closeEvent()
connectNotify()
contextMenuEvent()
converter(self) → QgsLayoutMeasurementConverter

Returns the converter used when automatically converting units for linked widgets.

See also

setConverter()

create()
customEvent()
destroy()
disconnectNotify()
dragEnterEvent()
dragLeaveEvent()
dragMoveEvent()
dropEvent()
enterEvent()
focusInEvent()
focusNextChild()
focusNextPrevChild()
focusOutEvent()
focusPreviousChild()
hideEvent()
initPainter()
initStyleOption()
inputMethodEvent()
isSignalConnected()
keyPressEvent()
keyReleaseEvent()
leaveEvent()
linkToWidget(self, widget: QDoubleSpinBox)

Registers a spin box widget as linked with the combo box.

Registered spin boxes will automatically be upodated whenever the unit is changed. I.e. a spin box with a value of 100 will be set to 1 when the unit is changed from centimeters to meters.

A measurement converter() must be set in order for the automatic unit conversion to occur.

See also

setConverter()

metric()
mouseDoubleClickEvent()
mouseMoveEvent()
mousePressEvent()
mouseReleaseEvent()
moveEvent()
nativeEvent()
paintEvent()
receivers()
resizeEvent()
sender()
senderSignalIndex()
setConverter(self, converter: QgsLayoutMeasurementConverter)

Sets a converter to use when automatically converting units for linked widgets. The ownership of converter is not transferred, and converter must exist for the life of the combo box.

See also

converter()

setUnit(self, unit: QgsUnitTypes.LayoutUnit)

Sets the unit currently selected in the combo box.

See also

unit()

sharedPainter()
showEvent()
tabletEvent()
timerEvent()
unit(self) → QgsUnitTypes.LayoutUnit

Returns the unit currently selected in the combo box.

See also

setUnit()

updateMicroFocus()
wheelEvent()