// Modified by:
// Created: 04/01/98
// RCS-ID: $Id$
-// Copyright: (c) Julian Smart and Markus Holzem
+// Copyright: (c) Julian Smart
// Licence: wxWindows license
/////////////////////////////////////////////////////////////////////////////
-#ifdef __GNUG__
-#pragma implementation
-#pragma interface
-#endif
+// NOTE: don't miss the "readme.txt" file which comes with this sample!
+
+
+
+// ============================================================================
+// declarations
+// ============================================================================
+
+// ----------------------------------------------------------------------------
+// headers
+// ----------------------------------------------------------------------------
// For compilers that support precompilation, includes "wx/wx.h".
#include "wx/wxprec.h"
#endif
#ifndef WX_PRECOMP
-#include "wx/wx.h"
+ #include "wx/wx.h"
#endif
#include "wx/intl.h"
#include "wx/file.h"
#include "wx/log.h"
+#include "wx/cmdline.h"
-#if defined(__WXGTK__) || defined(__WXMOTIF__)
+#if defined(__WXGTK__) || defined(__WXX11__) || defined(__WXMOTIF__) || defined(__WXMAC__) || defined(__WXMGL__)
#include "mondrian.xpm"
#endif
+// ----------------------------------------------------------------------------
+// private classes
+// ----------------------------------------------------------------------------
+
// Define a new application type
class MyApp: public wxApp
{
public:
- virtual bool OnInit();
+ MyApp() { m_lang = wxLANGUAGE_UNKNOWN; }
+
+ virtual void OnInitCmdLine(wxCmdLineParser& parser);
+ virtual bool OnCmdLineParsed(wxCmdLineParser& parser);
+ virtual bool OnInit();
protected:
- wxLocale m_locale; // locale we'll be using
+ wxLanguage m_lang; // language specified by user
+ wxLocale m_locale; // locale we'll be using
};
// Define a new frame type
class MyFrame: public wxFrame
-{
+{
public:
- MyFrame(wxFrame *frame, const char *title, int x, int y, int w, int h);
+ MyFrame(wxLocale& m_locale);
public:
- void OnQuit(wxCommandEvent& event);
- void OnAbout(wxCommandEvent& event);
- void OnPlay(wxCommandEvent& event);
- void OnOpen(wxCommandEvent& event);
+ void OnTestLocaleAvail(wxCommandEvent& event);
+ void OnAbout(wxCommandEvent& event);
+ void OnQuit(wxCommandEvent& event);
+
+ void OnPlay(wxCommandEvent& event);
+ void OnOpen(wxCommandEvent& event);
+ void OnTest1(wxCommandEvent& event);
+ void OnTest2(wxCommandEvent& event);
+ void OnTest3(wxCommandEvent& event);
+
+ DECLARE_EVENT_TABLE()
- DECLARE_EVENT_TABLE()
+ wxLocale& m_locale;
};
+// ----------------------------------------------------------------------------
+// constants
+// ----------------------------------------------------------------------------
+
// ID for the menu commands
enum
{
- MINIMAL_QUIT = 1,
- MINIMAL_TEXT,
- MINIMAL_ABOUT,
- MINIMAL_TEST,
- MINIMAL_OPEN
+ INTERNAT_TEST = wxID_HIGHEST + 1,
+ INTERNAT_PLAY,
+ INTERNAT_TEST_1,
+ INTERNAT_TEST_2,
+ INTERNAT_TEST_3
};
+// language data
+static const wxLanguage langIds[] =
+{
+ wxLANGUAGE_DEFAULT,
+ wxLANGUAGE_FRENCH,
+ wxLANGUAGE_ITALIAN,
+ wxLANGUAGE_GERMAN,
+ wxLANGUAGE_RUSSIAN,
+ wxLANGUAGE_BULGARIAN,
+ wxLANGUAGE_CZECH,
+ wxLANGUAGE_POLISH,
+ wxLANGUAGE_SWEDISH,
+#if wxUSE_UNICODE || defined(__WXMOTIF__)
+ wxLANGUAGE_JAPANESE,
+#endif
+#if wxUSE_UNICODE
+ wxLANGUAGE_GEORGIAN,
+ wxLANGUAGE_ENGLISH,
+ wxLANGUAGE_ENGLISH_US,
+ wxLANGUAGE_ARABIC,
+ wxLANGUAGE_ARABIC_EGYPT
+#endif
+};
+
+// note that it makes no sense to translate these strings, they are
+// shown before we set the locale anyhow
+const wxString langNames[] =
+{
+ "System default",
+ "French",
+ "Italian",
+ "German",
+ "Russian",
+ "Bulgarian",
+ "Czech",
+ "Polish",
+ "Swedish",
+#if wxUSE_UNICODE || defined(__WXMOTIF__)
+ "Japanese",
+#endif
+#if wxUSE_UNICODE
+ "Georgian",
+ "English",
+ "English (U.S.)",
+ "Arabic",
+ "Arabic (Egypt)"
+#endif
+};
+
+// the arrays must be in sync
+wxCOMPILE_TIME_ASSERT( WXSIZEOF(langNames) == WXSIZEOF(langIds),
+ LangArraysMismatch );
+
+// ----------------------------------------------------------------------------
+// wxWidgets macros
+// ----------------------------------------------------------------------------
+
BEGIN_EVENT_TABLE(MyFrame, wxFrame)
- EVT_MENU(MINIMAL_QUIT, MyFrame::OnQuit)
- EVT_MENU(MINIMAL_ABOUT, MyFrame::OnAbout)
- EVT_MENU(MINIMAL_TEST, MyFrame::OnPlay)
- EVT_MENU(MINIMAL_OPEN, MyFrame::OnOpen)
+ EVT_MENU(INTERNAT_TEST, MyFrame::OnTestLocaleAvail)
+ EVT_MENU(wxID_ABOUT, MyFrame::OnAbout)
+ EVT_MENU(wxID_EXIT, MyFrame::OnQuit)
+
+ EVT_MENU(INTERNAT_PLAY, MyFrame::OnPlay)
+ EVT_MENU(wxID_OPEN, MyFrame::OnOpen)
+ EVT_MENU(INTERNAT_TEST_1, MyFrame::OnTest1)
+ EVT_MENU(INTERNAT_TEST_2, MyFrame::OnTest2)
+ EVT_MENU(INTERNAT_TEST_3, MyFrame::OnTest3)
END_EVENT_TABLE()
IMPLEMENT_APP(MyApp)
+// ============================================================================
+// implementation
+// ============================================================================
+
+// ----------------------------------------------------------------------------
+// MyApp
+// ----------------------------------------------------------------------------
+
+// command line arguments handling
+void MyApp::OnInitCmdLine(wxCmdLineParser& parser)
+{
+ parser.AddParam(_("locale"),
+ wxCMD_LINE_VAL_STRING,
+ wxCMD_LINE_PARAM_OPTIONAL);
+
+ wxApp::OnInitCmdLine(parser);
+}
+
+bool MyApp::OnCmdLineParsed(wxCmdLineParser& parser)
+{
+ if ( !wxApp::OnCmdLineParsed(parser) )
+ return false;
+
+ if ( parser.GetParamCount() )
+ {
+ const wxString loc = parser.GetParam();
+ const wxLanguageInfo * const lang = wxLocale::FindLanguageInfo(loc);
+ if ( !lang )
+ {
+ wxLogError(_("Locale \"%s\" is unknown."), loc);
+ return false;
+ }
+
+ m_lang = static_cast<wxLanguage>(lang->Language);
+ }
+
+ return true;
+}
// `Main program' equivalent, creating windows and returning main app frame
bool MyApp::OnInit()
{
- // set the language to use
- const char *language = NULL;
- const char *langid = NULL;
- switch ( argc )
- {
- default:
- // ignore the other args, fall through
-
- case 3:
- language = argv[1];
- langid = argv[2];
- break;
-
- case 2:
- language = argv[1];
- break;
-
- case 1:
- language = "french";
- langid = "fr";
- };
-
- // there are very few systems right now which support locales other than "C"
- m_locale.Init(language, langid, "C");
-
- // Initialize the catalogs we'll be using
- /* not needed any more, done in wxLocale ctor
- m_locale.AddCatalog("wxstd"); // 1) for library messages
- */
- m_locale.AddCatalog("internat"); // 2) our private one
- /* this catalog is installed in standard location on Linux systems,
- it might not be installed on yours - just ignore the errrors
- or comment out this line then */
-// m_locale.AddCatalog("fileutils"); // 3) and another just for testing
-
- // Create the main frame window
- MyFrame *frame = new MyFrame((wxFrame *) NULL, _("International wxWindows App"),
- 50, 50, 350, 60);
-
- // Give it an icon
- frame->SetIcon(wxICON(mondrian));
-
- // Make a menubar
- wxMenu *file_menu = new wxMenu;
- file_menu->Append(MINIMAL_ABOUT, _("&About..."));
- file_menu->AppendSeparator();
- file_menu->Append(MINIMAL_QUIT, _("E&xit"));
-
- wxMenu *test_menu = new wxMenu;
- test_menu->Append(MINIMAL_OPEN, _("&Open bogus file"));
- test_menu->Append(MINIMAL_TEST, _("&Play a game"));
-
- wxMenuBar *menu_bar = new wxMenuBar;
- menu_bar->Append(file_menu, _("&File"));
- menu_bar->Append(test_menu, _("&Test"));
- frame->SetMenuBar(menu_bar);
-
- // Show the frame
- frame->Show(TRUE);
- SetTopWindow(frame);
-
- return TRUE;
+ if ( !wxApp::OnInit() )
+ return false;
+
+ if ( m_lang == wxLANGUAGE_UNKNOWN )
+ {
+ int lng = wxGetSingleChoiceIndex
+ (
+ _("Please choose language:"),
+ _("Language"),
+ WXSIZEOF(langNames),
+ langNames
+ );
+ m_lang = lng == -1 ? wxLANGUAGE_DEFAULT : langIds[lng];
+ }
+
+ // don't use wxLOCALE_LOAD_DEFAULT flag so that Init() doesn't return
+ // false just because it failed to load wxstd catalog
+ if ( !m_locale.Init(m_lang, wxLOCALE_CONV_ENCODING) )
+ {
+ wxLogWarning(_("This language is not supported by the system."));
+
+ // continue nevertheless
+ }
+
+ // normally this wouldn't be necessary as the catalog files would be found
+ // in the default locations, but when the program is not installed the
+ // catalogs are in the build directory where we wouldn't find them by
+ // default
+ wxLocale::AddCatalogLookupPathPrefix(".");
+
+ // Initialize the catalogs we'll be using
+ const wxLanguageInfo* pInfo = wxLocale::GetLanguageInfo(m_lang);
+ if (!m_locale.AddCatalog("internat"))
+ wxLogError(_("Couldn't find/load the 'internat' catalog for locale '%s'."),
+ pInfo ? pInfo->GetLocaleName() : _("unknown"));
+
+ // Now try to add wxstd.mo so that loading "NOTEXIST.ING" file will produce
+ // a localized error message:
+ m_locale.AddCatalog("wxstd.mo");
+ // NOTE: it's not an error if we couldn't find it!
+
+ // this catalog is installed in standard location on Linux systems and
+ // shows that you may make use of the standard message catalogs as well
+ //
+ // if it's not installed on your system, it is just silently ignored
+#ifdef __LINUX__
+ {
+ wxLogNull noLog;
+ m_locale.AddCatalog("fileutils");
+ }
+#endif
+
+ // Create the main frame window
+ MyFrame *frame = new MyFrame(m_locale);
+
+ // Show the frame
+ frame->Show(true);
+ SetTopWindow(frame);
+
+ return true;
}
-// My frame constructor
-MyFrame::MyFrame(wxFrame *frame, const char *title, int x, int y, int w, int h)
- : wxFrame(frame, -1, title, wxPoint(x, y), wxSize(w, h))
+// ----------------------------------------------------------------------------
+// MyFrame
+// ----------------------------------------------------------------------------
+
+// main frame constructor
+MyFrame::MyFrame(wxLocale& locale)
+ : wxFrame(NULL,
+ wxID_ANY,
+ _("International wxWidgets App")),
+ m_locale(locale)
{
+ SetIcon(wxICON(mondrian));
+
+ // Make a menubar
+ wxMenu *file_menu = new wxMenu;
+ file_menu->Append(INTERNAT_TEST, _("&Test locale availability...\tCtrl-T"));
+ file_menu->AppendSeparator();
+
+ // since wxID_ABOUT and wxID_EXIT are stock IDs they will automatically get
+ // translated help strings; nice isn't it?
+ file_menu->Append(wxID_ABOUT, _("&About..."));
+ file_menu->AppendSeparator();
+ file_menu->Append(wxID_EXIT, _("E&xit"));
+
+ wxMenu *test_menu = new wxMenu;
+ test_menu->Append(wxID_OPEN, _("&Open bogus file"), _("Shows a wxWidgets localized error message"));
+ test_menu->Append(INTERNAT_PLAY, _("&Play a game"), _("A little game; hint: 17 is a lucky number for many"));
+ test_menu->AppendSeparator();
+ test_menu->Append(INTERNAT_TEST_1, _("&1 _() (gettext)"), _("Tests the _() macro"));
+ test_menu->Append(INTERNAT_TEST_2, _("&2 _N() (ngettext)"), _("Tests the _N() macro"));
+ test_menu->Append(INTERNAT_TEST_3, _("&3 wxTRANSLATE() (gettext_noop)"), _("Tests the wxTRANSLATE() macro"));
+
+ wxMenuBar *menu_bar = new wxMenuBar;
+ menu_bar->Append(file_menu, _("&File"));
+ menu_bar->Append(test_menu, _("&Test"));
+ SetMenuBar(menu_bar);
+
+ // this demonstrates RTL support in wxStatusBar:
+ CreateStatusBar(1);
+
+ // this demonstrates RTL layout mirroring for Arabic locales
+ wxSizer *sizer = new wxBoxSizer(wxHORIZONTAL);
+ sizer->Add(new wxStaticText(this, wxID_ANY, _("First")),
+ wxSizerFlags().Border());
+ sizer->Add(new wxStaticText(this, wxID_ANY, _("Second")),
+ wxSizerFlags().Border());
+ SetSizer(sizer);
}
void MyFrame::OnQuit(wxCommandEvent& WXUNUSED(event) )
{
- Close(TRUE);
+ Close(true);
}
void MyFrame::OnAbout(wxCommandEvent& WXUNUSED(event))
{
- wxMessageDialog(this, _("I18n sample\n"
- "© 1998, 1999 Vadim Zeitlin and Julian Smart"),
- _("About Internat"), wxOK | wxICON_INFORMATION).ShowModal();
+ wxString localeInfo;
+ wxString locale = m_locale.GetLocale();
+ wxString sysname = m_locale.GetSysName();
+ wxString canname = m_locale.GetCanonicalName();
+
+ localeInfo.Printf(_("Language: %s\nSystem locale name: %s\nCanonical locale name: %s\n"),
+ locale.c_str(), sysname.c_str(), canname.c_str() );
+
+ wxMessageDialog dlg(
+ this,
+ wxString(_("I18n sample\n(c) 1998, 1999 Vadim Zeitlin and Julian Smart"))
+ + "\n\n"
+ + localeInfo,
+ _("About Internat"),
+ wxOK | wxICON_INFORMATION
+ );
+ dlg.ShowModal();
}
void MyFrame::OnPlay(wxCommandEvent& WXUNUSED(event))
{
- wxString str = wxGetTextFromUser(_("Enter your number:"),
- _("Try to guess my number!"),
- "", this);
- if ( str.IsEmpty() )
- return;
-
- int num;
- sscanf(str, "%d", &num);
- if ( num == 0 )
- str = _("You've probably entered an invalid number.");
- else if ( num == 9 ) // this message is not translated (not in catalog)
- str = "You've found a bug in this program!";
- else if ( num != 17 ) // a more implicit way to write _()
- str = wxGetTranslation("Bad luck! try again...");
- else {
- str.Empty();
- // string must be split in two -- otherwise the translation won't be found
- str << _("Congratulations! you've won. Here is the magic phrase:")
- << _("cannot create fifo `%s'");
- }
-
- wxMessageBox(str, _("Result"), wxOK | wxICON_INFORMATION);
+ wxString str = wxGetTextFromUser
+ (
+ _("Enter your number:"),
+ _("Try to guess my number!"),
+ wxEmptyString,
+ this
+ );
+
+ if ( str.empty() )
+ {
+ // cancelled
+ return;
+ }
+
+ long num;
+ if ( !str.ToLong(&num) || num < 0 )
+ {
+ str = _("You've probably entered an invalid number.");
+ }
+ else if ( num == 9 )
+ {
+ // this message is not translated (not in catalog) because we used _T()
+ // and not _() around it
+ str = _T("You've found a bug in this program!");
+ }
+ else if ( num == 17 )
+ {
+ str.clear();
+
+ // string must be split in two -- otherwise the translation would't be
+ // found
+ str << _("Congratulations! you've won. Here is the magic phrase:")
+ << _("cannot create fifo `%s'");
+ }
+ else
+ {
+ // this is a more implicit way to write _() but note that if you use it
+ // you must ensure that the strings get extracted in the message
+ // catalog as by default xgettext won't do it; it only knows of _(),
+ // not of wxTRANSLATE(). As internat's readme.txt says you should thus
+ // call xgettext with -kwxTRANSLATE.
+ str = wxGetTranslation(wxTRANSLATE("Bad luck! try again..."));
+
+ // note also that if we want 'str' to contain a localized string
+ // we need to use wxGetTranslation explicitely as wxTRANSLATE just
+ // tells xgettext to extract the string but has no effect on the
+ // runtime of the program!
+ }
+
+ wxMessageBox(str, _("Result"), wxOK | wxICON_INFORMATION);
}
-void MyFrame::OnOpen(wxCommandEvent&)
+void MyFrame::OnTestLocaleAvail(wxCommandEvent& WXUNUSED(event))
{
- // open a bogus file -- the error message should be also translated if you've
- // got wxstd.mo somewhere in the search path
- wxFile file("NOTEXIST.ING");
+ static wxString s_locale;
+ wxString locale = wxGetTextFromUser
+ (
+ _("Enter the locale to test"),
+ wxGetTextFromUserPromptStr,
+ s_locale,
+ this
+ );
+ if ( locale.empty() )
+ return;
+
+ s_locale = locale;
+ const wxLanguageInfo * const info = wxLocale::FindLanguageInfo(s_locale);
+ if ( !info )
+ {
+ wxLogError(_("Locale \"%s\" is unknown."), s_locale.c_str());
+ return;
+ }
+
+ if ( wxLocale::IsAvailable(info->Language) )
+ wxLogMessage(_("Locale \"%s\" is available."), s_locale.c_str());
+ else
+ wxLogWarning(_("Locale \"%s\" is not available."), s_locale.c_str());
}
+
+void MyFrame::OnOpen(wxCommandEvent& WXUNUSED(event))
+{
+ // open a bogus file -- the error message should be also translated if
+ // you've got wxstd.mo somewhere in the search path (see MyApp::OnInit)
+ wxFile file("NOTEXIST.ING");
+}
+
+void MyFrame::OnTest1(wxCommandEvent& WXUNUSED(event))
+{
+ const wxString& title = _("Testing _() (gettext)");
+
+ // NOTE: using the wxTRANSLATE() macro here we won't show a localized
+ // string in the text entry dialog; we'll simply show the un-translated
+ // string; however if the user press "ok" without altering the text,
+ // since the "default value" string has been extracted by xgettext
+ // the wxGetTranslation call later will manage to return a localized
+ // string
+ wxTextEntryDialog d(this, _("Please enter text to translate"),
+ title, wxTRANSLATE("default value"));
+
+ if (d.ShowModal() == wxID_OK)
+ {
+ wxString v = d.GetValue();
+ wxString s(title);
+ s << "\n" << v << " -> "
+ << wxGetTranslation(v.c_str()) << "\n";
+ wxMessageBox(s);
+ }
+}
+
+void MyFrame::OnTest2(wxCommandEvent& WXUNUSED(event))
+{
+ const wxString& title = _("Testing _N() (ngettext)");
+ wxTextEntryDialog d(this,
+ _("Please enter range for plural forms of \"n files deleted\" phrase"),
+ title, "0-10");
+
+ if (d.ShowModal() == wxID_OK)
+ {
+ int first, last;
+ wxSscanf(d.GetValue(), "%d-%d", &first, &last);
+ wxString s(title);
+ s << "\n";
+ for (int n = first; n <= last; ++n)
+ {
+ s << n << " " <<
+ wxPLURAL("file deleted", "files deleted", n) <<
+ "\n";
+ }
+ wxMessageBox(s);
+ }
+}
+
+void MyFrame::OnTest3(wxCommandEvent& WXUNUSED(event))
+{
+ const char* lines[] =
+ {
+ wxTRANSLATE("line 1"),
+ wxTRANSLATE("line 2"),
+ wxTRANSLATE("line 3"),
+ };
+
+ wxString s(_("Testing wxTRANSLATE() (gettext_noop)"));
+ s << "\n";
+ for (size_t i = 0; i < WXSIZEOF(lines); ++i)
+ {
+ s << lines[i] << " -> " << wxGetTranslation(lines[i]) << "\n";
+ }
+ wxMessageBox(s);
+}
+
+