QGIS API Documentation 3.40.0-Bratislava (b56115d8743)
|
The QgsScaleBarSettings class stores the appearance and layout settings for scalebar drawing with QgsScaleBarRenderer. More...
#include <qgsscalebarsettings.h>
Public Member Functions | |
QgsScaleBarSettings () | |
QgsScaleBarSettings (const QgsScaleBarSettings &other) | |
~QgsScaleBarSettings () | |
Qgis::ScaleBarAlignment | alignment () const |
Returns the scalebar alignment. | |
QgsFillSymbol * | alternateFillSymbol () const |
Returns the secondary fill symbol used to render the scalebar (only used for some scalebar types). | |
double | boxContentSpace () const |
Returns the spacing (margin) between the scalebar box and content in millimeters. | |
Q_DECL_DEPRECATED QBrush | brush () const |
Returns the primary brush used for filling the scalebar. | |
Q_DECL_DEPRECATED QBrush | brush2 () const |
Returns the secondary brush for the scalebar. | |
QgsLineSymbol * | divisionLineSymbol () const |
Returns the line symbol used to render the scalebar divisions (only used for some scalebar types). | |
Q_DECL_DEPRECATED QColor | fillColor () const |
Returns the color used for fills in the scalebar. | |
Q_DECL_DEPRECATED QColor | fillColor2 () const |
Returns the secondary color used for fills in the scalebar. | |
QgsFillSymbol * | fillSymbol () const |
Returns the primary fill symbol used to render the scalebar (only used for some scalebar types). | |
Q_DECL_DEPRECATED QFont | font () const |
Returns the font used for drawing text in the scalebar. | |
Q_DECL_DEPRECATED QColor | fontColor () const |
Returns the color used for drawing text in the scalebar. | |
double | height () const |
Returns the scalebar height (in millimeters). | |
double | labelBarSpace () const |
Returns the spacing (in millimeters) between labels and the scalebar. | |
Qgis::ScaleBarDistanceLabelHorizontalPlacement | labelHorizontalPlacement () const |
Returns the horizontal placement of text labels. | |
Qgis::ScaleBarDistanceLabelVerticalPlacement | labelVerticalPlacement () const |
Returns the vertical placement of text labels. | |
Q_DECL_DEPRECATED Qt::PenCapStyle | lineCapStyle () const |
Returns the cap style used for drawing lines in the scalebar. | |
Q_DECL_DEPRECATED QColor | lineColor () const |
Returns the color used for lines in the scalebar. | |
Q_DECL_DEPRECATED Qt::PenJoinStyle | lineJoinStyle () const |
Returns the join style used for drawing lines in the scalebar. | |
QgsLineSymbol * | lineSymbol () const |
Returns the line symbol used to render the scalebar (only used for some scalebar types). | |
Q_DECL_DEPRECATED double | lineWidth () const |
Returns the line width in millimeters for lines in the scalebar. | |
double | mapUnitsPerScaleBarUnit () const |
Returns the number of map units per scale bar unit used by the scalebar. | |
double | maximumBarWidth () const |
Returns the maximum width (in millimeters) for scale bar segments. | |
double | minimumBarWidth () const |
Returns the minimum width (in millimeters) for scale bar segments. | |
int | numberOfSegments () const |
Returns the number of segments included in the scalebar. | |
int | numberOfSegmentsLeft () const |
Returns the number of segments included in the left part of the scalebar. | |
int | numberOfSubdivisions () const |
Returns the number of subdivisions for segments included in the right part of the scalebar (only used for some scalebar types). | |
const QgsNumericFormat * | numericFormat () const |
Returns the numeric format used for numbers in the scalebar. | |
QgsScaleBarSettings & | operator= (const QgsScaleBarSettings &other) |
Q_DECL_DEPRECATED QPen | pen () const |
Returns the pen used for drawing outlines in the scalebar. | |
Qgis::ScaleBarSegmentSizeMode | segmentSizeMode () const |
Returns the size mode for the scale bar segments. | |
void | setAlignment (Qgis::ScaleBarAlignment alignment) |
Sets the scalebar alignment. | |
void | setAlternateFillSymbol (QgsFillSymbol *symbol) |
Sets the secondary fill symbol used to render the scalebar (only used for some scalebar types). | |
void | setBoxContentSpace (double space) |
Sets the space (margin) between the scalebar box and content in millimeters. | |
Q_DECL_DEPRECATED void | setBrush (const QBrush &brush) |
Sets the primary brush used for filling the scalebar. | |
Q_DECL_DEPRECATED void | setBrush2 (const QBrush &brush) |
Sets the secondary brush used for filling the scalebar. | |
void | setDivisionLineSymbol (QgsLineSymbol *symbol) |
Sets the line symbol used to render the scalebar divisions (only used for some scalebar types). | |
Q_DECL_DEPRECATED void | setFillColor (const QColor &color) |
Sets the color used for fills in the scalebar. | |
Q_DECL_DEPRECATED void | setFillColor2 (const QColor &color) |
Sets the secondary color used for fills in the scalebar. | |
void | setFillSymbol (QgsFillSymbol *symbol) |
Sets the primary fill symbol used to render the scalebar (only used for some scalebar types). | |
Q_DECL_DEPRECATED void | setFont (const QFont &font) |
Sets the font used for drawing text in the scalebar. | |
Q_DECL_DEPRECATED void | setFontColor (const QColor &color) |
Sets the color used for drawing text in the scalebar. | |
void | setHeight (double height) |
Sets the scalebar height (in millimeters). | |
void | setLabelBarSpace (double space) |
Sets the spacing (in millimeters) between labels and the scalebar. | |
void | setLabelHorizontalPlacement (Qgis::ScaleBarDistanceLabelHorizontalPlacement placement) |
Sets the horizontal placement of text labels. | |
void | setLabelVerticalPlacement (Qgis::ScaleBarDistanceLabelVerticalPlacement placement) |
Sets the vertical placement of text labels. | |
Q_DECL_DEPRECATED void | setLineCapStyle (Qt::PenCapStyle style) |
Sets the cap style used when drawing the lines in the scalebar. | |
Q_DECL_DEPRECATED void | setLineColor (const QColor &color) |
Sets the color used for lines in the scalebar. | |
Q_DECL_DEPRECATED void | setLineJoinStyle (Qt::PenJoinStyle style) |
Sets the join style used when drawing the lines in the scalebar. | |
void | setLineSymbol (QgsLineSymbol *symbol) |
Sets the line symbol used to render the scalebar (only used for some scalebar types). | |
Q_DECL_DEPRECATED void | setLineWidth (double width) |
Sets the line width in millimeters for lines in the scalebar. | |
void | setMapUnitsPerScaleBarUnit (double units) |
Sets the number of map units per scale bar unit used by the scalebar. | |
void | setMaximumBarWidth (double width) |
Sets the maximum width (in millimeters) for scale bar segments. | |
void | setMinimumBarWidth (double width) |
Sets the minimum width (in millimeters) for scale bar segments. | |
void | setNumberOfSegments (int segments) |
Sets the number of segments included in the scalebar. | |
void | setNumberOfSegmentsLeft (int segments) |
Sets the number of segments included in the left part of the scalebar. | |
void | setNumberOfSubdivisions (int subdivisions) |
Sets the number of subdivisions for segments included in the right part of the scalebar (only used for some scalebar types). | |
void | setNumericFormat (QgsNumericFormat *format) |
Sets the numeric format used for numbers in the scalebar. | |
Q_DECL_DEPRECATED void | setPen (const QPen &pen) |
Sets the pen used for drawing outlines in the scalebar. | |
void | setSegmentSizeMode (Qgis::ScaleBarSegmentSizeMode mode) |
Sets the size mode for scale bar segments. | |
void | setSubdivisionLineSymbol (QgsLineSymbol *symbol) |
Sets the line symbol used to render the scalebar subdivisions (only used for some scalebar types). | |
void | setSubdivisionsHeight (double height) |
Sets the scalebar subdivisions height (in millimeters) for segments included in the right part of the scalebar (only used for some scalebar types). | |
void | setTextFormat (const QgsTextFormat &format) |
Sets the text format used for drawing text in the scalebar. | |
void | setUnitLabel (const QString &label) |
Sets the label for units. | |
void | setUnits (Qgis::DistanceUnit units) |
Sets the distance units used by the scalebar. | |
void | setUnitsPerSegment (double units) |
Sets the number of scalebar units per segment. | |
QgsLineSymbol * | subdivisionLineSymbol () const |
Returns the line symbol used to render the scalebar subdivisions (only used for some scalebar types). | |
double | subdivisionsHeight () const |
Returns the scalebar subdivisions height (in millimeters) for segments included in the right part of the scalebar (only used for some scalebar types). | |
QgsTextFormat & | textFormat () |
Returns the text format used for drawing text in the scalebar. | |
QgsTextFormat | textFormat () const |
Returns the text format used for drawing text in the scalebar. | |
QString | unitLabel () const |
Returns the label for units. | |
Qgis::DistanceUnit | units () const |
Returns the distance units used by the scalebar. | |
double | unitsPerSegment () const |
Returns the number of scalebar units per segment. | |
The QgsScaleBarSettings class stores the appearance and layout settings for scalebar drawing with QgsScaleBarRenderer.
Definition at line 38 of file qgsscalebarsettings.h.
QgsScaleBarSettings::QgsScaleBarSettings | ( | ) |
Definition at line 26 of file qgsscalebarsettings.cpp.
|
default |
QgsScaleBarSettings::QgsScaleBarSettings | ( | const QgsScaleBarSettings & | other | ) |
Definition at line 60 of file qgsscalebarsettings.cpp.
|
inline |
Returns the scalebar alignment.
Definition at line 569 of file qgsscalebarsettings.h.
QgsFillSymbol * QgsScaleBarSettings::alternateFillSymbol | ( | ) | const |
Returns the secondary fill symbol used to render the scalebar (only used for some scalebar types).
Ownership is not transferred.
Definition at line 232 of file qgsscalebarsettings.cpp.
|
inline |
Returns the spacing (margin) between the scalebar box and content in millimeters.
Definition at line 557 of file qgsscalebarsettings.h.
QBrush QgsScaleBarSettings::brush | ( | ) | const |
Returns the primary brush used for filling the scalebar.
Definition at line 242 of file qgsscalebarsettings.cpp.
QBrush QgsScaleBarSettings::brush2 | ( | ) | const |
Returns the secondary brush for the scalebar.
This is used for alternating color style scalebars, such as single and double box styles.
Definition at line 263 of file qgsscalebarsettings.cpp.
QgsLineSymbol * QgsScaleBarSettings::divisionLineSymbol | ( | ) | const |
Returns the line symbol used to render the scalebar divisions (only used for some scalebar types).
Ownership is not transferred.
Definition at line 202 of file qgsscalebarsettings.cpp.
QColor QgsScaleBarSettings::fillColor | ( | ) | const |
Returns the color used for fills in the scalebar.
Definition at line 118 of file qgsscalebarsettings.cpp.
QColor QgsScaleBarSettings::fillColor2 | ( | ) | const |
Returns the secondary color used for fills in the scalebar.
Definition at line 128 of file qgsscalebarsettings.cpp.
QgsFillSymbol * QgsScaleBarSettings::fillSymbol | ( | ) | const |
Returns the primary fill symbol used to render the scalebar (only used for some scalebar types).
Ownership is not transferred.
Definition at line 222 of file qgsscalebarsettings.cpp.
|
inline |
Returns the font used for drawing text in the scalebar.
Definition at line 244 of file qgsscalebarsettings.h.
|
inline |
Returns the color used for drawing text in the scalebar.
Definition at line 272 of file qgsscalebarsettings.h.
|
inline |
Returns the scalebar height (in millimeters).
Definition at line 505 of file qgsscalebarsettings.h.
|
inline |
Returns the spacing (in millimeters) between labels and the scalebar.
Definition at line 517 of file qgsscalebarsettings.h.
|
inline |
Returns the horizontal placement of text labels.
Definition at line 544 of file qgsscalebarsettings.h.
|
inline |
Returns the vertical placement of text labels.
Definition at line 530 of file qgsscalebarsettings.h.
Qt::PenCapStyle QgsScaleBarSettings::lineCapStyle | ( | ) | const |
Returns the cap style used for drawing lines in the scalebar.
Definition at line 304 of file qgsscalebarsettings.cpp.
QColor QgsScaleBarSettings::lineColor | ( | ) | const |
Returns the color used for lines in the scalebar.
Definition at line 138 of file qgsscalebarsettings.cpp.
Qt::PenJoinStyle QgsScaleBarSettings::lineJoinStyle | ( | ) | const |
Returns the join style used for drawing lines in the scalebar.
Definition at line 284 of file qgsscalebarsettings.cpp.
QgsLineSymbol * QgsScaleBarSettings::lineSymbol | ( | ) | const |
Returns the line symbol used to render the scalebar (only used for some scalebar types).
Ownership is not transferred.
Definition at line 192 of file qgsscalebarsettings.cpp.
double QgsScaleBarSettings::lineWidth | ( | ) | const |
Returns the line width in millimeters for lines in the scalebar.
Definition at line 151 of file qgsscalebarsettings.cpp.
|
inline |
Returns the number of map units per scale bar unit used by the scalebar.
Definition at line 198 of file qgsscalebarsettings.h.
|
inline |
Returns the maximum width (in millimeters) for scale bar segments.
This property is only effective if the segmentSizeMode() is set to SegmentSizeFitWidth.
Definition at line 170 of file qgsscalebarsettings.h.
|
inline |
Returns the minimum width (in millimeters) for scale bar segments.
This property is only effective if the segmentSizeMode() is set to SegmentSizeFitWidth.
Definition at line 150 of file qgsscalebarsettings.h.
|
inline |
Returns the number of segments included in the scalebar.
Definition at line 55 of file qgsscalebarsettings.h.
|
inline |
Returns the number of segments included in the left part of the scalebar.
Definition at line 69 of file qgsscalebarsettings.h.
|
inline |
Returns the number of subdivisions for segments included in the right part of the scalebar (only used for some scalebar types).
Definition at line 87 of file qgsscalebarsettings.h.
const QgsNumericFormat * QgsScaleBarSettings::numericFormat | ( | ) | const |
Returns the numeric format used for numbers in the scalebar.
Definition at line 324 of file qgsscalebarsettings.cpp.
QgsScaleBarSettings & QgsScaleBarSettings::operator= | ( | const QgsScaleBarSettings & | other | ) |
Definition at line 89 of file qgsscalebarsettings.cpp.
QPen QgsScaleBarSettings::pen | ( | ) | const |
Returns the pen used for drawing outlines in the scalebar.
Definition at line 165 of file qgsscalebarsettings.cpp.
|
inline |
Returns the size mode for the scale bar segments.
Definition at line 132 of file qgsscalebarsettings.h.
|
inline |
Sets the scalebar alignment.
Definition at line 575 of file qgsscalebarsettings.h.
void QgsScaleBarSettings::setAlternateFillSymbol | ( | QgsFillSymbol * | symbol | ) |
Sets the secondary fill symbol used to render the scalebar (only used for some scalebar types).
Ownership of symbol is transferred to the scalebar.
Definition at line 237 of file qgsscalebarsettings.cpp.
|
inline |
Sets the space (margin) between the scalebar box and content in millimeters.
Definition at line 563 of file qgsscalebarsettings.h.
void QgsScaleBarSettings::setBrush | ( | const QBrush & | brush | ) |
Sets the primary brush used for filling the scalebar.
Definition at line 254 of file qgsscalebarsettings.cpp.
void QgsScaleBarSettings::setBrush2 | ( | const QBrush & | brush | ) |
Sets the secondary brush used for filling the scalebar.
Definition at line 275 of file qgsscalebarsettings.cpp.
void QgsScaleBarSettings::setDivisionLineSymbol | ( | QgsLineSymbol * | symbol | ) |
Sets the line symbol used to render the scalebar divisions (only used for some scalebar types).
Ownership of symbol is transferred to the scalebar.
Definition at line 207 of file qgsscalebarsettings.cpp.
void QgsScaleBarSettings::setFillColor | ( | const QColor & | color | ) |
Sets the color used for fills in the scalebar.
Definition at line 123 of file qgsscalebarsettings.cpp.
void QgsScaleBarSettings::setFillColor2 | ( | const QColor & | color | ) |
Sets the secondary color used for fills in the scalebar.
Definition at line 133 of file qgsscalebarsettings.cpp.
void QgsScaleBarSettings::setFillSymbol | ( | QgsFillSymbol * | symbol | ) |
Sets the primary fill symbol used to render the scalebar (only used for some scalebar types).
Ownership of symbol is transferred to the scalebar.
Definition at line 227 of file qgsscalebarsettings.cpp.
|
inline |
Sets the font used for drawing text in the scalebar.
Definition at line 251 of file qgsscalebarsettings.h.
|
inline |
Sets the color used for drawing text in the scalebar.
Definition at line 280 of file qgsscalebarsettings.h.
|
inline |
Sets the scalebar height (in millimeters).
Definition at line 511 of file qgsscalebarsettings.h.
|
inline |
Sets the spacing (in millimeters) between labels and the scalebar.
Definition at line 523 of file qgsscalebarsettings.h.
|
inline |
Sets the horizontal placement of text labels.
Definition at line 551 of file qgsscalebarsettings.h.
|
inline |
Sets the vertical placement of text labels.
Definition at line 537 of file qgsscalebarsettings.h.
void QgsScaleBarSettings::setLineCapStyle | ( | Qt::PenCapStyle | style | ) |
Sets the cap style used when drawing the lines in the scalebar.
Definition at line 313 of file qgsscalebarsettings.cpp.
void QgsScaleBarSettings::setLineColor | ( | const QColor & | color | ) |
Sets the color used for lines in the scalebar.
Definition at line 143 of file qgsscalebarsettings.cpp.
void QgsScaleBarSettings::setLineJoinStyle | ( | Qt::PenJoinStyle | style | ) |
Sets the join style used when drawing the lines in the scalebar.
Definition at line 293 of file qgsscalebarsettings.cpp.
void QgsScaleBarSettings::setLineSymbol | ( | QgsLineSymbol * | symbol | ) |
Sets the line symbol used to render the scalebar (only used for some scalebar types).
Ownership of symbol is transferred to the scalebar.
Definition at line 197 of file qgsscalebarsettings.cpp.
void QgsScaleBarSettings::setLineWidth | ( | double | width | ) |
Sets the line width in millimeters for lines in the scalebar.
Definition at line 156 of file qgsscalebarsettings.cpp.
|
inline |
Sets the number of map units per scale bar unit used by the scalebar.
Definition at line 204 of file qgsscalebarsettings.h.
|
inline |
Sets the maximum width (in millimeters) for scale bar segments.
This property is only effective if the segmentSizeMode() is set to SegmentSizeFitWidth.
Definition at line 180 of file qgsscalebarsettings.h.
|
inline |
Sets the minimum width (in millimeters) for scale bar segments.
This property is only effective if the segmentSizeMode() is set to SegmentSizeFitWidth.
Definition at line 160 of file qgsscalebarsettings.h.
|
inline |
Sets the number of segments included in the scalebar.
Definition at line 62 of file qgsscalebarsettings.h.
|
inline |
Sets the number of segments included in the left part of the scalebar.
Definition at line 76 of file qgsscalebarsettings.h.
|
inline |
Sets the number of subdivisions for segments included in the right part of the scalebar (only used for some scalebar types).
Definition at line 98 of file qgsscalebarsettings.h.
void QgsScaleBarSettings::setNumericFormat | ( | QgsNumericFormat * | format | ) |
Sets the numeric format used for numbers in the scalebar.
Ownership of format is transferred to the settings.
Definition at line 329 of file qgsscalebarsettings.cpp.
void QgsScaleBarSettings::setPen | ( | const QPen & | pen | ) |
Sets the pen used for drawing outlines in the scalebar.
Definition at line 177 of file qgsscalebarsettings.cpp.
|
inline |
Sets the size mode for scale bar segments.
Definition at line 140 of file qgsscalebarsettings.h.
void QgsScaleBarSettings::setSubdivisionLineSymbol | ( | QgsLineSymbol * | symbol | ) |
Sets the line symbol used to render the scalebar subdivisions (only used for some scalebar types).
Ownership of symbol is transferred to the scalebar.
Definition at line 217 of file qgsscalebarsettings.cpp.
|
inline |
Sets the scalebar subdivisions height (in millimeters) for segments included in the right part of the scalebar (only used for some scalebar types).
Definition at line 112 of file qgsscalebarsettings.h.
|
inline |
Sets the text format used for drawing text in the scalebar.
Definition at line 237 of file qgsscalebarsettings.h.
|
inline |
|
inline |
Sets the distance units used by the scalebar.
Definition at line 192 of file qgsscalebarsettings.h.
|
inline |
Sets the number of scalebar units per segment.
Definition at line 124 of file qgsscalebarsettings.h.
QgsLineSymbol * QgsScaleBarSettings::subdivisionLineSymbol | ( | ) | const |
Returns the line symbol used to render the scalebar subdivisions (only used for some scalebar types).
Ownership is not transferred.
Definition at line 212 of file qgsscalebarsettings.cpp.
|
inline |
Returns the scalebar subdivisions height (in millimeters) for segments included in the right part of the scalebar (only used for some scalebar types).
Definition at line 105 of file qgsscalebarsettings.h.
|
inline |
Returns the text format used for drawing text in the scalebar.
Definition at line 223 of file qgsscalebarsettings.h.
|
inline |
Returns the text format used for drawing text in the scalebar.
Definition at line 230 of file qgsscalebarsettings.h.
|
inline |
Returns the label for units.
Definition at line 210 of file qgsscalebarsettings.h.
|
inline |
Returns the distance units used by the scalebar.
Definition at line 186 of file qgsscalebarsettings.h.
|
inline |
Returns the number of scalebar units per segment.
Definition at line 118 of file qgsscalebarsettings.h.