X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/c48908df67c6504891cccd34088cad955b1357ca..2706e543a6923d8e743c6ec21fcfe898a52aec88:/docs/latex/wx/locale.tex diff --git a/docs/latex/wx/locale.tex b/docs/latex/wx/locale.tex index ab513b33b8..22f4d123dc 100644 --- a/docs/latex/wx/locale.tex +++ b/docs/latex/wx/locale.tex @@ -55,6 +55,10 @@ No base class +\wxheading{Library} + +\helpref{wxBase}{librarieslist} + \latexignore{\rtfignore{\wxheading{Members}}} @@ -62,258 +66,12 @@ No base class \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} @@ -326,7 +84,7 @@ This is the default constructor and it does nothing to initialize the object: 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. @@ -350,9 +108,9 @@ set locale is restored and so the changes described in \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 @@ -394,11 +152,10 @@ code, see the instructions in \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//LC\_MESSAGES, prefix/LC\_MESSAGES and prefix +looked up under prefix//LC\_MESSAGES, prefix/ 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} @@ -430,9 +187,9 @@ struct WXDLLEXPORT wxLanguageInfo 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, @@ -450,7 +207,7 @@ is unknown. Note that even if the returned pointer is valid, the caller should \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 @@ -502,7 +259,7 @@ special meaning of \texttt{wxLANGUAGE\_DEFAULT}. \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, @@ -512,7 +269,7 @@ e.g. "English" or "French". \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). @@ -520,9 +277,9 @@ 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). @@ -533,13 +290,13 @@ a string is not found; use \helpref{wxLogNull}{wxlogoverview} to suppress it). 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} @@ -553,9 +310,9 @@ added later override those added before. \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. @@ -607,7 +364,7 @@ Returns \helpref{wxLanguage}{wxlanguage} value or \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. @@ -634,12 +391,12 @@ description of this behaviour. Note that this flag is meaningless in Unicode bui \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 @@ -665,6 +422,24 @@ translate the messages using the message catalogs for this locale. 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}}