A numeric formatter which returns a text representation of a direction/bearing. More...

#include <qgsbearingnumericformat.h>

Inheritance diagram for QgsBearingNumericFormat:

[legend]

Public Types
enum	FormatDirectionOption { UseRange0To180WithEWDirectionalSuffix = 0 , UseRangeNegative180ToPositive180 , UseRange0To360 }
	Directional formatting option, which controls how bearing direction is described in the returned strings. More...

Public Types inherited from QgsBasicNumericFormat
enum	RoundingType { DecimalPlaces , SignificantFigures }
	Sets rounding type and behavior of the numberDecimalPlaces() setting. More...

Public Member Functions
	QgsBearingNumericFormat ()
	Default constructor.

QgsBearingNumericFormat *	clone () const override
	Clones the format, returning a new object.

QVariantMap	configuration (const QgsReadWriteContext &context) const override
	Returns the current configuration of the formatter.

QgsNumericFormat *	create (const QVariantMap &configuration, const QgsReadWriteContext &context) const override
	Creates a new copy of the format, using the supplied configuration.

FormatDirectionOption	directionFormat () const
	Returns the directional formatting option, which controls how bearing direction is described in the returned strings.

QString	formatDouble (double value, const QgsNumericFormatContext &context) const override
	Returns a formatted string representation of a numeric double value.

QString	id () const override
	Returns a unique id for this numeric format.

void	setConfiguration (const QVariantMap &configuration, const QgsReadWriteContext &context) override
	Sets the format's configuration.

void	setDirectionFormat (FormatDirectionOption format)
	Sets the directional formatting option, which controls how bearing direction is described in the returned strings.

int	sortKey () override
	Returns a sorting key value, where formats with a lower sort key will be shown earlier in lists.

double	suggestSampleValue () const override
	Returns a suggested sample value which nicely represents the current format configuration.

QString	visibleName () const override
	Returns the translated, user-visible name for this format.

Public Member Functions inherited from QgsBasicNumericFormat
	QgsBasicNumericFormat ()
	Default constructor.

QChar	decimalSeparator () const
	Returns any override for the decimal separator character.

int	numberDecimalPlaces () const
	Returns the maximum number of decimal places to show.

RoundingType	roundingType () const
	Returns the rounding type, which controls the behavior of the numberDecimalPlaces() setting.

void	setDecimalSeparator (QChar character)
	Sets an override character for the decimal separator character.

virtual void	setNumberDecimalPlaces (int places)
	Sets the maximum number of decimal places to show.

void	setRoundingType (RoundingType type)
	Sets the rounding type, which controls the behavior of the numberDecimalPlaces() setting.

void	setShowPlusSign (bool show)
	Sets whether a leading plus sign will be shown for positive values.

void	setShowThousandsSeparator (bool show)
	Sets whether the thousands grouping separator will be shown.

void	setShowTrailingZeros (bool show)
	Sets whether trailing zeros will be shown (up to the specified numberDecimalPlaces()).

void	setThousandsSeparator (QChar character)
	Sets an override character for the thousands separator character.

bool	showPlusSign () const
	Returns `true` if a leading plus sign will be shown for positive values.

bool	showThousandsSeparator () const
	Returns `true` if the thousands grouping separator will be shown.

bool	showTrailingZeros () const
	Returns `true` if trailing zeros will be shown (up to the specified numberDecimalPlaces()).

QChar	thousandsSeparator () const
	Returns any override for the thousands separator character.

Public Member Functions inherited from QgsNumericFormat
	QgsNumericFormat ()=default

virtual	~QgsNumericFormat ()=default

bool	operator!= (const QgsNumericFormat &other) const

bool	operator== (const QgsNumericFormat &other) const

void	writeXml (QDomElement &element, QDomDocument &document, const QgsReadWriteContext &context) const
	Writes the format to an XML element.

Additional Inherited Members
Protected Attributes inherited from QgsBasicNumericFormat
bool	mUseScientific = false

Static Protected Attributes inherited from QgsNumericFormat
static constexpr int	DEFAULT_SORT_KEY = 100

Detailed Description

A numeric formatter which returns a text representation of a direction/bearing.

Since: QGIS 3.12

Definition at line 28 of file qgsbearingnumericformat.h.

Member Enumeration Documentation

◆ FormatDirectionOption

enum QgsBearingNumericFormat::FormatDirectionOption

Directional formatting option, which controls how bearing direction is described in the returned strings.

Enumerator
UseRange0To180WithEWDirectionalSuffix	Return values between 0 and 180, with a E or W directional suffix.
UseRangeNegative180ToPositive180	Return values between -180 and 180.
UseRange0To360	Return values between 0 to 360.

Definition at line 36 of file qgsbearingnumericformat.h.