QSystemLocale Class
The QSystemLocale class can be used to finetune the system locale of the user. \since
4.2. More...
Header: | #include <QSystemLocale> |
Public Types
struct | CurrencyToStringArgument |
enum | QueryType { LanguageId, ScriptId, TerritoryId, DecimalPoint, GroupSeparator, …, NativeTerritoryName } |
Public Functions
QSystemLocale() | |
virtual | ~QSystemLocale() |
Detailed Description
\internal
\inmodule
QtCore
\ingroup
i18n
Warning: This class is only useful in very rare cases. Usually QLocale offers all the functionality required for application development.
QSystemLocale allows to override the values provided by the system locale (QLocale::system()).
See also QLocale.
Member Type Documentation
enum QSystemLocale::QueryType
Specifies the type of information queried by query(). For each value the type of information to return from the query() method is listed.
Constant | Value | Description |
---|---|---|
QSystemLocale::LanguageId | 0 | a uint specifying the language. |
QSystemLocale::ScriptId | 36 | a uint specifying the script. |
QSystemLocale::TerritoryId | 1 | a uint specifying the territory. |
QSystemLocale::DecimalPoint | 2 | a QString specifying the decimal point. |
QSystemLocale::GroupSeparator | 3 | a QString specifying the group separator. |
QSystemLocale::ZeroDigit | 4 | a QString specifying the zero digit. |
QSystemLocale::NegativeSign | 5 | a QString specifying the minus sign. |
QSystemLocale::PositiveSign | 25 | a QString specifying the plus sign. |
QSystemLocale::DateFormatLong | 6 | a QString specifying the long date format |
QSystemLocale::DateFormatShort | 7 | a QString specifying the short date format |
QSystemLocale::TimeFormatLong | 8 | a QString specifying the long time format |
QSystemLocale::TimeFormatShort | 9 | a QString specifying the short time format |
QSystemLocale::DayNameLong | 10 | a QString specifying the name of a weekday. the in variant contains an integer between 1 and 7 (Monday - Sunday) |
QSystemLocale::DayNameShort | 11 | a QString specifying the short name of a weekday. the in variant contains an integer between 1 and 7 (Monday - Sunday) |
QSystemLocale::MonthNameLong | 13 | a QString specifying the name of a month. the in variant contains an integer between 1 and 12 |
QSystemLocale::MonthNameShort | 14 | a QString specifying the short name of a month. the in variant contains an integer between 1 and 12 |
QSystemLocale::DateToStringLong | 16 | converts the QDate stored in the in variant to a QString using the long date format |
QSystemLocale::DateToStringShort | 17 | converts the QDate stored in the in variant to a QString using the short date format |
QSystemLocale::TimeToStringLong | 18 | converts the QTime stored in the in variant to a QString using the long time format |
QSystemLocale::TimeToStringShort | 19 | converts the QTime stored in the in variant to a QString using the short time format |
QSystemLocale::DateTimeFormatLong | 20 | a QString specifying the long date time format |
QSystemLocale::DateTimeFormatShort | 21 | a QString specifying the short date time format |
QSystemLocale::DateTimeToStringLong | 22 | converts the QDateTime in the in variant to a QString using the long datetime format |
QSystemLocale::DateTimeToStringShort | 23 | converts the QDateTime in the in variant to a QString using the short datetime format |
QSystemLocale::MeasurementSystem | 24 | a QLocale::MeasurementSystem enum specifying the measurement system |
QSystemLocale::AMText | 26 | a string that represents the system AM designator associated with a 12-hour clock. |
QSystemLocale::PMText | 27 | a string that represents the system PM designator associated with a 12-hour clock. |
QSystemLocale::FirstDayOfWeek | 28 | a Qt::DayOfWeek enum specifying the first day of the week |
QSystemLocale::CurrencySymbol | 30 | a string that represents a currency in a format QLocale::CurrencyFormat. |
QSystemLocale::CurrencyToString | 31 | a localized string representation of a number with a currency symbol. Converts a QSystemLocale::CurrencyToStringArgument stored in the in variant to a QString. |
QSystemLocale::UILanguages | 33 | a list of strings representing locale names that could be used for UI translation. |
QSystemLocale::StringToStandardQuotation | 34 | a QString containing a quoted version of the string ref stored in the in variant using standard quotes. |
QSystemLocale::StringToAlternateQuotation | 35 | a QString containing a quoted version of the string ref stored in the in variant using alternate quotes. |
QSystemLocale::Weekdays | 29 | a QList<Qt::DayOfWeek> specifying the regular weekdays |
QSystemLocale::LocaleChanged | 38 | this type is queried whenever the system locale is changed. |
QSystemLocale::ListToSeparatedString | 37 | a string that represents a join of a given QStringList with a locale-defined separator. |
QSystemLocale::NativeLanguageName | 39 | a string that represents the name of the native language. |
QSystemLocale::NativeTerritoryName | 40 | a string that represents the name of the native territory. |
See also FormatType.
Member Function Documentation
QSystemLocale::QSystemLocale()
\internal
Constructs a QSystemLocale object.
The constructor will automatically install this object as the system locale. It and the destructor maintain a stack of system locales, with the most-recently-created instance (that hasn't yet been deleted) used as the system locale. This is only intended as a way to let a platform plugin install its own system locale, overriding what might otherwise be provided for its class of platform (as Android does, differing from Linux), and to let tests transiently over-ride the system or plugin-supplied one. As such, there should not be diverse threads creating and destroying QSystemLocale instances concurrently, so no attempt is made at thread-safety in managing the stack.
This constructor also resets the flag that'll prompt QLocale::system() to re-initialize its data, so that instantiating a QSystemLocale (even transiently) triggers a refresh of the system locale's data. This is exploited by some test code.
[virtual noexcept]
QSystemLocale::~QSystemLocale()
\internal
Deletes the object.