QGIS API Documentation 3.28.0-Firenze (ed3ad0430f)
Signals | Public Member Functions | List of all members
QgsUnitSelectionWidget Class Reference

A widget displaying a combobox allowing the user to choose between various display units, such as millimeters or map unit. More...

#include <qgsunitselectionwidget.h>

Inheritance diagram for QgsUnitSelectionWidget:
Inheritance graph
[legend]

Signals

void changed ()
 

Public Member Functions

 QgsUnitSelectionWidget (QWidget *parent=nullptr)
 Constructor for QgsUnitSelectionWidget. More...
 
QgsMapUnitScale getMapUnitScale () const
 Returns the map unit scale. More...
 
int getUnit () const
 Gets the selected unit index. More...
 
void setMapCanvas (QgsMapCanvas *canvas)
 Sets the map canvas associated with the widget. More...
 
void setMapUnitScale (const QgsMapUnitScale &scale)
 Sets the map unit scale. More...
 
void setShowMapScaleButton (bool show)
 Sets whether the widget can show the map scale button when the Map Units option is selected. More...
 
void setUnit (int unitIndex)
 Sets the selected unit index. More...
 
void setUnit (QgsUnitTypes::RenderUnit unit)
 Sets the selected unit. More...
 
void setUnits (const QgsUnitTypes::RenderUnitList &units)
 Sets the units which the user can choose from in the combobox. More...
 
void setUnits (const QStringList &units, int mapUnitIdx)
 Sets the units which the user can choose from in the combobox. More...
 
bool showMapScaleButton () const
 Returns true if the widget can show the map scale button when the Map Units option is selected. More...
 
QgsUnitTypes::RenderUnit unit () const
 Returns the current predefined selected unit (if applicable). More...
 

Detailed Description

A widget displaying a combobox allowing the user to choose between various display units, such as millimeters or map unit.

If the user chooses map units, a button appears allowing adjustment of minimum and maximum scaling.

See also
QgsMapUnitScaleWidget
QgsMapUnitScaleDialog

Definition at line 165 of file qgsunitselectionwidget.h.

Constructor & Destructor Documentation

◆ QgsUnitSelectionWidget()

QgsUnitSelectionWidget::QgsUnitSelectionWidget ( QWidget *  parent = nullptr)

Constructor for QgsUnitSelectionWidget.

Parameters
parentparent widget

Definition at line 126 of file qgsunitselectionwidget.cpp.

Member Function Documentation

◆ changed

void QgsUnitSelectionWidget::changed ( )
signal

◆ getMapUnitScale()

QgsMapUnitScale QgsUnitSelectionWidget::getMapUnitScale ( ) const
inline

Returns the map unit scale.

Definition at line 215 of file qgsunitselectionwidget.h.

◆ getUnit()

int QgsUnitSelectionWidget::getUnit ( ) const
inline

Gets the selected unit index.

Definition at line 192 of file qgsunitselectionwidget.h.

◆ setMapCanvas()

void QgsUnitSelectionWidget::setMapCanvas ( QgsMapCanvas canvas)

Sets the map canvas associated with the widget.

This allows the widget to retrieve the current map scale from the canvas.

Parameters
canvasmap canvas
Since
QGIS 2.12

Definition at line 219 of file qgsunitselectionwidget.cpp.

◆ setMapUnitScale()

void QgsUnitSelectionWidget::setMapUnitScale ( const QgsMapUnitScale scale)
inline

Sets the map unit scale.

Definition at line 218 of file qgsunitselectionwidget.h.

◆ setShowMapScaleButton()

void QgsUnitSelectionWidget::setShowMapScaleButton ( bool  show)

Sets whether the widget can show the map scale button when the Map Units option is selected.

See also
showMapScaleButton()
Since
QGIS 3.22

Definition at line 274 of file qgsunitselectionwidget.cpp.

◆ setUnit() [1/2]

void QgsUnitSelectionWidget::setUnit ( int  unitIndex)

Sets the selected unit index.

Parameters
unitIndexindex of unit to set as current
Note
available in Python bindings as setUnitIndex

Definition at line 206 of file qgsunitselectionwidget.cpp.

◆ setUnit() [2/2]

void QgsUnitSelectionWidget::setUnit ( QgsUnitTypes::RenderUnit  unit)

Sets the selected unit.

Parameters
unitpredefined unit to set as current

Definition at line 213 of file qgsunitselectionwidget.cpp.

◆ setUnits() [1/2]

void QgsUnitSelectionWidget::setUnits ( const QgsUnitTypes::RenderUnitList units)

Sets the units which the user can choose from in the combobox.

Clears any existing units.

Parameters
unitslist of valid units
Since
QGIS 2.9

Definition at line 152 of file qgsunitselectionwidget.cpp.

◆ setUnits() [2/2]

void QgsUnitSelectionWidget::setUnits ( const QStringList &  units,
int  mapUnitIdx 
)

Sets the units which the user can choose from in the combobox.

Parameters
unitslist of strings for custom units to display in the widget
mapUnitIdxspecifies which entry corresponds to the map units, or -1 if none

Definition at line 144 of file qgsunitselectionwidget.cpp.

◆ showMapScaleButton()

bool QgsUnitSelectionWidget::showMapScaleButton ( ) const

Returns true if the widget can show the map scale button when the Map Units option is selected.

See also
setShowMapScaleButton()
Since
QGIS 3.22

Definition at line 269 of file qgsunitselectionwidget.cpp.

◆ unit()

QgsUnitTypes::RenderUnit QgsUnitSelectionWidget::unit ( ) const

Returns the current predefined selected unit (if applicable).

Returns
selected output unit, or QgsUnitTypes::RenderUnknownUnit if the widget was populated with custom unit types
Since
QGIS 2.9

Definition at line 192 of file qgsunitselectionwidget.cpp.


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