X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/dfbb5eff442e9bcabd494f0340553fbf49739b25..bf2c43c76e2819be443ab1d830ab68d9569d66b1:/interface/wx/intl.h diff --git a/interface/wx/intl.h b/interface/wx/intl.h index c0854e4337..1f16708437 100644 --- a/interface/wx/intl.h +++ b/interface/wx/intl.h @@ -2,8 +2,7 @@ // Name: intl.h // Purpose: interface of wxLocale // Author: wxWidgets team -// RCS-ID: $Id$ -// Licence: wxWindows license +// Licence: wxWindows licence ///////////////////////////////////////////////////////////////////////////// /** @@ -19,7 +18,7 @@ enum wxLayoutDirection }; /** - Encapsulates a ::wxLanguage indentifier together with OS-specific information + Encapsulates a ::wxLanguage identifier together with OS-specific information related to that language. @beginWxPerlOnly @@ -27,7 +26,7 @@ enum wxLayoutDirection - Wx::LanguageInfo->new(language, canonicalName, WinLang, WinSubLang, Description) @endWxPerlOnly */ -struct WXDLLIMPEXP_BASE wxLanguageInfo +struct wxLanguageInfo { /// ::wxLanguage id. /// It should be greater than @c wxLANGUAGE_USER_DEFINED when defining your own @@ -235,7 +234,7 @@ public: translate the messages using the message catalogs for this locale. */ wxLocale(const wxString& name, - const wxString& short = wxEmptyString, + const wxString& shortName = wxEmptyString, const wxString& locale = wxEmptyString, bool bLoadDefault = true); @@ -391,10 +390,17 @@ public: static wxString GetSystemEncodingName(); /** - Tries to detect the user's default language setting. + Tries to detect the user's default locale setting. Returns the ::wxLanguage value or @c wxLANGUAGE_UNKNOWN if the language-guessing algorithm failed. + + @note This function works with @em locales and returns the user's default + locale. This may be, and usually is, the same as their preferred UI + language, but it's not the same thing. Use wxTranslation to obtain + @em language information. + + @see wxTranslations::GetBestTranslation(). */ static int GetSystemLanguage(); @@ -459,7 +465,7 @@ public: given locale containing the translations of standard wxWidgets messages. This parameter would be rarely used in normal circumstances. */ - bool Init(const wxString& name, const wxString& short = wxEmptyString, + bool Init(const wxString& name, const wxString& shortName = wxEmptyString, const wxString& locale = wxEmptyString, bool bLoadDefault = true); /**