samples/internat/internat.cpp

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        internat.cpp
   3 // Purpose:     Demonstrates internationalisation (i18n) support
   4 // Author:      Vadim Zeitlin/Julian Smart
   5 // Modified by:
   6 // Created:     04/01/98
   7 // RCS-ID:      $Id$
   8 // Copyright:   (c) Julian Smart
   9 // Licence:     wxWindows license
  10 /////////////////////////////////////////////////////////////////////////////
  11
  12 // ============================================================================
  13 // declarations
  14 // ============================================================================
  15
  16 // ----------------------------------------------------------------------------
  17 // headers
  18 // ----------------------------------------------------------------------------
  19
  20 // For compilers that support precompilation, includes "wx/wx.h".
  21 #include "wx/wxprec.h"
  22
  23 #ifdef __BORLANDC__
  24 #pragma hdrstop
  25 #endif
  26
  27 #ifndef WX_PRECOMP
  28 #include "wx/wx.h"
  29 #endif
  30
  31 #include "wx/intl.h"
  32 #include "wx/file.h"
  33 #include "wx/log.h"
  34
  35 #if defined(__WXGTK__) || defined(__WXX11__) || defined(__WXMOTIF__) || defined(__WXMAC__) || defined(__WXMGL__)
  36 #include "mondrian.xpm"
  37 #endif
  38
  39 // ----------------------------------------------------------------------------
  40 // private classes
  41 // ----------------------------------------------------------------------------
  42
  43 // Define a new application type
  44 class MyApp: public wxApp
  45 {
  46 public:
  47     virtual bool OnInit();
  48
  49 protected:
  50     wxLocale m_locale; // locale we'll be using
  51 };
  52
  53 // Define a new frame type
  54 class MyFrame: public wxFrame
  55 {
  56 public:
  57     MyFrame(wxLocale& m_locale);
  58
  59 public:
  60     void OnQuit(wxCommandEvent& event);
  61     void OnAbout(wxCommandEvent& event);
  62     void OnPlay(wxCommandEvent& event);
  63     void OnOpen(wxCommandEvent& event);
  64     void OnTest1(wxCommandEvent& event);
  65     void OnTest2(wxCommandEvent& event);
  66     void OnTest3(wxCommandEvent& event);
  67
  68     DECLARE_EVENT_TABLE()
  69
  70     wxLocale& m_locale;
  71 };
  72
  73 // ----------------------------------------------------------------------------
  74 // constants
  75 // ----------------------------------------------------------------------------
  76
  77 // ID for the menu commands
  78 enum
  79 {
  80     INTERNAT_TEXT = wxID_HIGHEST + 1,
  81     INTERNAT_TEST,
  82     INTERNAT_TEST_1,
  83     INTERNAT_TEST_2,
  84     INTERNAT_TEST_3,
  85     INTERNAT_OPEN
  86 };
  87
  88 // ----------------------------------------------------------------------------
  89 // wxWidgets macros
  90 // ----------------------------------------------------------------------------
  91
  92 BEGIN_EVENT_TABLE(MyFrame, wxFrame)
  93     EVT_MENU(wxID_EXIT, MyFrame::OnQuit)
  94     EVT_MENU(wxID_ABOUT, MyFrame::OnAbout)
  95     EVT_MENU(INTERNAT_TEST, MyFrame::OnPlay)
  96     EVT_MENU(INTERNAT_OPEN, MyFrame::OnOpen)
  97     EVT_MENU(INTERNAT_TEST_1, MyFrame::OnTest1)
  98     EVT_MENU(INTERNAT_TEST_2, MyFrame::OnTest2)
  99     EVT_MENU(INTERNAT_TEST_3, MyFrame::OnTest3)
 100 END_EVENT_TABLE()
 101
 102 IMPLEMENT_APP(MyApp)
 103
 104 // ============================================================================
 105 // implementation
 106 // ============================================================================
 107
 108 // ----------------------------------------------------------------------------
 109 // MyApp
 110 // ----------------------------------------------------------------------------
 111
 112 // `Main program' equivalent, creating windows and returning main app frame
 113 bool MyApp::OnInit()
 114 {
 115     long lng = -1;
 116
 117     if ( argc == 2 )
 118     {
 119         // the parameter must be the lang index
 120         wxString tmp(argv[1]);
 121         tmp.ToLong(&lng);
 122     }
 123
 124     static const wxLanguage langIds[] =
 125     {
 126         wxLANGUAGE_DEFAULT,
 127         wxLANGUAGE_FRENCH,
 128         wxLANGUAGE_GERMAN,
 129         wxLANGUAGE_RUSSIAN,
 130         wxLANGUAGE_BULGARIAN,
 131         wxLANGUAGE_CZECH,
 132         wxLANGUAGE_POLISH,
 133         wxLANGUAGE_SWEDISH,
 134 #if wxUSE_UNICODE || defined(__WXMOTIF__)
 135         wxLANGUAGE_JAPANESE,
 136 #endif
 137 #if wxUSE_UNICODE
 138         wxLANGUAGE_GEORGIAN,
 139 #endif
 140         wxLANGUAGE_ENGLISH,
 141         wxLANGUAGE_ENGLISH_US
 142     };
 143
 144     if ( lng == -1 )
 145     {
 146         // note that it makes no sense to translate these strings, they are
 147         // shown before we set the locale anyhow
 148         const wxString langNames[] =
 149         {
 150             _T("System default"),
 151             _T("French"),
 152             _T("German"),
 153             _T("Russian"),
 154             _T("Bulgarian"),
 155             _T("Czech"),
 156             _T("Polish"),
 157             _T("Swedish"),
 158 #if wxUSE_UNICODE || defined(__WXMOTIF__)
 159             _T("Japanese"),
 160 #endif
 161 #if wxUSE_UNICODE
 162             _T("Georgian"),
 163 #endif
 164             _T("English"),
 165             _T("English (U.S.)")
 166         };
 167
 168         // the arrays should be in sync
 169         wxCOMPILE_TIME_ASSERT( WXSIZEOF(langNames) == WXSIZEOF(langIds),
 170                                LangArraysMismatch );
 171
 172         lng = wxGetSingleChoiceIndex
 173               (
 174                 _T("Please choose language:"),
 175                 _T("Language"),
 176                 WXSIZEOF(langNames),
 177                 langNames
 178               );
 179     }
 180
 181     if ( lng != -1 )
 182         m_locale.Init(langIds[lng]);
 183
 184     // normally this wouldn't be necessary as the catalog files would be found
 185     // in the default locations, but under Windows then the program is not
 186     // installed the catalogs are in the parent directory (because the binary
 187     // is in a subdirectory of samples/internat) where we wouldn't find them by
 188     // default
 189     wxLocale::AddCatalogLookupPathPrefix(wxT("."));
 190     wxLocale::AddCatalogLookupPathPrefix(wxT(".."));
 191
 192     // Initialize the catalogs we'll be using
 193     m_locale.AddCatalog(wxT("internat"));
 194
 195     // this catalog is installed in standard location on Linux systems and
 196     // shows that you may make use of the standard message catalogs as well
 197     //
 198     // if it's not installed on your system, it is just silently ignored
 199 #ifdef __LINUX__
 200     {
 201         wxLogNull noLog;
 202         m_locale.AddCatalog(_T("fileutils"));
 203     }
 204 #endif
 205
 206     // Create the main frame window
 207     MyFrame *frame = new MyFrame(m_locale);
 208
 209     // Give it an icon
 210     frame->SetIcon(wxICON(mondrian));
 211
 212     // Make a menubar
 213     wxMenu *file_menu = new wxMenu;
 214     file_menu->Append(wxID_ABOUT, _("&About..."));
 215     file_menu->AppendSeparator();
 216     file_menu->Append(wxID_EXIT, _("E&xit"));
 217
 218     wxMenu *test_menu = new wxMenu;
 219     test_menu->Append(INTERNAT_OPEN, _("&Open bogus file"));
 220     test_menu->Append(INTERNAT_TEST, _("&Play a game"));
 221     test_menu->AppendSeparator();
 222     test_menu->Append(INTERNAT_TEST_1, _("&1 _() (gettext)"));
 223     test_menu->Append(INTERNAT_TEST_2, _("&2 _N() (ngettext)"));
 224     test_menu->Append(INTERNAT_TEST_3, _("&3 wxTRANSLATE() (gettext_noop)"));
 225
 226     wxMenuBar *menu_bar = new wxMenuBar;
 227     menu_bar->Append(file_menu, _("&File"));
 228     menu_bar->Append(test_menu, _("&Test"));
 229     frame->SetMenuBar(menu_bar);
 230
 231     // Show the frame
 232     frame->Show(true);
 233     SetTopWindow(frame);
 234
 235     return true;
 236 }
 237
 238 // ----------------------------------------------------------------------------
 239 // MyFrame
 240 // ----------------------------------------------------------------------------
 241
 242 // main frame constructor
 243 MyFrame::MyFrame(wxLocale& locale)
 244        : wxFrame(NULL,
 245                  wxID_ANY,
 246                  _("International wxWidgets App")),
 247          m_locale(locale)
 248 {
 249     // Empty
 250 }
 251
 252 void MyFrame::OnQuit(wxCommandEvent& WXUNUSED(event) )
 253 {
 254     Close(true);
 255 }
 256
 257 void MyFrame::OnAbout(wxCommandEvent& WXUNUSED(event))
 258 {
 259     wxString localeInfo;
 260     wxString locale = m_locale.GetLocale();
 261     wxString sysname = m_locale.GetSysName();
 262     wxString canname = m_locale.GetCanonicalName();
 263
 264     localeInfo.Printf(_("Language: %s\nSystem locale name:\n%s\nCanonical locale name: %s\n"),
 265         locale.c_str(), sysname.c_str(), canname.c_str() );
 266
 267     wxMessageDialog dlg(
 268                         this,
 269                         wxString(_("I18n sample\n(c) 1998, 1999 Vadim Zeitlin and Julian Smart"))
 270                                  + wxT("\n\n")
 271                                  + localeInfo,
 272                                  _("About Internat"),
 273                         wxOK | wxICON_INFORMATION
 274                        );
 275     dlg.ShowModal();
 276 }
 277
 278 void MyFrame::OnPlay(wxCommandEvent& WXUNUSED(event))
 279 {
 280     wxString str = wxGetTextFromUser
 281                    (
 282                     _("Enter your number:"),
 283                     _("Try to guess my number!"),
 284                     wxEmptyString,
 285                     this
 286                    );
 287
 288     if ( str.empty() )
 289     {
 290         // cancelled
 291         return;
 292     }
 293
 294     long num;
 295     if ( !str.ToLong(&num) || num < 0 )
 296     {
 297         str = _("You've probably entered an invalid number.");
 298     }
 299     else if ( num == 9 )
 300     {
 301         // this message is not translated (not in catalog) because we used _T()
 302         // and not _() around it
 303         str = _T("You've found a bug in this program!");
 304     }
 305     else if ( num == 17 )
 306     {
 307         str.clear();
 308
 309         // string must be split in two -- otherwise the translation would't be
 310         // found
 311         str << _("Congratulations! you've won. Here is the magic phrase:")
 312             << _("cannot create fifo `%s'");
 313     }
 314     else
 315     {
 316         // this is a more implicit way to write _() but note that if you use it
 317         // you must ensure that the strings get extracted in the message
 318         // catalog as by default xgettext won't do it (it only knows of _(),
 319         // not wxGetTranslation())
 320         str = wxGetTranslation(_T("Bad luck! try again..."));
 321     }
 322
 323     wxMessageBox(str, _("Result"), wxOK | wxICON_INFORMATION);
 324 }
 325
 326 void MyFrame::OnOpen(wxCommandEvent&)
 327 {
 328     // open a bogus file -- the error message should be also translated if
 329     // you've got wxstd.mo somewhere in the search path
 330     wxFile file(wxT("NOTEXIST.ING"));
 331 }
 332
 333 void MyFrame::OnTest1(wxCommandEvent& WXUNUSED(event))
 334 {
 335     const wxChar* title = _("Testing _() (gettext)");
 336     wxTextEntryDialog d(this, _("Please enter text to translate"),
 337         title, wxTRANSLATE("default value"));
 338     if (d.ShowModal() == wxID_OK)
 339     {
 340         wxString v = d.GetValue();
 341         wxString s(title);
 342         s << _T("\n") << v << _T(" -> ")
 343             << wxGetTranslation(v.c_str()) << _T("\n");
 344         wxMessageBox(s);
 345     }
 346 }
 347
 348 void MyFrame::OnTest2(wxCommandEvent& WXUNUSED(event))
 349 {
 350     const wxChar* title = _("Testing _N() (ngettext)");
 351     wxTextEntryDialog d(this,
 352         _("Please enter range for plural forms of \"n files deleted\" phrase"),
 353         title, _T("0-10"));
 354     if (d.ShowModal() == wxID_OK)
 355     {
 356         int first, last;
 357         wxSscanf(d.GetValue(), _T("%d-%d"), &first, &last);
 358         wxString s(title);
 359         s << _T("\n");
 360         for (int n = first; n <= last; ++n)
 361         {
 362             s << n << _T(" ") <<
 363                 wxPLURAL("file deleted", "files deleted", n) <<
 364                 _T("\n");
 365         }
 366         wxMessageBox(s);
 367     }
 368 }
 369
 370 void MyFrame::OnTest3(wxCommandEvent& WXUNUSED(event))
 371 {
 372     const wxChar* lines[] =
 373     {
 374         wxTRANSLATE("line 1"),
 375         wxTRANSLATE("line 2"),
 376         wxTRANSLATE("line 3"),
 377     };
 378     wxString s(_("Testing wxTRANSLATE() (gettext_noop)"));
 379     s << _T("\n");
 380     for (size_t i = 0; i < WXSIZEOF(lines); ++i)
 381     {
 382         s << lines[i] << _T(" -> ") << wxGetTranslation(lines[i]) << _T("\n");
 383     }
 384     wxMessageBox(s);
 385 }
 386
 387