]> git.saurik.com Git - wxWidgets.git/blobdiff - include/wx/intl.h
Generic dirctrl corrections
[wxWidgets.git] / include / wx / intl.h
index 3bbdd43355bc08b57dc17faf28ffe260de26b2e3..fd8960ae457011ccc7147afc593b414041ae08f1 100644 (file)
@@ -6,44 +6,44 @@
 // Created:     29/01/98
 // RCS-ID:      $Id$
 // Copyright:   (c) 1998 Vadim Zeitlin <zeitlin@dptmaths.ens-cachan.fr>
-// 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
 // ----------------------------------------------------------------------------
 class WXDLLEXPORT wxLocale;
 class WXDLLEXPORT wxMsgCatalog;
-extern WXDLLEXPORT_DATA(wxLocale *) g_pLocale;
 
 // ============================================================================
 // locale support
@@ -51,71 +51,121 @@ extern WXDLLEXPORT_DATA(wxLocale *) g_pLocale;
 
 // ----------------------------------------------------------------------------
 // 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/<lang>/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;
+
+    wxString       m_strLocale,       // this locale name
+                   m_strShort;        // short name for the locale
+
+    const wxChar  *m_pszOldLocale;    // previous locale from setlocale()
+    wxLocale      *m_pOldLocale;      // previous wxLocale
+
+    wxMsgCatalog  *m_pMsgCat;         // pointer to linked list of catalogs
+    
+    bool           m_bConvertEncoding;
 };
 
 // ----------------------------------------------------------------------------
 // global functions
 // ----------------------------------------------------------------------------
 
-WXDLLEXPORT wxLocale* wxGetLocale();
+// 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 WXDLLEXPORT const char *wxGetTranslation(const char *sz)
+// 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__