QGIS API Documentation 3.28.0-Firenze (ed3ad0430f)
|
A numeric formatter which returns a text representation of a currency value. More...
#include <qgscurrencynumericformat.h>
Public Member Functions | |
QgsCurrencyNumericFormat () | |
Default constructor. More... | |
QgsNumericFormat * | clone () const override |
Clones the format, returning a new object. More... | |
QVariantMap | configuration (const QgsReadWriteContext &context) const override |
Returns the current configuration of the formatter. More... | |
QgsNumericFormat * | create (const QVariantMap &configuration, const QgsReadWriteContext &context) const override |
Creates a new copy of the format, using the supplied configuration. More... | |
QString | formatDouble (double value, const QgsNumericFormatContext &context) const override |
Returns a formatted string representation of a numeric double value. More... | |
QString | id () const override |
Returns a unique id for this numeric format. More... | |
QString | prefix () const |
Returns the currency prefix, e.g. More... | |
void | setPrefix (const QString &prefix) |
Sets the currency prefix, e.g. More... | |
void | setSuffix (const QString &suffix) |
Sets the currency suffix, e.g. More... | |
int | sortKey () override |
Returns a sorting key value, where formats with a lower sort key will be shown earlier in lists. More... | |
QString | suffix () const |
Returns the currency suffix, e.g. More... | |
double | suggestSampleValue () const override |
Returns a suggested sample value which nicely represents the current format configuration. More... | |
QString | visibleName () const override |
Returns the translated, user-visible name for this format. More... | |
Public Member Functions inherited from QgsBasicNumericFormat | |
QgsBasicNumericFormat () | |
Default constructor. More... | |
QgsNumericFormat * | clone () const override |
Clones the format, returning a new object. More... | |
QVariantMap | configuration (const QgsReadWriteContext &context) const override |
Returns the current configuration of the formatter. More... | |
QgsNumericFormat * | create (const QVariantMap &configuration, const QgsReadWriteContext &context) const override |
Creates a new copy of the format, using the supplied configuration. More... | |
QChar | decimalSeparator () const |
Returns any override for the decimal separator character. More... | |
QString | formatDouble (double value, const QgsNumericFormatContext &context) const override |
Returns a formatted string representation of a numeric double value. More... | |
QString | id () const override |
Returns a unique id for this numeric format. More... | |
int | numberDecimalPlaces () const |
Returns the maximum number of decimal places to show. More... | |
RoundingType | roundingType () const |
Returns the rounding type, which controls the behavior of the numberDecimalPlaces() setting. More... | |
void | setDecimalSeparator (QChar character) |
Sets an override character for the decimal separator character. More... | |
virtual void | setNumberDecimalPlaces (int places) |
Sets the maximum number of decimal places to show. More... | |
void | setRoundingType (RoundingType type) |
Sets the rounding type, which controls the behavior of the numberDecimalPlaces() setting. More... | |
void | setShowPlusSign (bool show) |
Sets whether a leading plus sign will be shown for positive values. More... | |
void | setShowThousandsSeparator (bool show) |
Sets whether the thousands grouping separator will be shown. More... | |
void | setShowTrailingZeros (bool show) |
Sets whether trailing zeros will be shown (up to the specified numberDecimalPlaces()). More... | |
void | setThousandsSeparator (QChar character) |
Sets an override character for the thousands separator character. More... | |
bool | showPlusSign () const |
Returns true if a leading plus sign will be shown for positive values. More... | |
bool | showThousandsSeparator () const |
Returns true if the thousands grouping separator will be shown. More... | |
bool | showTrailingZeros () const |
Returns true if trailing zeros will be shown (up to the specified numberDecimalPlaces()). More... | |
int | sortKey () override |
Returns a sorting key value, where formats with a lower sort key will be shown earlier in lists. More... | |
QChar | thousandsSeparator () const |
Returns any override for the thousands separator character. More... | |
QString | visibleName () const override |
Returns the translated, user-visible name for this format. More... | |
Public Member Functions inherited from QgsNumericFormat | |
QgsNumericFormat ()=default | |
Default constructor. More... | |
virtual | ~QgsNumericFormat ()=default |
virtual QgsNumericFormat * | clone () const =0 |
Clones the format, returning a new object. More... | |
virtual QVariantMap | configuration (const QgsReadWriteContext &context) const =0 |
Returns the current configuration of the formatter. More... | |
virtual QgsNumericFormat * | create (const QVariantMap &configuration, const QgsReadWriteContext &context) const =0 |
Creates a new copy of the format, using the supplied configuration. More... | |
virtual QString | formatDouble (double value, const QgsNumericFormatContext &context) const =0 |
Returns a formatted string representation of a numeric double value. More... | |
virtual QString | id () const =0 |
Returns a unique id for this numeric format. More... | |
bool | operator!= (const QgsNumericFormat &other) const |
bool | operator== (const QgsNumericFormat &other) const |
virtual int | sortKey () |
Returns a sorting key value, where formats with a lower sort key will be shown earlier in lists. More... | |
virtual double | suggestSampleValue () const |
Returns a suggested sample value which nicely represents the current format configuration. More... | |
virtual QString | visibleName () const =0 |
Returns the translated, user-visible name for this format. More... | |
void | writeXml (QDomElement &element, QDomDocument &document, const QgsReadWriteContext &context) const |
Writes the format to an XML element. More... | |
Additional Inherited Members | |
Public Types inherited from QgsBasicNumericFormat | |
enum | RoundingType { DecimalPlaces , SignificantFigures } |
Sets rounding type and behavior of the numberDecimalPlaces() setting. More... | |
Protected Member Functions inherited from QgsBasicNumericFormat | |
virtual void | setConfiguration (const QVariantMap &configuration, const QgsReadWriteContext &context) |
Sets the format's configuration. More... | |
Protected Attributes inherited from QgsBasicNumericFormat | |
bool | mUseScientific = false |
Static Protected Attributes inherited from QgsNumericFormat | |
static constexpr int | DEFAULT_SORT_KEY = 100 |
A numeric formatter which returns a text representation of a currency value.
Definition at line 28 of file qgscurrencynumericformat.h.
QgsCurrencyNumericFormat::QgsCurrencyNumericFormat | ( | ) |
Default constructor.
Definition at line 21 of file qgscurrencynumericformat.cpp.
|
overridevirtual |
Clones the format, returning a new object.
The caller takes ownership of the returned object.
Reimplemented from QgsBasicNumericFormat.
Definition at line 57 of file qgscurrencynumericformat.cpp.
|
overridevirtual |
Returns the current configuration of the formatter.
This value can be used in a call to create() in order to recreate this formatter in its current state.
Reimplemented from QgsBasicNumericFormat.
Definition at line 77 of file qgscurrencynumericformat.cpp.
|
overridevirtual |
Creates a new copy of the format, using the supplied configuration.
The caller takes ownership of the returned object.
Reimplemented from QgsBasicNumericFormat.
Definition at line 62 of file qgscurrencynumericformat.cpp.
|
overridevirtual |
Returns a formatted string representation of a numeric double value.
Reimplemented from QgsBasicNumericFormat.
Definition at line 48 of file qgscurrencynumericformat.cpp.
|
overridevirtual |
Returns a unique id for this numeric format.
This id is used to identify this numeric format in the registry with QgsNumericFormatRegistry::format().
Reimplemented from QgsBasicNumericFormat.
Definition at line 28 of file qgscurrencynumericformat.cpp.
QString QgsCurrencyNumericFormat::prefix | ( | ) | const |
Returns the currency prefix, e.g.
"$".
Definition at line 85 of file qgscurrencynumericformat.cpp.
void QgsCurrencyNumericFormat::setPrefix | ( | const QString & | prefix | ) |
Sets the currency prefix, e.g.
"$".
Definition at line 90 of file qgscurrencynumericformat.cpp.
void QgsCurrencyNumericFormat::setSuffix | ( | const QString & | suffix | ) |
Sets the currency suffix, e.g.
"AUD".
Definition at line 100 of file qgscurrencynumericformat.cpp.
|
overridevirtual |
Returns a sorting key value, where formats with a lower sort key will be shown earlier in lists.
Generally, subclasses should return QgsNumericFormat::sortKey() as their sorting key.
Reimplemented from QgsBasicNumericFormat.
Definition at line 38 of file qgscurrencynumericformat.cpp.
QString QgsCurrencyNumericFormat::suffix | ( | ) | const |
Returns the currency suffix, e.g.
"AUD".
Definition at line 95 of file qgscurrencynumericformat.cpp.
|
overridevirtual |
Returns a suggested sample value which nicely represents the current format configuration.
Reimplemented from QgsNumericFormat.
Definition at line 43 of file qgscurrencynumericformat.cpp.
|
overridevirtual |
Returns the translated, user-visible name for this format.
Reimplemented from QgsBasicNumericFormat.
Definition at line 33 of file qgscurrencynumericformat.cpp.