X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/fda91381cd9683cb9c147e53aee537ed1e4e710f..f11bdd03b9623a61bfe3137beeefd7b1256bb9a1:/include/wx/intl.h diff --git a/include/wx/intl.h b/include/wx/intl.h index 5d18ea981f..7005b680bb 100644 --- a/include/wx/intl.h +++ b/include/wx/intl.h @@ -1,5 +1,5 @@ ///////////////////////////////////////////////////////////////////////////// -// Name: intl.h +// Name: wx/intl.h // Purpose: Internationalization and localisation for wxWindows // Author: Vadim Zeitlin // Modified by: @@ -9,8 +9,8 @@ // Licence: wxWindows license ///////////////////////////////////////////////////////////////////////////// -#ifndef __INTLH__ -#define __INTLH__ +#ifndef _WX_INTL_H_ +#define _WX_INTL_H_ #ifdef __GNUG__ #pragma interface "intl.h" @@ -21,6 +21,8 @@ #if wxUSE_INTL +#include "wx/fontenc.h" + // ============================================================================ // global decls // ============================================================================ @@ -42,6 +44,7 @@ // ---------------------------------------------------------------------------- // forward decls // ---------------------------------------------------------------------------- + class WXDLLEXPORT wxLocale; class WXDLLEXPORT wxMsgCatalog; class WXDLLEXPORT wxLanguageInfoArray; @@ -50,21 +53,21 @@ class WXDLLEXPORT wxLanguageInfoArray; // locale support // ============================================================================ - // ---------------------------------------------------------------------------- // wxLanguage: defines all supported languages // ---------------------------------------------------------------------------- +// --- --- --- generated code begins here --- --- --- // This enum is generated by misc/languages/genlang.py // When making changes, please put them into misc/languages/langtabl.txt enum wxLanguage { // user's default/preffered language as got from OS: - wxLANGUAGE_DEFAULT, + wxLANGUAGE_DEFAULT, // unknown language, if wxLocale::GetSystemLanguage fails: - wxLANGUAGE_UNKNOWN, - + wxLANGUAGE_UNKNOWN, + wxLANGUAGE_ABKHAZIAN, wxLANGUAGE_AFAR, wxLANGUAGE_AFRIKAANS, @@ -298,6 +301,8 @@ enum wxLanguage wxLANGUAGE_USER_DEFINED }; +// --- --- --- generated code ends here --- --- --- + // ---------------------------------------------------------------------------- // wxLanguageInfo: encapsulates wxLanguage to OS native lang.desc. // translation information @@ -308,14 +313,12 @@ struct WXDLLEXPORT wxLanguageInfo int Language; // wxLanguage id wxString CanonicalName; // Canonical name, e.g. fr_FR #ifdef __WIN32__ - wxUint32 WinLang, WinSublang; // Win32 language identifiers -#endif + wxUint32 WinLang, // Win32 language identifiers + WinSublang; +#endif // __WIN32__ wxString Description; // human-readable name of the language }; - - - // ---------------------------------------------------------------------------- // wxLocale: encapsulates all language dependent settings, including current // message catalogs, date, time and currency formats (TODO) &c @@ -327,7 +330,6 @@ enum wxLocaleInitFlags wxLOCALE_CONV_ENCODING = 0x0002 // convert encoding on the fly? }; - class WXDLLEXPORT wxLocale { public: @@ -342,12 +344,11 @@ public: const wxChar *szLocale = (const wxChar *) NULL, // locale (for setlocale) bool bLoadDefault = TRUE, // preload wxstd.mo? bool bConvertEncoding = FALSE) // convert Win<->Unix if neccessary? - { - m_languagesDB = NULL; - Init(szName, szShort, szLocale, bLoadDefault, bConvertEncoding); + { + Init(szName, szShort, szLocale, bLoadDefault, bConvertEncoding); } - wxLocale(int language, // wxLanguage identifier + wxLocale(int language, // wxLanguage id or custom language int flags = wxLOCALE_LOAD_DEFAULT | wxLOCALE_CONV_ENCODING) { Init(language, flags); } @@ -358,33 +359,42 @@ public: bool bLoadDefault = TRUE, bool bConvertEncoding = FALSE); + // same as second ctor (returns TRUE on success) bool Init(int language = wxLANGUAGE_DEFAULT, int flags = wxLOCALE_LOAD_DEFAULT | wxLOCALE_CONV_ENCODING); + // restores old locale ~wxLocale(); - + // Try to get user's (or OS's) prefered language setting. - // Return wxLanguage value or wxLANGUAGE_UNKNOWN if language-guessing - // algorithm failed - int GetSystemLanguage() const; + // Return wxLANGUAGE_UNKNOWN if language-guessing algorithm failed + static int GetSystemLanguage(); + + // get the encoding used by default for text on this system, returns + // wxFONTENCODING_SYSTEM if it couldn't be determined + static wxFontEncoding GetSystemEncoding(); + + // get the string describing the system encoding, return empty string if + // couldn't be determined + static wxString GetSystemEncodingName(); // return TRUE if the locale was set successfully bool IsOk() const { return m_pszOldLocale != NULL; } // returns locale name const wxChar *GetLocale() const { return m_strLocale; } - + // return current locale wxLanguage value int GetLanguage() const { return m_language; } - // return locale name to be passed to setlocale() + // return locale name to be passed to setlocale() wxString GetSysName() const; - // return 'canonical' name, i.e. in the form of xx[_YY], where xx is + // return 'canonical' name, i.e. in the form of xx[_YY], where xx is // language code according to ISO 639 and YY is country name // as specified by ISO 3166. wxString GetCanonicalName() const { return m_strShort; } - + // 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 // (in this order). @@ -403,11 +413,11 @@ public: // check if the given catalog is loaded bool IsLoaded(const wxChar *szDomain) const; - + // Add custom language to the list of known languages. // Notes: 1) wxLanguageInfo contains platform-specific data // 2) must be called before Init to have effect - void AddLanguage(const wxLanguageInfo& info); + static void AddLanguage(const wxLanguageInfo& info); // retrieve the translation for a string in all loaded domains unless // the szDomain parameter is specified (and then only this domain is @@ -425,13 +435,19 @@ public: // Returns the current short name for the locale const wxString& GetName() const { return m_strShort; } + // These two methods are for internal use only. First one creates + // ms_languagesDB if it doesn't already exist, second one destroys + // it. + static void CreateLanguagesDB(); + static void DestroyLanguagesDB(); + private: // find catalog by name in a linked list, return NULL if !found wxMsgCatalog *FindCatalog(const wxChar *szDomain) const; - + // copy default table of languages from global static array to - // m_langugagesInfo - void InitLanguagesDB(); + // m_langugagesInfo, called by InitLanguagesDB + static void InitLanguagesDB(); wxString m_strLocale, // this locale name m_strShort; // short name for the locale @@ -441,10 +457,10 @@ private: wxLocale *m_pOldLocale; // previous wxLocale wxMsgCatalog *m_pMsgCat; // pointer to linked list of catalogs - + bool m_bConvertEncoding; - wxLanguageInfoArray *m_languagesDB; + static wxLanguageInfoArray *ms_languagesDB; }; // ---------------------------------------------------------------------------- @@ -474,7 +490,9 @@ inline const wxMB2WXbuf wxGetTranslation(const wxChar *sz) #define wxTRANSLATE(str) _T(str) -inline const wxChar *wxGetTranslation(const wxChar *sz) { return sz; } +// Note: use of 'inline' here can cause this symbol not to be found when compiled with gcc +//const wxChar *wxGetTranslation(const wxChar *sz); +#define wxGetTranslation(sz) (sz) #endif // wxUSE_INTL/!wxUSE_INTL @@ -484,5 +502,5 @@ inline const wxChar *wxGetTranslation(const wxChar *sz) { return sz; } #define gettext_noop(str) _T(str) #endif -#endif - // _WX_INTLH__ +#endif // _WX_INTL_H_ +