wxWidgets/include/wx/intl.h
Julian Smart 34138703c3 Changes mostly as a result of __WXSTUBS__ compilation. The stubs code now
compiles under Windows with VC++. Also OGL enhancements espec. wxDrawnShape.


git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@540 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
1998-08-15 00:23:28 +00:00

129 lines
4.6 KiB
C++

/////////////////////////////////////////////////////////////////////////////
// Name: 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 <zeitlin@dptmaths.ens-cachan.fr>
// Licence: wxWindows license
/////////////////////////////////////////////////////////////////////////////
#ifndef __INTLH__
#define __INTLH__
#ifdef __GNUG__
#pragma interface "intl.h"
#endif
#include "wx/defs.h"
#include "wx/string.h"
// ============================================================================
// global decls
// ============================================================================
// ----------------------------------------------------------------------------
// simple types
// ----------------------------------------------------------------------------
// # adjust if necessary
typedef unsigned char uint8;
typedef unsigned long uint32;
// ----------------------------------------------------------------------------
// macros
// ----------------------------------------------------------------------------
// gettext() style macro
#define _(str) wxGetTranslation(str)
// ----------------------------------------------------------------------------
// forward decls
// ----------------------------------------------------------------------------
class WXDLLEXPORT wxLocale;
class WXDLLEXPORT wxMsgCatalog;
extern WXDLLEXPORT_DATA(wxLocale *) g_pLocale;
// ============================================================================
// locale support
// ============================================================================
// ----------------------------------------------------------------------------
// wxLocale: encapsulates all language dependent settings, including current
// message catalogs, date, time and currency formats (#### to do) &c
// ----------------------------------------------------------------------------
class WXDLLEXPORT wxLocale
{
public:
// ctor & dtor
// call Init() if you use this ctor
wxLocale();
// 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?
{ Init(szName, szShort, szLocale, bLoadDefault); }
// the same as a function (returns TRUE on success)
bool Init(const char *szName,
const char *szShort = NULL,
const char *szLocale = NULL,
bool bLoadDefault = TRUE);
// 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;
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
};
// ----------------------------------------------------------------------------
// global functions
// ----------------------------------------------------------------------------
WXDLLEXPORT wxLocale* wxGetLocale();
// get the translation of the string in the current locale
inline WXDLLEXPORT const char *wxGetTranslation(const char *sz)
{
wxLocale *pLoc = wxGetLocale();
return pLoc == NULL ? sz : pLoc->GetString(sz);
}
#endif
// _WX_INTLH__