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.

Parameters

parent

actionEvent(self, QActionEvent)
changeEvent(self, QEvent)
changed

Emitted when the unit is changed. [signal]

Parameters

unit (QgsUnitTypes.LayoutUnit) –

childEvent(self, QChildEvent)
closeEvent(self, QCloseEvent)
connectNotify(self, QMetaMethod)
contextMenuEvent(self, QContextMenuEvent)
converter(self)QgsLayoutMeasurementConverter

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

See also

setConverter()

Return type

QgsLayoutMeasurementConverter

create(self, window: sip.voidptr = 0, initializeWindow: bool = True, destroyOldWindow: bool = True)
customEvent(self, QEvent)
destroy(self, destroyWindow: bool = True, destroySubWindows: bool = True)
disconnectNotify(self, QMetaMethod)
dragEnterEvent(self, QDragEnterEvent)
dragLeaveEvent(self, QDragLeaveEvent)
dragMoveEvent(self, QDragMoveEvent)
dropEvent(self, QDropEvent)
enterEvent(self, QEvent)
focusInEvent(self, QFocusEvent)
focusNextChild(self) → bool
focusNextPrevChild(self, bool) → bool
focusOutEvent(self, QFocusEvent)
focusPreviousChild(self) → bool
hideEvent(self, QHideEvent)
initPainter(self, QPainter)
initStyleOption(self, QStyleOptionComboBox)
inputMethodEvent(self, QInputMethodEvent)
isSignalConnected(self, QMetaMethod) → bool
keyPressEvent(self, QKeyEvent)
keyReleaseEvent(self, QKeyEvent)
leaveEvent(self, QEvent)
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()

Parameters

widget (QDoubleSpinBox) –

metric(self, QPaintDevice.PaintDeviceMetric) → int
mouseDoubleClickEvent(self, QMouseEvent)
mouseMoveEvent(self, QMouseEvent)
mousePressEvent(self, QMouseEvent)
mouseReleaseEvent(self, QMouseEvent)
moveEvent(self, QMoveEvent)
nativeEvent(self, Union[QByteArray, bytes, bytearray], sip.voidptr) → Tuple[bool, int]
paintEvent(self, QPaintEvent)
receivers(self, PYQT_SIGNAL) → int
resizeEvent(self, QResizeEvent)
sender(self) → QObject
senderSignalIndex(self) → int
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()

Parameters

converter (QgsLayoutMeasurementConverter) –

setUnit(self, unit: QgsUnitTypes.LayoutUnit)

Sets the unit currently selected in the combo box.

See also

unit()

Parameters

unit (QgsUnitTypes.LayoutUnit) –

sharedPainter(self) → QPainter
showEvent(self, QShowEvent)
tabletEvent(self, QTabletEvent)
timerEvent(self, QTimerEvent)
unit(self) → QgsUnitTypes.LayoutUnit

Returns the unit currently selected in the combo box.

See also

setUnit()

Return type

QgsUnitTypes.LayoutUnit

updateMicroFocus(self)
wheelEvent(self, QWheelEvent)