mirror of
https://github.com/qgis/QGIS.git
synced 2025-10-15 00:02:52 -04:00
29b345e2c3
Instead of always calculating the scale along the bottom of the map, expose a choice of methods to the user (along bottom, middle, top, or average of the three measurements) For new scalebars, default to the average method, which better handles the scenario where the scale at the top or bottom of the map cannot be calculated (eg when the top/bottom of the map falls just outside valid areas for the map's crs) This fixes one of the most common scenarios which cause scale bar widths to blow out to massive sizes Refs #55240
870 lines
21 KiB
Plaintext
870 lines
21 KiB
Plaintext
/************************************************************************
|
|
* This file has been generated automatically from *
|
|
* *
|
|
* src/core/layout/qgslayoutitemscalebar.h *
|
|
* *
|
|
* Do not edit manually ! Edit header and run scripts/sipify.py again *
|
|
************************************************************************/
|
|
|
|
|
|
|
|
class QgsLayoutItemScaleBar: QgsLayoutItem
|
|
{
|
|
%Docstring(signature="appended")
|
|
A layout item subclass for scale bars.
|
|
%End
|
|
|
|
%TypeHeaderCode
|
|
#include "qgslayoutitemscalebar.h"
|
|
%End
|
|
public:
|
|
|
|
QgsLayoutItemScaleBar( QgsLayout *layout );
|
|
%Docstring
|
|
Constructor for QgsLayoutItemScaleBar, with the specified parent ``layout``.
|
|
%End
|
|
|
|
virtual int type() const;
|
|
|
|
virtual QIcon icon() const;
|
|
|
|
|
|
static QgsLayoutItemScaleBar *create( QgsLayout *layout ) /Factory/;
|
|
%Docstring
|
|
Returns a new scale bar item for the specified ``layout``.
|
|
|
|
The caller takes responsibility for deleting the returned object.
|
|
%End
|
|
virtual QgsLayoutSize minimumSize() const;
|
|
|
|
|
|
int numberOfSegments() const;
|
|
%Docstring
|
|
Returns the number of segments included in the scalebar.
|
|
|
|
.. seealso:: :py:func:`setNumberOfSegments`
|
|
|
|
.. seealso:: :py:func:`numberOfSegmentsLeft`
|
|
%End
|
|
|
|
void setNumberOfSegments( int segments );
|
|
%Docstring
|
|
Sets the number of ``segments`` included in the scalebar.
|
|
|
|
.. seealso:: :py:func:`numberOfSegments`
|
|
|
|
.. seealso:: :py:func:`setNumberOfSegmentsLeft`
|
|
%End
|
|
|
|
int numberOfSegmentsLeft() const;
|
|
%Docstring
|
|
Returns the number of segments included in the left part of the scalebar.
|
|
|
|
.. seealso:: :py:func:`setNumberOfSegmentsLeft`
|
|
|
|
.. seealso:: :py:func:`numberOfSegments`
|
|
%End
|
|
|
|
void setNumberOfSegmentsLeft( int segments );
|
|
%Docstring
|
|
Sets the number of ``segments`` included in the left part of the scalebar.
|
|
|
|
.. seealso:: :py:func:`numberOfSegmentsLeft`
|
|
|
|
.. seealso:: :py:func:`setNumberOfSegments`
|
|
%End
|
|
|
|
int numberOfSubdivisions() const;
|
|
%Docstring
|
|
Returns the number of subdivisions for segments included in the right part of the scalebar (only used for some scalebar types).
|
|
|
|
.. note::
|
|
|
|
The number of subdivisions represents the number of subdivision segments, not the number of subdivision lines. E.g.
|
|
if the number is 1 then NO subdivision lines will be shown.
|
|
|
|
.. seealso:: :py:func:`setNumberOfSubdivisions`
|
|
|
|
.. versionadded:: 3.14
|
|
%End
|
|
|
|
void setNumberOfSubdivisions( int subdivisions );
|
|
%Docstring
|
|
Sets the number of ``subdivisions`` for segments included in the right part of the scalebar (only used for some scalebar types).
|
|
|
|
.. note::
|
|
|
|
The number of subdivisions represents the number of subdivision segments, not the number of subdivision lines. E.g.
|
|
if the number is 1 then NO subdivision lines will be shown.
|
|
|
|
.. seealso:: :py:func:`numberOfSubdivisions`
|
|
|
|
.. versionadded:: 3.14
|
|
%End
|
|
|
|
double subdivisionsHeight() const;
|
|
%Docstring
|
|
Returns the scalebar subdivisions height (in millimeters) for segments included in the right part of the scalebar (only used for some scalebar types).
|
|
|
|
.. seealso:: :py:func:`setSubdivisionsHeight`
|
|
|
|
.. versionadded:: 3.14
|
|
%End
|
|
|
|
void setSubdivisionsHeight( double height );
|
|
%Docstring
|
|
Sets the scalebar subdivisions ``height`` (in millimeters) for segments included in the right part of the scalebar (only used for some scalebar types).
|
|
|
|
.. seealso:: :py:func:`subdivisionsHeight`
|
|
|
|
.. versionadded:: 3.14
|
|
%End
|
|
|
|
double unitsPerSegment() const;
|
|
%Docstring
|
|
Returns the number of scalebar units per segment.
|
|
|
|
.. seealso:: :py:func:`setUnitsPerSegment`
|
|
%End
|
|
|
|
void setUnitsPerSegment( double units );
|
|
%Docstring
|
|
Sets the number of scalebar ``units`` per segment.
|
|
|
|
.. seealso:: :py:func:`unitsPerSegment`
|
|
%End
|
|
|
|
Qgis::ScaleBarSegmentSizeMode segmentSizeMode() const;
|
|
%Docstring
|
|
Returns the size mode for the scale bar segments.
|
|
|
|
.. seealso:: :py:func:`setSegmentSizeMode`
|
|
|
|
.. seealso:: :py:func:`minimumBarWidth`
|
|
|
|
.. seealso:: :py:func:`maximumBarWidth`
|
|
%End
|
|
|
|
void setSegmentSizeMode( Qgis::ScaleBarSegmentSizeMode mode );
|
|
%Docstring
|
|
Sets the size ``mode`` for scale bar segments.
|
|
|
|
.. seealso:: :py:func:`segmentSizeMode`
|
|
|
|
.. seealso:: :py:func:`setMinimumBarWidth`
|
|
|
|
.. seealso:: :py:func:`setMaximumBarWidth`
|
|
%End
|
|
|
|
double minimumBarWidth() const;
|
|
%Docstring
|
|
Returns the minimum width (in millimeters) for scale bar segments. This
|
|
property is only effective if the :py:func:`~QgsLayoutItemScaleBar.segmentSizeMode` is set
|
|
to SegmentSizeFitWidth.
|
|
|
|
.. seealso:: :py:func:`segmentSizeMode`
|
|
|
|
.. seealso:: :py:func:`setMinimumBarWidth`
|
|
|
|
.. seealso:: :py:func:`maximumBarWidth`
|
|
%End
|
|
|
|
void setMinimumBarWidth( double minWidth );
|
|
%Docstring
|
|
Sets the minimum ``width`` (in millimeters) for scale bar segments. This
|
|
property is only effective if the :py:func:`~QgsLayoutItemScaleBar.segmentSizeMode` is set
|
|
to SegmentSizeFitWidth.
|
|
|
|
.. seealso:: :py:func:`minimumBarWidth`
|
|
|
|
.. seealso:: :py:func:`setMaximumBarWidth`
|
|
|
|
.. seealso:: :py:func:`setSegmentSizeMode`
|
|
%End
|
|
|
|
double maximumBarWidth() const;
|
|
%Docstring
|
|
Returns the maximum width (in millimeters) for scale bar segments. This
|
|
property is only effective if the :py:func:`~QgsLayoutItemScaleBar.segmentSizeMode` is set
|
|
to SegmentSizeFitWidth.
|
|
|
|
.. seealso:: :py:func:`segmentSizeMode`
|
|
|
|
.. seealso:: :py:func:`setMaximumBarWidth`
|
|
|
|
.. seealso:: :py:func:`minimumBarWidth`
|
|
%End
|
|
|
|
void setMaximumBarWidth( double maxWidth );
|
|
%Docstring
|
|
Sets the maximum ``width`` (in millimeters) for scale bar segments. This
|
|
property is only effective if the :py:func:`~QgsLayoutItemScaleBar.segmentSizeMode` is set
|
|
to SegmentSizeFitWidth.
|
|
|
|
.. seealso:: :py:func:`minimumBarWidth`
|
|
|
|
.. seealso:: :py:func:`setMinimumBarWidth`
|
|
|
|
.. seealso:: :py:func:`setSegmentSizeMode`
|
|
%End
|
|
|
|
double mapUnitsPerScaleBarUnit() const;
|
|
%Docstring
|
|
Returns the number of map units per scale bar unit used by the scalebar.
|
|
|
|
.. seealso:: :py:func:`setMapUnitsPerScaleBarUnit`
|
|
%End
|
|
|
|
void setMapUnitsPerScaleBarUnit( double units );
|
|
%Docstring
|
|
Sets the number of map ``units`` per scale bar unit used by the scalebar.
|
|
|
|
.. seealso:: :py:func:`mapUnitsPerScaleBarUnit`
|
|
%End
|
|
|
|
QString unitLabel() const;
|
|
%Docstring
|
|
Returns the label for units.
|
|
|
|
.. seealso:: :py:func:`setUnitLabel`
|
|
%End
|
|
|
|
void setUnitLabel( const QString &label );
|
|
%Docstring
|
|
Sets the ``label`` for units.
|
|
|
|
.. seealso:: :py:func:`unitLabel`
|
|
%End
|
|
|
|
QgsTextFormat textFormat() const;
|
|
%Docstring
|
|
Returns the text format used for drawing text in the scalebar.
|
|
|
|
.. seealso:: :py:func:`setTextFormat`
|
|
|
|
.. versionadded:: 3.2
|
|
%End
|
|
|
|
void setTextFormat( const QgsTextFormat &format );
|
|
%Docstring
|
|
Sets the text ``format`` used for drawing text in the scalebar.
|
|
|
|
.. seealso:: :py:func:`textFormat`
|
|
|
|
.. versionadded:: 3.2
|
|
%End
|
|
|
|
|
|
QgsLineSymbol *lineSymbol() const;
|
|
%Docstring
|
|
Returns the line symbol used to render the scalebar (only used for some scalebar types).
|
|
|
|
Ownership is not transferred.
|
|
|
|
.. seealso:: :py:func:`setLineSymbol`
|
|
|
|
.. seealso:: :py:func:`divisionLineSymbol`
|
|
|
|
.. seealso:: :py:func:`subdivisionLineSymbol`
|
|
|
|
.. versionadded:: 3.14
|
|
%End
|
|
|
|
void setLineSymbol( QgsLineSymbol *symbol /Transfer/ );
|
|
%Docstring
|
|
Sets the line ``symbol`` used to render the scalebar (only used for some scalebar types). Ownership of ``symbol`` is
|
|
transferred to the scalebar.
|
|
|
|
.. seealso:: :py:func:`lineSymbol`
|
|
|
|
.. seealso:: :py:func:`setDivisionLineSymbol`
|
|
|
|
.. seealso:: :py:func:`setSubdivisionLineSymbol`
|
|
|
|
.. versionadded:: 3.14
|
|
%End
|
|
|
|
QgsLineSymbol *divisionLineSymbol() const;
|
|
%Docstring
|
|
Returns the line symbol used to render the scalebar divisions (only used for some scalebar types).
|
|
|
|
Ownership is not transferred.
|
|
|
|
.. seealso:: :py:func:`setDivisionLineSymbol`
|
|
|
|
.. seealso:: :py:func:`lineSymbol`
|
|
|
|
.. seealso:: :py:func:`subdivisionLineSymbol`
|
|
|
|
.. versionadded:: 3.14
|
|
%End
|
|
|
|
void setDivisionLineSymbol( QgsLineSymbol *symbol /Transfer/ );
|
|
%Docstring
|
|
Sets the line ``symbol`` used to render the scalebar divisions (only used for some scalebar types). Ownership of ``symbol`` is
|
|
transferred to the scalebar.
|
|
|
|
.. seealso:: :py:func:`divisionLineSymbol`
|
|
|
|
.. seealso:: :py:func:`setLineSymbol`
|
|
|
|
.. seealso:: :py:func:`setSubdivisionLineSymbol`
|
|
|
|
.. versionadded:: 3.14
|
|
%End
|
|
|
|
QgsLineSymbol *subdivisionLineSymbol() const;
|
|
%Docstring
|
|
Returns the line symbol used to render the scalebar subdivisions (only used for some scalebar types).
|
|
|
|
Ownership is not transferred.
|
|
|
|
.. seealso:: :py:func:`setSubdivisionLineSymbol`
|
|
|
|
.. seealso:: :py:func:`lineSymbol`
|
|
|
|
.. seealso:: :py:func:`divisionLineSymbol`
|
|
|
|
.. versionadded:: 3.14
|
|
%End
|
|
|
|
void setSubdivisionLineSymbol( QgsLineSymbol *symbol /Transfer/ );
|
|
%Docstring
|
|
Sets the line ``symbol`` used to render the scalebar subdivisions (only used for some scalebar types). Ownership of ``symbol`` is
|
|
transferred to the scalebar.
|
|
|
|
.. seealso:: :py:func:`subdivisionLineSymbol`
|
|
|
|
.. seealso:: :py:func:`setLineSymbol`
|
|
|
|
.. seealso:: :py:func:`setDivisionLineSymbol`
|
|
|
|
.. versionadded:: 3.14
|
|
%End
|
|
|
|
QgsFillSymbol *fillSymbol() const;
|
|
%Docstring
|
|
Returns the primary fill symbol used to render the scalebar (only used for some scalebar types).
|
|
|
|
Ownership is not transferred.
|
|
|
|
.. seealso:: :py:func:`setFillSymbol`
|
|
|
|
.. seealso:: :py:func:`alternateFillSymbol`
|
|
|
|
.. versionadded:: 3.14
|
|
%End
|
|
|
|
void setFillSymbol( QgsFillSymbol *symbol /Transfer/ );
|
|
%Docstring
|
|
Sets the primary fill ``symbol`` used to render the scalebar (only used for some scalebar types). Ownership of ``symbol`` is
|
|
transferred to the scalebar.
|
|
|
|
.. seealso:: :py:func:`fillSymbol`
|
|
|
|
.. seealso:: :py:func:`setAlternateFillSymbol`
|
|
|
|
.. versionadded:: 3.14
|
|
%End
|
|
|
|
QgsFillSymbol *alternateFillSymbol() const;
|
|
%Docstring
|
|
Returns the secondary fill symbol used to render the scalebar (only used for some scalebar types).
|
|
|
|
Ownership is not transferred.
|
|
|
|
.. seealso:: :py:func:`setAlternateFillSymbol`
|
|
|
|
.. seealso:: :py:func:`fillSymbol`
|
|
|
|
.. versionadded:: 3.14
|
|
%End
|
|
|
|
void setAlternateFillSymbol( QgsFillSymbol *symbol /Transfer/ );
|
|
%Docstring
|
|
Sets the secondary fill ``symbol`` used to render the scalebar (only used for some scalebar types). Ownership of ``symbol`` is
|
|
transferred to the scalebar.
|
|
|
|
.. seealso:: :py:func:`alternateFillSymbol`
|
|
|
|
.. seealso:: :py:func:`setFillSymbol`
|
|
|
|
.. versionadded:: 3.14
|
|
%End
|
|
|
|
QFont font() const /Deprecated/;
|
|
%Docstring
|
|
Returns the font used for drawing text in the scalebar.
|
|
|
|
.. seealso:: :py:func:`setFont`
|
|
|
|
.. deprecated:: 3.40
|
|
|
|
Use :py:func:`~QgsLayoutItemScaleBar.textFormat` instead.
|
|
%End
|
|
|
|
void setFont( const QFont &font ) /Deprecated/;
|
|
%Docstring
|
|
Sets the ``font`` used for drawing text in the scalebar.
|
|
|
|
.. seealso:: :py:func:`font`
|
|
|
|
.. deprecated:: 3.40
|
|
|
|
Use :py:func:`~QgsLayoutItemScaleBar.setTextFormat` instead.
|
|
%End
|
|
|
|
QColor fontColor() const /Deprecated/;
|
|
%Docstring
|
|
Returns the color used for drawing text in the scalebar.
|
|
|
|
.. seealso:: :py:func:`setFontColor`
|
|
|
|
.. seealso:: :py:func:`font`
|
|
|
|
.. deprecated:: 3.40
|
|
|
|
Use :py:func:`~QgsLayoutItemScaleBar.textFormat` instead.
|
|
%End
|
|
|
|
void setFontColor( const QColor &color ) /Deprecated/;
|
|
%Docstring
|
|
Sets the ``color`` used for drawing text in the scalebar.
|
|
|
|
.. seealso:: :py:func:`fontColor`
|
|
|
|
.. seealso:: :py:func:`setFont`
|
|
|
|
.. deprecated:: 3.40
|
|
|
|
Use :py:func:`~QgsLayoutItemScaleBar.setTextFormat` instead.
|
|
%End
|
|
|
|
QColor fillColor() const /Deprecated/;
|
|
%Docstring
|
|
Returns the color used for fills in the scalebar.
|
|
|
|
.. seealso:: :py:func:`setFillColor`
|
|
|
|
.. seealso:: :py:func:`fillColor2`
|
|
|
|
.. deprecated:: 3.40
|
|
|
|
Use :py:func:`~QgsLayoutItemScaleBar.fillSymbol` instead.
|
|
%End
|
|
|
|
void setFillColor( const QColor &color ) /Deprecated/;
|
|
%Docstring
|
|
Sets the ``color`` used for fills in the scalebar.
|
|
|
|
.. seealso:: :py:func:`fillColor`
|
|
|
|
.. seealso:: :py:func:`setFillColor2`
|
|
|
|
.. deprecated:: 3.40
|
|
|
|
Use :py:func:`~QgsLayoutItemScaleBar.setFillSymbol` instead.
|
|
%End
|
|
|
|
QColor fillColor2() const /Deprecated/;
|
|
%Docstring
|
|
Returns the secondary color used for fills in the scalebar.
|
|
|
|
.. seealso:: :py:func:`setFillColor2`
|
|
|
|
.. seealso:: :py:func:`fillColor`
|
|
|
|
.. deprecated:: 3.40
|
|
|
|
Use :py:func:`~QgsLayoutItemScaleBar.alternateFillSymbol` instead.
|
|
%End
|
|
|
|
void setFillColor2( const QColor &color ) /Deprecated/;
|
|
%Docstring
|
|
Sets the secondary ``color`` used for fills in the scalebar.
|
|
|
|
.. seealso:: :py:func:`fillColor2`
|
|
|
|
.. seealso:: :py:func:`setFillColor2`
|
|
|
|
.. deprecated:: 3.40
|
|
|
|
Use :py:func:`~QgsLayoutItemScaleBar.setAlternateFillSymbol` instead.
|
|
%End
|
|
|
|
QColor lineColor() const /Deprecated/;
|
|
%Docstring
|
|
Returns the color used for lines in the scalebar.
|
|
|
|
.. seealso:: :py:func:`setLineColor`
|
|
|
|
.. deprecated:: 3.40
|
|
|
|
Use :py:func:`~QgsLayoutItemScaleBar.lineSymbol` instead.
|
|
%End
|
|
|
|
void setLineColor( const QColor &color ) /Deprecated/;
|
|
%Docstring
|
|
Sets the ``color`` used for lines in the scalebar.
|
|
|
|
.. seealso:: :py:func:`lineColor`
|
|
|
|
.. deprecated:: 3.40
|
|
|
|
Use :py:func:`~QgsLayoutItemScaleBar.setLineSymbol` instead.
|
|
%End
|
|
|
|
double lineWidth() const /Deprecated/;
|
|
%Docstring
|
|
Returns the line width in millimeters for lines in the scalebar.
|
|
|
|
.. seealso:: :py:func:`setLineWidth`
|
|
|
|
.. deprecated:: 3.40
|
|
|
|
Use :py:func:`~QgsLayoutItemScaleBar.lineSymbol` instead.
|
|
%End
|
|
|
|
void setLineWidth( double width ) /Deprecated/;
|
|
%Docstring
|
|
Sets the line ``width`` in millimeters for lines in the scalebar.
|
|
|
|
.. seealso:: :py:func:`lineWidth`
|
|
|
|
.. deprecated:: 3.40
|
|
|
|
Use :py:func:`~QgsLayoutItemScaleBar.setLineSymbol` instead.
|
|
%End
|
|
|
|
QPen pen() const /Deprecated/;
|
|
%Docstring
|
|
Returns the pen used for drawing outlines in the scalebar.
|
|
|
|
.. seealso:: :py:func:`brush`
|
|
|
|
.. deprecated:: 3.40
|
|
|
|
Use :py:func:`~QgsLayoutItemScaleBar.lineSymbol` instead.
|
|
%End
|
|
|
|
QBrush brush() const /Deprecated/;
|
|
%Docstring
|
|
Returns the primary brush for the scalebar.
|
|
|
|
:return: QBrush used for filling the scalebar
|
|
|
|
.. seealso:: :py:func:`brush2`
|
|
|
|
.. seealso:: :py:func:`pen`
|
|
|
|
.. deprecated:: 3.40
|
|
|
|
Use :py:func:`~QgsLayoutItemScaleBar.fillSymbol` instead.
|
|
%End
|
|
|
|
QBrush brush2() const /Deprecated/;
|
|
%Docstring
|
|
Returns the secondary brush for the scalebar. This is used for alternating color style scalebars, such
|
|
as single and double box styles.
|
|
|
|
:return: QBrush used for secondary color areas
|
|
|
|
.. seealso:: :py:func:`brush`
|
|
|
|
.. deprecated:: 3.40
|
|
|
|
Use :py:func:`~QgsLayoutItemScaleBar.alternateFillSymbol` instead.
|
|
%End
|
|
|
|
double height() const;
|
|
%Docstring
|
|
Returns the scalebar height (in millimeters).
|
|
|
|
.. seealso:: :py:func:`setHeight`
|
|
%End
|
|
|
|
void setHeight( double height );
|
|
%Docstring
|
|
Sets the scalebar ``height`` (in millimeters).
|
|
|
|
.. seealso:: :py:func:`height`
|
|
%End
|
|
|
|
void setLinkedMap( QgsLayoutItemMap *map );
|
|
%Docstring
|
|
Sets the ``map`` item linked to the scalebar.
|
|
|
|
.. seealso:: :py:func:`linkedMap`
|
|
%End
|
|
|
|
QgsLayoutItemMap *linkedMap() const;
|
|
%Docstring
|
|
Returns the map item linked to the scalebar.
|
|
|
|
.. seealso:: :py:func:`setLinkedMap`
|
|
%End
|
|
|
|
double labelBarSpace() const;
|
|
%Docstring
|
|
Returns the spacing (in millimeters) between labels and the scalebar.
|
|
|
|
.. seealso:: :py:func:`setLabelBarSpace`
|
|
%End
|
|
|
|
void setLabelBarSpace( double space );
|
|
%Docstring
|
|
Sets the spacing (in millimeters) between labels and the scalebar.
|
|
|
|
.. seealso:: :py:func:`labelBarSpace`
|
|
%End
|
|
|
|
double boxContentSpace() const;
|
|
%Docstring
|
|
Returns the spacing (margin) between the scalebar box and content in millimeters.
|
|
|
|
.. seealso:: :py:func:`setBoxContentSpace`
|
|
%End
|
|
|
|
void setBoxContentSpace( double space );
|
|
%Docstring
|
|
Sets the ``space`` (margin) between the scalebar box and content in millimeters.
|
|
|
|
.. seealso:: :py:func:`boxContentSpace`
|
|
%End
|
|
|
|
Qgis::ScaleBarDistanceLabelVerticalPlacement labelVerticalPlacement() const;
|
|
%Docstring
|
|
Returns the vertical placement of text labels.
|
|
|
|
.. seealso:: :py:func:`setLabelVerticalPlacement`
|
|
|
|
.. versionadded:: 3.10
|
|
%End
|
|
|
|
void setLabelVerticalPlacement( Qgis::ScaleBarDistanceLabelVerticalPlacement placement );
|
|
%Docstring
|
|
Sets the vertical ``placement`` of text labels.
|
|
|
|
.. seealso:: :py:func:`labelVerticalPlacement`
|
|
|
|
.. versionadded:: 3.10
|
|
%End
|
|
|
|
Qgis::ScaleBarDistanceLabelHorizontalPlacement labelHorizontalPlacement() const;
|
|
%Docstring
|
|
Returns the horizontal placement of text labels.
|
|
|
|
.. seealso:: :py:func:`setLabelHorizontalPlacement`
|
|
|
|
.. versionadded:: 3.10
|
|
%End
|
|
|
|
void setLabelHorizontalPlacement( Qgis::ScaleBarDistanceLabelHorizontalPlacement placement );
|
|
%Docstring
|
|
Sets the horizontal ``placement`` of text labels.
|
|
|
|
.. seealso:: :py:func:`labelHorizontalPlacement`
|
|
|
|
.. versionadded:: 3.10
|
|
%End
|
|
|
|
Qgis::ScaleBarAlignment alignment() const;
|
|
%Docstring
|
|
Returns the scalebar alignment.
|
|
|
|
.. seealso:: :py:func:`setAlignment`
|
|
%End
|
|
|
|
void setAlignment( Qgis::ScaleBarAlignment alignment );
|
|
%Docstring
|
|
Sets the scalebar ``alignment``.
|
|
|
|
.. seealso:: :py:func:`alignment`
|
|
%End
|
|
|
|
Qgis::DistanceUnit units() const;
|
|
%Docstring
|
|
Returns the distance units used by the scalebar.
|
|
|
|
.. seealso:: :py:func:`setUnits`
|
|
%End
|
|
|
|
void setUnits( Qgis::DistanceUnit units );
|
|
%Docstring
|
|
Sets the distance ``units`` used by the scalebar.
|
|
|
|
.. seealso:: :py:func:`units`
|
|
%End
|
|
|
|
Qt::PenJoinStyle lineJoinStyle() const /Deprecated/;
|
|
%Docstring
|
|
Returns the join style used for drawing lines in the scalebar.
|
|
|
|
.. seealso:: :py:func:`setLineJoinStyle`
|
|
|
|
.. deprecated:: 3.40
|
|
|
|
Use :py:func:`~QgsLayoutItemScaleBar.lineSymbol` instead.
|
|
%End
|
|
|
|
void setLineJoinStyle( Qt::PenJoinStyle style ) /Deprecated/;
|
|
%Docstring
|
|
Sets the join ``style`` used when drawing the lines in the scalebar
|
|
|
|
.. seealso:: :py:func:`lineJoinStyle`
|
|
|
|
.. deprecated:: 3.40
|
|
|
|
Use :py:func:`~QgsLayoutItemScaleBar.setLineSymbol` instead.
|
|
%End
|
|
|
|
Qt::PenCapStyle lineCapStyle() const /Deprecated/;
|
|
%Docstring
|
|
Returns the cap style used for drawing lines in the scalebar.
|
|
|
|
.. seealso:: :py:func:`setLineCapStyle`
|
|
|
|
.. deprecated:: 3.40
|
|
|
|
Use :py:func:`~QgsLayoutItemScaleBar.lineSymbol` instead.
|
|
%End
|
|
|
|
void setLineCapStyle( Qt::PenCapStyle style ) /Deprecated/;
|
|
%Docstring
|
|
Sets the cap ``style`` used when drawing the lines in the scalebar.
|
|
|
|
.. seealso:: :py:func:`lineCapStyle`
|
|
|
|
.. deprecated:: 3.40
|
|
|
|
Use :py:func:`~QgsLayoutItemScaleBar.setLineSymbol` instead.
|
|
%End
|
|
|
|
void applyDefaultSettings();
|
|
%Docstring
|
|
Applies the default scalebar settings to the scale bar.
|
|
|
|
.. seealso:: :py:func:`applyDefaultSize`
|
|
%End
|
|
|
|
bool applyDefaultRendererSettings( QgsScaleBarRenderer *renderer );
|
|
%Docstring
|
|
Applies any default settings relating to the specified ``renderer`` to the item.
|
|
|
|
Returns ``True`` if settings were applied.
|
|
|
|
.. versionadded:: 3.14
|
|
%End
|
|
|
|
Qgis::DistanceUnit guessUnits() const;
|
|
%Docstring
|
|
Attempts to guess the most reasonable unit choice for the scalebar, given
|
|
the current linked map's scale.
|
|
|
|
This method also considers the linked map's CRS, in order to determine if
|
|
metric or imperial units are more appropriate.
|
|
%End
|
|
|
|
void applyDefaultSize( Qgis::DistanceUnit units = Qgis::DistanceUnit::Meters );
|
|
%Docstring
|
|
Applies the default size to the scale bar (scale bar 1/5 of map item width)
|
|
|
|
.. seealso:: :py:func:`applyDefaultSettings`
|
|
%End
|
|
|
|
void resizeToMinimumWidth();
|
|
%Docstring
|
|
Resizes the scale bar to its minimum width, without changing the height.
|
|
%End
|
|
|
|
void setStyle( const QString &name );
|
|
%Docstring
|
|
Sets the scale bar style by ``name``.
|
|
|
|
The ``name`` parameter gives the (untranslated) style name.
|
|
Possibilities are: 'Single Box', 'Double Box', 'Line Ticks Middle',
|
|
'Line Ticks Down', 'Line Ticks Up', 'Stepped Line', 'Hollow', 'Numeric'.
|
|
|
|
.. seealso:: :py:func:`style`
|
|
%End
|
|
|
|
QString style() const;
|
|
%Docstring
|
|
Returns the scale bar style name.
|
|
|
|
.. seealso:: :py:func:`setStyle`
|
|
%End
|
|
|
|
const QgsNumericFormat *numericFormat() const;
|
|
%Docstring
|
|
Returns the numeric format used for numbers in the scalebar.
|
|
|
|
.. seealso:: :py:func:`setNumericFormat`
|
|
|
|
.. versionadded:: 3.12
|
|
%End
|
|
|
|
void setNumericFormat( QgsNumericFormat *format /Transfer/ );
|
|
%Docstring
|
|
Sets the numeric ``format`` used for numbers in the scalebar.
|
|
|
|
Ownership of ``format`` is transferred to the scalebar.
|
|
|
|
.. seealso:: :py:func:`numericFormat`
|
|
|
|
.. versionadded:: 3.12
|
|
%End
|
|
|
|
Qgis::ScaleCalculationMethod method() const;
|
|
%Docstring
|
|
Returns the scale calculation method, which determines how the bar's scale will be calculated.
|
|
|
|
.. seealso:: :py:func:`setMethod`
|
|
|
|
.. versionadded:: 3.40
|
|
%End
|
|
|
|
void setMethod( Qgis::ScaleCalculationMethod method );
|
|
%Docstring
|
|
Sets the scale calculation ``method``, which determines how the bar's scale will be calculated.
|
|
|
|
.. seealso:: :py:func:`method`
|
|
|
|
.. versionadded:: 3.40
|
|
%End
|
|
|
|
void update();
|
|
%Docstring
|
|
Adjusts the scale bar box size and updates the item.
|
|
%End
|
|
|
|
virtual void refreshDataDefinedProperty( QgsLayoutObject::DataDefinedProperty property = QgsLayoutObject::DataDefinedProperty::AllProperties );
|
|
|
|
virtual void finalizeRestoreFromXml();
|
|
|
|
virtual bool accept( QgsStyleEntityVisitorInterface *visitor ) const;
|
|
|
|
virtual ExportLayerBehavior exportLayerBehavior() const;
|
|
|
|
|
|
protected:
|
|
|
|
virtual void draw( QgsLayoutItemRenderContext &context );
|
|
|
|
virtual bool writePropertiesToElement( QDomElement &element, QDomDocument &document, const QgsReadWriteContext &context ) const;
|
|
|
|
virtual bool readPropertiesFromElement( const QDomElement &element, const QDomDocument &document, const QgsReadWriteContext &context );
|
|
|
|
|
|
};
|
|
|
|
|
|
|
|
/************************************************************************
|
|
* This file has been generated automatically from *
|
|
* *
|
|
* src/core/layout/qgslayoutitemscalebar.h *
|
|
* *
|
|
* Do not edit manually ! Edit header and run scripts/sipify.py again *
|
|
************************************************************************/
|