<wx/intl.h>
+\wxheading{Library}
+
+\helpref{wxBase}{librarieslist}
+
\latexignore{\rtfignore{\wxheading{Members}}}
\membersection{Supported languages}\label{wxlanguage}
-The following wxLanguage constants may be used to specify the language
+See \helpref{list of recognized language constants}{languagecodes}.
+These constants may be used to specify the language
in \helpref{Init}{wxlocaleinit} and are returned by
\helpref{GetSystemLanguage}{wxlocalegetsystemlanguage}:
-
-%% --- --- --- generated code begins here --- --- ---
-
-%% This enum is generated by misc/languages/genlang.py
-%% When making changes, please put them into misc/languages/langtabl.txt
-\begin{itemize}\itemsep=0pt
-\item wxLANGUAGE\_DEFAULT -- user's default language as obtained from the operating system
-\item wxLANGUAGE\_UNKNOWN -- returned by \helpref{GetSystemLanguage}{wxlocalegetsystemlanguage}
-if it fails to detect the default language
-\item wxLANGUAGE\_USER\_DEFINED -- user defined languages' integer identifiers should start from
-this
-\item wxLANGUAGE\_ABKHAZIAN
-\item wxLANGUAGE\_AFAR
-\item wxLANGUAGE\_AFRIKAANS
-\item wxLANGUAGE\_ALBANIAN
-\item wxLANGUAGE\_AMHARIC
-\item wxLANGUAGE\_ARABIC
-\item wxLANGUAGE\_ARABIC\_ALGERIA
-\item wxLANGUAGE\_ARABIC\_BAHRAIN
-\item wxLANGUAGE\_ARABIC\_EGYPT
-\item wxLANGUAGE\_ARABIC\_IRAQ
-\item wxLANGUAGE\_ARABIC\_JORDAN
-\item wxLANGUAGE\_ARABIC\_KUWAIT
-\item wxLANGUAGE\_ARABIC\_LEBANON
-\item wxLANGUAGE\_ARABIC\_LIBYA
-\item wxLANGUAGE\_ARABIC\_MOROCCO
-\item wxLANGUAGE\_ARABIC\_OMAN
-\item wxLANGUAGE\_ARABIC\_QATAR
-\item wxLANGUAGE\_ARABIC\_SAUDI\_ARABIA
-\item wxLANGUAGE\_ARABIC\_SUDAN
-\item wxLANGUAGE\_ARABIC\_SYRIA
-\item wxLANGUAGE\_ARABIC\_TUNISIA
-\item wxLANGUAGE\_ARABIC\_UAE
-\item wxLANGUAGE\_ARABIC\_YEMEN
-\item wxLANGUAGE\_ARMENIAN
-\item wxLANGUAGE\_ASSAMESE
-\item wxLANGUAGE\_AYMARA
-\item wxLANGUAGE\_AZERI
-\item wxLANGUAGE\_AZERI\_CYRILLIC
-\item wxLANGUAGE\_AZERI\_LATIN
-\item wxLANGUAGE\_BASHKIR
-\item wxLANGUAGE\_BASQUE
-\item wxLANGUAGE\_BELARUSIAN
-\item wxLANGUAGE\_BENGALI
-\item wxLANGUAGE\_BHUTANI
-\item wxLANGUAGE\_BIHARI
-\item wxLANGUAGE\_BISLAMA
-\item wxLANGUAGE\_BRETON
-\item wxLANGUAGE\_BULGARIAN
-\item wxLANGUAGE\_BURMESE
-\item wxLANGUAGE\_CAMBODIAN
-\item wxLANGUAGE\_CATALAN
-\item wxLANGUAGE\_CHINESE
-\item wxLANGUAGE\_CHINESE\_SIMPLIFIED
-\item wxLANGUAGE\_CHINESE\_TRADITIONAL
-\item wxLANGUAGE\_CHINESE\_HONGKONG
-\item wxLANGUAGE\_CHINESE\_MACAU
-\item wxLANGUAGE\_CHINESE\_SINGAPORE
-\item wxLANGUAGE\_CHINESE\_TAIWAN
-\item wxLANGUAGE\_CORSICAN
-\item wxLANGUAGE\_CROATIAN
-\item wxLANGUAGE\_CZECH
-\item wxLANGUAGE\_DANISH
-\item wxLANGUAGE\_DUTCH
-\item wxLANGUAGE\_DUTCH\_BELGIAN
-\item wxLANGUAGE\_ENGLISH
-\item wxLANGUAGE\_ENGLISH\_UK
-\item wxLANGUAGE\_ENGLISH\_US
-\item wxLANGUAGE\_ENGLISH\_AUSTRALIA
-\item wxLANGUAGE\_ENGLISH\_BELIZE
-\item wxLANGUAGE\_ENGLISH\_BOTSWANA
-\item wxLANGUAGE\_ENGLISH\_CANADA
-\item wxLANGUAGE\_ENGLISH\_CARIBBEAN
-\item wxLANGUAGE\_ENGLISH\_DENMARK
-\item wxLANGUAGE\_ENGLISH\_EIRE
-\item wxLANGUAGE\_ENGLISH\_JAMAICA
-\item wxLANGUAGE\_ENGLISH\_NEW\_ZEALAND
-\item wxLANGUAGE\_ENGLISH\_PHILIPPINES
-\item wxLANGUAGE\_ENGLISH\_SOUTH\_AFRICA
-\item wxLANGUAGE\_ENGLISH\_TRINIDAD
-\item wxLANGUAGE\_ENGLISH\_ZIMBABWE
-\item wxLANGUAGE\_ESPERANTO
-\item wxLANGUAGE\_ESTONIAN
-\item wxLANGUAGE\_FAEROESE
-\item wxLANGUAGE\_FARSI
-\item wxLANGUAGE\_FIJI
-\item wxLANGUAGE\_FINNISH
-\item wxLANGUAGE\_FRENCH
-\item wxLANGUAGE\_FRENCH\_BELGIAN
-\item wxLANGUAGE\_FRENCH\_CANADIAN
-\item wxLANGUAGE\_FRENCH\_LUXEMBOURG
-\item wxLANGUAGE\_FRENCH\_MONACO
-\item wxLANGUAGE\_FRENCH\_SWISS
-\item wxLANGUAGE\_FRISIAN
-\item wxLANGUAGE\_GALICIAN
-\item wxLANGUAGE\_GEORGIAN
-\item wxLANGUAGE\_GERMAN
-\item wxLANGUAGE\_GERMAN\_AUSTRIAN
-\item wxLANGUAGE\_GERMAN\_BELGIUM
-\item wxLANGUAGE\_GERMAN\_LIECHTENSTEIN
-\item wxLANGUAGE\_GERMAN\_LUXEMBOURG
-\item wxLANGUAGE\_GERMAN\_SWISS
-\item wxLANGUAGE\_GREEK
-\item wxLANGUAGE\_GREENLANDIC
-\item wxLANGUAGE\_GUARANI
-\item wxLANGUAGE\_GUJARATI
-\item wxLANGUAGE\_HAUSA
-\item wxLANGUAGE\_HEBREW
-\item wxLANGUAGE\_HINDI
-\item wxLANGUAGE\_HUNGARIAN
-\item wxLANGUAGE\_ICELANDIC
-\item wxLANGUAGE\_INDONESIAN
-\item wxLANGUAGE\_INTERLINGUA
-\item wxLANGUAGE\_INTERLINGUE
-\item wxLANGUAGE\_INUKTITUT
-\item wxLANGUAGE\_INUPIAK
-\item wxLANGUAGE\_IRISH
-\item wxLANGUAGE\_ITALIAN
-\item wxLANGUAGE\_ITALIAN\_SWISS
-\item wxLANGUAGE\_JAPANESE
-\item wxLANGUAGE\_JAVANESE
-\item wxLANGUAGE\_KANNADA
-\item wxLANGUAGE\_KASHMIRI
-\item wxLANGUAGE\_KASHMIRI\_INDIA
-\item wxLANGUAGE\_KAZAKH
-\item wxLANGUAGE\_KERNEWEK
-\item wxLANGUAGE\_KINYARWANDA
-\item wxLANGUAGE\_KIRGHIZ
-\item wxLANGUAGE\_KIRUNDI
-\item wxLANGUAGE\_KONKANI
-\item wxLANGUAGE\_KOREAN
-\item wxLANGUAGE\_KURDISH
-\item wxLANGUAGE\_LAOTHIAN
-\item wxLANGUAGE\_LATIN
-\item wxLANGUAGE\_LATVIAN
-\item wxLANGUAGE\_LINGALA
-\item wxLANGUAGE\_LITHUANIAN
-\item wxLANGUAGE\_MACEDONIAN
-\item wxLANGUAGE\_MALAGASY
-\item wxLANGUAGE\_MALAY
-\item wxLANGUAGE\_MALAYALAM
-\item wxLANGUAGE\_MALAY\_BRUNEI\_DARUSSALAM
-\item wxLANGUAGE\_MALAY\_MALAYSIA
-\item wxLANGUAGE\_MALTESE
-\item wxLANGUAGE\_MANIPURI
-\item wxLANGUAGE\_MAORI
-\item wxLANGUAGE\_MARATHI
-\item wxLANGUAGE\_MOLDAVIAN
-\item wxLANGUAGE\_MONGOLIAN
-\item wxLANGUAGE\_NAURU
-\item wxLANGUAGE\_NEPALI
-\item wxLANGUAGE\_NEPALI\_INDIA
-\item wxLANGUAGE\_NORWEGIAN\_BOKMAL
-\item wxLANGUAGE\_NORWEGIAN\_NYNORSK
-\item wxLANGUAGE\_OCCITAN
-\item wxLANGUAGE\_ORIYA
-\item wxLANGUAGE\_OROMO
-\item wxLANGUAGE\_PASHTO
-\item wxLANGUAGE\_POLISH
-\item wxLANGUAGE\_PORTUGUESE
-\item wxLANGUAGE\_PORTUGUESE\_BRAZILIAN
-\item wxLANGUAGE\_PUNJABI
-\item wxLANGUAGE\_QUECHUA
-\item wxLANGUAGE\_RHAETO\_ROMANCE
-\item wxLANGUAGE\_ROMANIAN
-\item wxLANGUAGE\_RUSSIAN
-\item wxLANGUAGE\_RUSSIAN\_UKRAINE
-\item wxLANGUAGE\_SAMOAN
-\item wxLANGUAGE\_SANGHO
-\item wxLANGUAGE\_SANSKRIT
-\item wxLANGUAGE\_SCOTS\_GAELIC
-\item wxLANGUAGE\_SERBIAN
-\item wxLANGUAGE\_SERBIAN\_CYRILLIC
-\item wxLANGUAGE\_SERBIAN\_LATIN
-\item wxLANGUAGE\_SERBO\_CROATIAN
-\item wxLANGUAGE\_SESOTHO
-\item wxLANGUAGE\_SETSWANA
-\item wxLANGUAGE\_SHONA
-\item wxLANGUAGE\_SINDHI
-\item wxLANGUAGE\_SINHALESE
-\item wxLANGUAGE\_SISWATI
-\item wxLANGUAGE\_SLOVAK
-\item wxLANGUAGE\_SLOVENIAN
-\item wxLANGUAGE\_SOMALI
-\item wxLANGUAGE\_SPANISH
-\item wxLANGUAGE\_SPANISH\_ARGENTINA
-\item wxLANGUAGE\_SPANISH\_BOLIVIA
-\item wxLANGUAGE\_SPANISH\_CHILE
-\item wxLANGUAGE\_SPANISH\_COLOMBIA
-\item wxLANGUAGE\_SPANISH\_COSTA\_RICA
-\item wxLANGUAGE\_SPANISH\_DOMINICAN\_REPUBLIC
-\item wxLANGUAGE\_SPANISH\_ECUADOR
-\item wxLANGUAGE\_SPANISH\_EL\_SALVADOR
-\item wxLANGUAGE\_SPANISH\_GUATEMALA
-\item wxLANGUAGE\_SPANISH\_HONDURAS
-\item wxLANGUAGE\_SPANISH\_MEXICAN
-\item wxLANGUAGE\_SPANISH\_MODERN
-\item wxLANGUAGE\_SPANISH\_NICARAGUA
-\item wxLANGUAGE\_SPANISH\_PANAMA
-\item wxLANGUAGE\_SPANISH\_PARAGUAY
-\item wxLANGUAGE\_SPANISH\_PERU
-\item wxLANGUAGE\_SPANISH\_PUERTO\_RICO
-\item wxLANGUAGE\_SPANISH\_URUGUAY
-\item wxLANGUAGE\_SPANISH\_US
-\item wxLANGUAGE\_SPANISH\_VENEZUELA
-\item wxLANGUAGE\_SUNDANESE
-\item wxLANGUAGE\_SWAHILI
-\item wxLANGUAGE\_SWEDISH
-\item wxLANGUAGE\_SWEDISH\_FINLAND
-\item wxLANGUAGE\_TAGALOG
-\item wxLANGUAGE\_TAJIK
-\item wxLANGUAGE\_TAMIL
-\item wxLANGUAGE\_TATAR
-\item wxLANGUAGE\_TELUGU
-\item wxLANGUAGE\_THAI
-\item wxLANGUAGE\_TIBETAN
-\item wxLANGUAGE\_TIGRINYA
-\item wxLANGUAGE\_TONGA
-\item wxLANGUAGE\_TSONGA
-\item wxLANGUAGE\_TURKISH
-\item wxLANGUAGE\_TURKMEN
-\item wxLANGUAGE\_TWI
-\item wxLANGUAGE\_UIGHUR
-\item wxLANGUAGE\_UKRAINIAN
-\item wxLANGUAGE\_URDU
-\item wxLANGUAGE\_URDU\_INDIA
-\item wxLANGUAGE\_URDU\_PAKISTAN
-\item wxLANGUAGE\_UZBEK
-\item wxLANGUAGE\_UZBEK\_CYRILLIC
-\item wxLANGUAGE\_UZBEK\_LATIN
-\item wxLANGUAGE\_VIETNAMESE
-\item wxLANGUAGE\_VOLAPUK
-\item wxLANGUAGE\_WELSH
-\item wxLANGUAGE\_WOLOF
-\item wxLANGUAGE\_XHOSA
-\item wxLANGUAGE\_YIDDISH
-\item wxLANGUAGE\_YORUBA
-\item wxLANGUAGE\_ZHUANG
-\item wxLANGUAGE\_ZULU
-\end{itemize}
-
-%% --- --- --- generated code ends here --- --- ---
-
-
-
-
-
\membersection{wxLocale::wxLocale}\label{wxlocaledefctor}
\func{}{wxLocale}{\void}
See \helpref{Init()}{wxlocaleinit} for parameters description.
-\func{}{wxLocale}{\param{const char }{*szName}, \param{const char }{*szShort = NULL}, \param{const char }{*szLocale = NULL}, \param{bool }{bLoadDefault = true}, \param{bool }{bConvertEncoding = false}}
+\func{}{wxLocale}{\param{const wxString\& }{name}, \param{const wxString\& }{short = wxEmptyString}, \param{const wxString\& }{locale = wxEmptyString}, \param{bool }{bLoadDefault = true}, \param{bool }{bConvertEncoding = false}}
See \helpref{Init()}{wxlocaleinit} for parameters description.
\membersection{wxLocale::AddCatalog}\label{wxlocaleaddcatalog}
-\func{bool}{AddCatalog}{\param{const char }{*szDomain}}
+\func{bool}{AddCatalog}{\param{const wxString\& }{domain}}
-\func{bool}{AddCatalog}{\param{const char }{*szDomain}, \param{wxLanguage}{msgIdLanguage}, \param{const char }{*msgIdCharset}}
+\func{bool}{AddCatalog}{\param{const wxString\& }{domain}, \param{wxLanguage}{msgIdLanguage}, \param{const wxString\& }{msgIdCharset}}
Add a catalog for use with the current locale: it is searched for in standard
places (current directory first, then the system one), but you may also prepend
\func{void}{AddCatalogLookupPathPrefix}{\param{const wxString\& }{prefix}}
Add a prefix to the catalog lookup path: the message catalog files will be
-looked up under prefix/<lang>/LC\_MESSAGES, prefix/LC\_MESSAGES and prefix
+looked up under prefix/<lang>/LC\_MESSAGES, prefix/<lang> and prefix
(in this order).
-This only applies to subsequent invocations of AddCatalog()!
-
+This only applies to subsequent invocations of AddCatalog().
\membersection{wxLocale::AddLanguage}\label{wxlocaleaddlanguage}
Wx::LanguageInfo->new( language, canonicalName, WinLang, WinSubLang, Description )}
-\membersection{wxLocale::FindLanguageInfo}{wxlocalefindlanguageinfo}
+\membersection{wxLocale::FindLanguageInfo}\label{wxlocalefindlanguageinfo}
-\constfunc{static wxLanguageInfo *}{FindLanguageInfo}{\param{const wxString\& }{locale}}
+\func{static wxLanguageInfo *}{FindLanguageInfo}{\param{const wxString\& }{locale}}
This function may be used to find the language description structure for the
given locale, specified either as a two letter ISO language code (for example,
\membersection{wxLocale::GetCanonicalName}\label{wxlocalegetcanonicalname}
-\constfunc{wxString}{GetSysName}{\void}
+\constfunc{wxString}{GetCanonicalName}{\void}
Returns the canonical form of current locale name. Canonical form is the
one that is used on UNIX systems: it is a two- or five-letter string in xx or
\membersection{wxLocale::GetLocale}\label{wxlocalegetlocale}
-\constfunc{const char*}{GetLocale}{\void}
+\constfunc{const wxString\& }{GetLocale}{\void}
Returns the locale name as passed to the constructor or
\helpref{Init()}{wxlocaleinit}. This is full, human-readable name,
\membersection{wxLocale::GetName}\label{wxlocalegetname}
-\constfunc{const wxString\&}{GetName}{\void}
+\constfunc{const wxString\& }{GetName}{\void}
Returns the current short name for the locale (as given to the constructor or
the Init() function).
\membersection{wxLocale::GetString}\label{wxlocalegetstring}
-\constfunc{const char*}{GetString}{\param{const char }{*szOrigString}, \param{const char }{*szDomain = NULL}}
+\constfunc{const wxString\& }{GetString}{\param{const wxString\& }{origString}, \param{const wxString\& }{domain = wxEmptyString}}
-\constfunc{const char*}{GetString}{\param{const char }{*szOrigString}, \param{const char }{*szOrigString2}, \param{size\_t }{n}, \param{const char }{*szDomain = NULL}}
+\constfunc{const wxString\& }{GetString}{\param{const wxString\& }{origString}, \param{const wxString\& }{origString2}, \param{size\_t }{n}, \param{const wxString\& }{domain = NULL}}
Retrieves the translation for a string in all loaded domains unless the szDomain
parameter is specified (and then only this catalog/domain is searched).
The second form is used when retrieving translation of string that has
different singular and plural form in English or different plural forms in some
-other language. It takes two extra arguments: \arg{szOrigString}
+other language. It takes two extra arguments: \arg{origString}
parameter must contain the singular form of the string to be converted.
It is also used as the key for the search in the catalog.
-The \arg{szOrigString2} parameter is the plural form (in English).
+The \arg{origString2} parameter is the plural form (in English).
The parameter \arg{n} is used to determine the plural form. If no
-message catalog is found \arg{szOrigString} is returned if `n == 1',
-otherwise \arg{szOrigString2}.
+message catalog is found \arg{origString} is returned if `n == 1',
+otherwise \arg{origString2}.
See \urlref{GNU gettext manual}{http://www.gnu.org/manual/gettext/html\_chapter/gettext\_10.html\#SEC150} for additional information on plural forms handling.
This method is called by the \helpref{wxGetTranslation}{wxgettranslation}
\membersection{wxLocale::GetHeaderValue}\label{wxlocalegetheadervalue}
-\constfunc{wxString}{GetHeaderValue}{\param{const char }{*szHeader}, \param{const char }{*szDomain = NULL}}
+\constfunc{wxString}{GetHeaderValue}{\param{const wxString\& }{header}, \param{const wxString\& }{domain = wxEmptyString}}
-Returns the header value for header \arg{szHeader}. The search for \arg{szHeader} is case sensitive. If an \arg{szDomain}
+Returns the header value for header \arg{header}. The search for \arg{header} is case sensitive. If an \arg{domain}
is passed, this domain is searched. Else all domains will be searched until a header has been found.
The return value is the value of the header if found. Else this will be empty.
\func{bool}{Init}{\param{int }{language = wxLANGUAGE\_DEFAULT}, \param{int }{flags =
wxLOCALE\_LOAD\_DEFAULT | wxLOCALE\_CONV\_ENCODING}}
-\func{bool}{Init}{\param{const char }{*szName}, \param{const char }{*szShort = NULL}, \param{const char }{*szLocale = NULL}, \param{bool }{bLoadDefault = true}, \param{bool }{bConvertEncoding = false}}
+\func{bool}{Init}{\param{const wxString\& }{name}, \param{const wxString\& }{short = wxEmptyString}, \param{const wxString\& }{locale = wxEmptyString}, \param{bool }{bLoadDefault = true}, \param{bool }{bConvertEncoding = false}}
The second form is deprecated, use the first one unless you know what you are
doing.
\end{twocollist}
}
-\docparam{szName}{The name of the locale. Only used in diagnostic messages.}
+\docparam{name}{The name of the locale. Only used in diagnostic messages.}
-\docparam{szShort}{The standard 2 letter locale abbreviation and is used as the
+\docparam{short}{The standard 2 letter locale abbreviation; it is used as the
directory prefix when looking for the message catalog files.}
-\docparam{szLocale}{The parameter for the call to setlocale(). Note that it is
+\docparam{locale}{The parameter for the call to setlocale(). Note that it is
platform-specific.}
\docparam{bLoadDefault}{May be set to false to prevent loading of the message catalog
Returns true on success or false if the given locale couldn't be set.
+\membersection{wxLocale::IsAvailable}\label{wxlocaleisavailable}
+
+\func{static bool}{IsAvailable}{\param{int }{lang}}
+
+Check whether the operating system and/or C run time environment supports
+this locale. For example in Windows 2000 and Windows XP, support for many
+locales is not installed by default. Returns \true if the locale is
+supported.
+
+The argument \arg{lang} is the wxLanguage identifier. To obtain this for a
+given a two letter ISO language code, use
+\helpref{FindLanguageInfo}{wxlocalefindlanguageinfo} to obtain its
+wxLanguageInfo structure. See \helpref{AddLanguage}{wxlocaleaddlanguage} for
+the wxLanguageInfo description.
+
+\newsince{2.7.1}.
+
+
\membersection{wxLocale::IsLoaded}\label{wxlocaleisloaded}
\constfunc{bool}{IsLoaded}{\param{const char* }{domain}}
projects / wxWidgets.git / blobdiff