X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/4178000933f0618d2cc9dc2f80dfed91b0c61464..2f1e3c464ce0886163be49d4a10843f2b4c9679b:/include/wx/intl.h diff --git a/include/wx/intl.h b/include/wx/intl.h index 89128347c7..0ef2de8e3c 100644 --- a/include/wx/intl.h +++ b/include/wx/intl.h @@ -1,18 +1,18 @@ ///////////////////////////////////////////////////////////////////////////// -// Name: intl.h +// Name: wx/intl.h // Purpose: Internationalization and localisation for wxWindows // Author: Vadim Zeitlin // Modified by: // Created: 29/01/98 // RCS-ID: $Id$ // Copyright: (c) 1998 Vadim Zeitlin -// Licence: wxWindows license +// Licence: wxWindows licence ///////////////////////////////////////////////////////////////////////////// -#ifndef __INTLH__ -#define __INTLH__ +#ifndef _WX_INTL_H_ +#define _WX_INTL_H_ -#ifdef __GNUG__ +#if defined(__GNUG__) && !defined(__APPLE__) #pragma interface "intl.h" #endif @@ -21,6 +21,8 @@ #if wxUSE_INTL +#include "wx/fontenc.h" + // ============================================================================ // global decls // ============================================================================ @@ -43,9 +45,9 @@ // forward decls // ---------------------------------------------------------------------------- -class WXDLLEXPORT wxLocale; -class WXDLLEXPORT wxMsgCatalog; -class WXDLLEXPORT wxLanguageInfoArray; +class WXDLLIMPEXP_BASE wxLocale; +class WXDLLIMPEXP_BASE wxMsgCatalog; +class WXDLLIMPEXP_BASE wxLanguageInfoArray; // ============================================================================ // locale support @@ -62,10 +64,10 @@ class WXDLLEXPORT wxLanguageInfoArray; 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, @@ -301,23 +303,54 @@ enum wxLanguage // --- --- --- generated code ends here --- --- --- - - // ---------------------------------------------------------------------------- // wxLanguageInfo: encapsulates wxLanguage to OS native lang.desc. // translation information // ---------------------------------------------------------------------------- -struct WXDLLEXPORT wxLanguageInfo +struct WXDLLIMPEXP_BASE 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 }; +// ---------------------------------------------------------------------------- +// wxLocaleCategory: the category of locale settings +// ---------------------------------------------------------------------------- + +enum wxLocaleCategory +{ + // (any) numbers + wxLOCALE_CAT_NUMBER, + + // date/time + wxLOCALE_CAT_DATE, + + // monetary value + wxLOCALE_CAT_MONEY, + + wxLOCALE_CAT_MAX +}; + +// ---------------------------------------------------------------------------- +// wxLocaleInfo: the items understood by wxLocale::GetInfo() +// ---------------------------------------------------------------------------- + +enum wxLocaleInfo +{ + // the thounsands separator + wxLOCALE_THOUSANDS_SEP, + + // the character used as decimal point + wxLOCALE_DECIMAL_POINT + +}; + // ---------------------------------------------------------------------------- // wxLocale: encapsulates all language dependent settings, including current // message catalogs, date, time and currency formats (TODO) &c @@ -329,8 +362,7 @@ enum wxLocaleInitFlags wxLOCALE_CONV_ENCODING = 0x0002 // convert encoding on the fly? }; - -class WXDLLEXPORT wxLocale +class WXDLLIMPEXP_BASE wxLocale { public: // ctor & dtor @@ -344,8 +376,8 @@ public: const wxChar *szLocale = (const wxChar *) NULL, // locale (for setlocale) bool bLoadDefault = TRUE, // preload wxstd.mo? bool bConvertEncoding = FALSE) // convert Win<->Unix if neccessary? - { - Init(szName, szShort, szLocale, bLoadDefault, bConvertEncoding); + { + Init(szName, szShort, szLocale, bLoadDefault, bConvertEncoding); } wxLocale(int language, // wxLanguage id or custom language @@ -365,28 +397,40 @@ public: // restores old locale ~wxLocale(); - + // Try to get user's (or OS's) prefered language setting. // 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(); + + // get the values of the given locale-dependent datum: the current locale + // is used, the US default value is returned if everything else fails + static wxString GetInfo(wxLocaleInfo index, wxLocaleCategory cat); + // 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). @@ -405,7 +449,23 @@ public: // check if the given catalog is loaded bool IsLoaded(const wxChar *szDomain) const; - + + // Retrieve the language info struct for the given language + // + // Returns NULL if no info found, pointer must *not* be deleted by caller + static const wxLanguageInfo *GetLanguageInfo(int lang); + + // Returns language name in English or empty string if the language + // is not in database + static wxString GetLanguageName(int lang); + + // Find the language for the given locale string which may be either a + // canonical ISO 2 letter language code ("xx"), a language code followed by + // the country code ("xx_XX") or a Windows full language name ("Xxxxx...") + // + // Returns NULL if no info found, pointer must *not* be deleted by caller + static const wxLanguageInfo *FindLanguageInfo(const wxString& locale); + // 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 @@ -421,8 +481,8 @@ public: // // domains are searched in the last to first order, i.e. catalogs // added later override those added before. - const wxMB2WXbuf GetString(const wxChar *szOrigString, - const wxChar *szDomain = (const wxChar *) NULL) const; + const wxChar *GetString(const wxChar *szOrigString, + const wxChar *szDomain = (const wxChar *) NULL) const; // Returns the current short name for the locale const wxString& GetName() const { return m_strShort; } @@ -436,7 +496,7 @@ public: 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, called by InitLanguagesDB static void InitLanguagesDB(); @@ -449,10 +509,12 @@ private: wxLocale *m_pOldLocale; // previous wxLocale wxMsgCatalog *m_pMsgCat; // pointer to linked list of catalogs - + bool m_bConvertEncoding; static wxLanguageInfoArray *ms_languagesDB; + + DECLARE_NO_COPY_CLASS(wxLocale) }; // ---------------------------------------------------------------------------- @@ -460,16 +522,16 @@ private: // ---------------------------------------------------------------------------- // get the current locale object (note that it may be NULL!) -extern WXDLLEXPORT wxLocale* wxGetLocale(); +extern WXDLLIMPEXP_BASE wxLocale* wxGetLocale(); // get the translation of the string in the current locale -inline const wxMB2WXbuf wxGetTranslation(const wxChar *sz) +inline const wxChar *wxGetTranslation(const wxChar *sz) { wxLocale *pLoc = wxGetLocale(); if (pLoc) return pLoc->GetString(sz); else - return (const wxMB2WXbuf)sz; + return sz; } #else // !wxUSE_INTL @@ -477,12 +539,14 @@ inline const wxMB2WXbuf wxGetTranslation(const wxChar *sz) // the macros should still be defined - otherwise compilation would fail #if !defined(WXINTL_NO_GETTEXT_MACRO) && !defined(_) - #define _(str) (str) + #define _(str) (_T(str)) #endif #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 @@ -492,5 +556,5 @@ inline const wxChar *wxGetTranslation(const wxChar *sz) { return sz; } #define gettext_noop(str) _T(str) #endif -#endif - // _WX_INTLH__ +#endif // _WX_INTL_H_ +