X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/c801d85f158c4cba50b588807daabdcbd0ed3853..f9c165b1d621341bce1edd840ac71590c5d37f62:/include/wx/intl.h diff --git a/include/wx/intl.h b/include/wx/intl.h index d0bea59c9f..fd8960ae45 100644 --- a/include/wx/intl.h +++ b/include/wx/intl.h @@ -6,37 +6,38 @@ // Created: 29/01/98 // RCS-ID: $Id$ // Copyright: (c) 1998 Vadim Zeitlin -// Licence: wxWindows license +// Licence: wxWindows license ///////////////////////////////////////////////////////////////////////////// #ifndef __INTLH__ #define __INTLH__ #ifdef __GNUG__ -#pragma interface "intl.h" + #pragma interface "intl.h" #endif #include "wx/defs.h" #include "wx/string.h" +#if wxUSE_INTL + // ============================================================================ // global decls // ============================================================================ -// ---------------------------------------------------------------------------- -// simple types -// ---------------------------------------------------------------------------- - -// # adjust if necessary -typedef unsigned char uint8; -typedef unsigned long uint32; - // ---------------------------------------------------------------------------- // macros // ---------------------------------------------------------------------------- -// gettext() style macro -#define _(str) wxGetTranslation(str) +// gettext() style macro (notice that xgettext should be invoked with "-k_" +// option to extract the strings inside _() from the sources) +#ifndef WXINTL_NO_GETTEXT_MACRO + #define _(str) wxGetTranslation(_T(str)) +#endif + +// another one which just marks the strings for extraction, but doesn't +// perform the translation (use -kwxTRANSLATE with xgettext!) +#define wxTRANSLATE(str) _T(str) // ---------------------------------------------------------------------------- // forward decls @@ -44,116 +45,127 @@ typedef unsigned long uint32; class WXDLLEXPORT wxLocale; class WXDLLEXPORT wxMsgCatalog; -// ---------------------------------------------------------------------------- -// global functions -// ---------------------------------------------------------------------------- -extern wxLocale* WXDLLEXPORT wxGetLocale(); -inline const char* wxGetTranslation(const char *sz); - // ============================================================================ // locale support // ============================================================================ // ---------------------------------------------------------------------------- // wxLocale: encapsulates all language dependent settings, including current -// message catalogs, date, time and currency formats (#### to do) &c +// message catalogs, date, time and currency formats (TODO) &c // ---------------------------------------------------------------------------- class WXDLLEXPORT wxLocale { public: - // ctor & dtor - // the ctor has a side effect of changing current locale - wxLocale(const char *szName, // name (for messages) - const char *szShort = NULL, // dir prefix (for msg files) - const char *szLocale = NULL, // locale (for setlocale) - bool bLoadDefault = TRUE); // preload wxstd.mo? - // restores old locale - ~wxLocale(); - - // returns locale name - const char *GetLocale() const { return m_strLocale; } - - // add a catalog: it's searched for in standard places (current directory - // first, system one after). It will be used for message lookup by - // GetString(). - // - // Returns 'true' if it was successfully loaded - bool AddCatalog(const char *szDomain); - - // check if the given catalog is loaded - bool IsLoaded(const char *szDomain) const; - - // retrieve the translation for a string in all loaded domains unless - // the szDomain parameter is specified (and then only this domain is - // searched) - // - // return original string if translation is not available - // (in this case an error message is generated the first time - // a string is not found; use wxLogNull to suppress it) - // - // domains are searched in the last to first order, i.e. catalogs - // added later override those added before. - const char *GetString(const char *szOrigString, - const char *szDomain = NULL) const; + // ctor & dtor + // ----------- + + // call Init() if you use this ctor + wxLocale(); + // the ctor has a side effect of changing current locale + wxLocale(const wxChar *szName, // name (for messages) + const wxChar *szShort = (const wxChar *) NULL, // dir prefix (for msg files) + 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); } + // the same as a function (returns TRUE on success) + bool Init(const wxChar *szName, + const wxChar *szShort = (const wxChar *) NULL, + const wxChar *szLocale = (const wxChar *) NULL, + bool bLoadDefault = TRUE, + bool bConvertEncoding = FALSE); + // restores old locale + ~wxLocale(); + + // returns locale name + const wxChar *GetLocale() const { return m_strLocale; } + + // 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). + // + // This only applies to subsequent invocations of AddCatalog()! + static void AddCatalogLookupPathPrefix(const wxString& prefix); + + // add a catalog: it's searched for in standard places (current directory + // first, system one after), but the you may prepend additional directories to + // the search path with AddCatalogLookupPathPrefix(). + // + // The loaded catalog will be used for message lookup by GetString(). + // + // Returns 'true' if it was successfully loaded + bool AddCatalog(const wxChar *szDomain); + + // check if the given catalog is loaded + bool IsLoaded(const wxChar *szDomain) const; + + // retrieve the translation for a string in all loaded domains unless + // the szDomain parameter is specified (and then only this domain is + // searched) + // + // return original string if translation is not available + // (in this case an error message is generated the first time + // a string is not found; use wxLogNull to suppress it) + // + // 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; + + // Returns the current short name for the locale + const wxString& GetName() const { return m_strShort; } private: - // find catalog by name in a linked list, return NULL if !found - wxMsgCatalog *FindCatalog(const char *szDomain) const; - - wxString m_strLocale, // this locale name - m_strShort; // short name for the locale - - const char *m_pszOldLocale; // previous locale from setlocale() - wxLocale *m_pOldLocale; // previous wxLocale - - wxMsgCatalog *m_pMsgCat; // pointer to linked list of catalogs -}; + // find catalog by name in a linked list, return NULL if !found + wxMsgCatalog *FindCatalog(const wxChar *szDomain) const; -// ============================================================================ -// optional features -// ============================================================================ + wxString m_strLocale, // this locale name + m_strShort; // short name for the locale -// ---------------------------------------------------------------------------- -// wxTString: automatically translates strings to current language -// ---------------------------------------------------------------------------- + const wxChar *m_pszOldLocale; // previous locale from setlocale() + wxLocale *m_pOldLocale; // previous wxLocale -// this feature should be enabled by defining WX_USE_AUTOTRANS, if it's not -// done no automatic translation is performed -#if USE_AUTOTRANS - class WXDLLEXPORT wxTString - { - public: - // NB: different ctors do different things! - // does translation - wxTString(const char *sz) : m_pcsz(wxGetTranslation(sz)) { } - // no translation - wxTString(const wxString& s) : m_pcsz(s) { } - - // NB: no copy ctor, it must be a POD so that we can pass it - // to vararg functions (and it's not needed anyhow) + wxMsgCatalog *m_pMsgCat; // pointer to linked list of catalogs - // implicit conversion - operator const char *() const { return m_pcsz; } - - private: - const char *m_pcsz; - }; -#else //!USE_AUTOTRANS - #define wxTString wxString -#endif //USE_AUTOTRANS - -#define TRANSSTRING_DEFINED - + bool m_bConvertEncoding; +}; + // ---------------------------------------------------------------------------- -// inline functions +// global functions // ---------------------------------------------------------------------------- -// get the translation of the string in the current locale -inline const char *wxGetTranslation(const char *sz) +// get the current locale object (note that it may be NULL!) +extern WXDLLEXPORT wxLocale* wxGetLocale(); + +// get the translation of the string in the current locale +inline const wxMB2WXbuf wxGetTranslation(const wxChar *sz) { - wxLocale *pLoc = wxGetLocale(); - return pLoc == NULL ? sz : pLoc->GetString(sz); + wxLocale *pLoc = wxGetLocale(); + if (pLoc) + return pLoc->GetString(sz); + else + return (const wxMB2WXbuf)sz; } +#else // !wxUSE_INTL + +// the macros should still be defined - otherwise compilation would fail + +#if !defined(WXINTL_NO_GETTEXT_MACRO) && !defined(_) + #define _(str) (str) +#endif + +#define wxTRANSLATE(str) _T(str) + +inline const wxChar *wxGetTranslation(const wxChar *sz) { return sz; } + +#endif // wxUSE_INTL/!wxUSE_INTL + +// define this one just in case it occurs somewhere (instead of preferred +// wxTRANSLATE) too +#if !defined(WXINTL_NO_GETTEXT_MACRO) && !defined(gettext_noop) + #define gettext_noop(str) _T(str) +#endif + #endif - // __INTLH__ + // _WX_INTLH__