doc tweaks

[wxWidgets.git] / samples / internat / internat.cpp

diff --git a/samples/internat/internat.cpp b/samples/internat/internat.cpp
index 6e669da1a8ca7b2824a2b6b06ae454197c1033ba..0a931caccdc30cd8cb39d778791a7681444b273c 100644 (file)
--- a/samples/internat/internat.cpp
+++ b/samples/internat/internat.cpp
@@ -5,14 +5,17 @@
 // Modified by:
 // Created:     04/01/98
 // RCS-ID:      $Id$
 // Modified by:
 // Created:     04/01/98
 // RCS-ID:      $Id$

-// Copyright:   (c) Julian Smart and Markus Holzem
+// Copyright:   (c) Julian Smart

 // Licence:     wxWindows license
 /////////////////////////////////////////////////////////////////////////////
 
 // Licence:     wxWindows license
 /////////////////////////////////////////////////////////////////////////////
 

-#ifdef __GNUG__
-#pragma implementation
-#pragma interface
-#endif
+// ============================================================================
+// declarations
+// ============================================================================
+
+// ----------------------------------------------------------------------------
+// headers
+// ----------------------------------------------------------------------------

 
 // For compilers that support precompilation, includes "wx/wx.h".
 #include "wx/wxprec.h"
 
 // For compilers that support precompilation, includes "wx/wx.h".
 #include "wx/wxprec.h"


@@ -29,150 +32,344 @@
 #include "wx/file.h"
 #include "wx/log.h"
 
 #include "wx/file.h"
 #include "wx/log.h"
 

-#ifdef __WXGTK__
+#if defined(__WXGTK__) || defined(__WXX11__) || defined(__WXMOTIF__) || defined(__WXMAC__) || defined(__WXMGL__)

 #include "mondrian.xpm"
 #endif
 
 #include "mondrian.xpm"
 #endif
 

+// ----------------------------------------------------------------------------
+// private classes
+// ----------------------------------------------------------------------------
+

 // Define a new application type
 class MyApp: public wxApp
 {
 public:
 // Define a new application type
 class MyApp: public wxApp
 {
 public:

-  MyApp();
-
-  virtual bool OnInit();
+    virtual bool OnInit();

 
 protected:
 
 protected:

-  wxLocale m_locale; // locale we'll be using
+    wxLocale m_locale; // locale we'll be using

 };
 
 // Define a new frame type
 class MyFrame: public wxFrame
 };
 
 // Define a new frame type
 class MyFrame: public wxFrame

-{ 
+{

 public:
 public:

-  MyFrame(wxFrame *frame, const char *title, int x, int y, int w, int h);
+    MyFrame(wxLocale& m_locale);

 
 public:
 
 public:

-  void OnQuit(wxCommandEvent& event);
-  void OnAbout(wxCommandEvent& event);
-  void OnPlay(wxCommandEvent& event);
-  void OnOpen(wxCommandEvent& event);
-  bool OnClose(void) { return TRUE; }
-  
-  DECLARE_EVENT_TABLE()
+    void OnQuit(wxCommandEvent& event);
+    void OnAbout(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()
+
+    wxLocale& m_locale;

 };
 
 };
 

+// ----------------------------------------------------------------------------
+// constants
+// ----------------------------------------------------------------------------
+

 // ID for the menu commands
 enum
 {
 // ID for the menu commands
 enum
 {

-  MINIMAL_QUIT,
-  MINIMAL_TEXT,
-  MINIMAL_ABOUT,
-  MINIMAL_TEST,
-  MINIMAL_OPEN
+    INTERNAT_QUIT = 1,
+    INTERNAT_TEXT,
+    INTERNAT_TEST,
+    INTERNAT_TEST_1,
+    INTERNAT_TEST_2,
+    INTERNAT_TEST_3,
+    INTERNAT_OPEN

 };
 
 };
 

+// ----------------------------------------------------------------------------
+// wxWidgets macros
+// ----------------------------------------------------------------------------
+

 BEGIN_EVENT_TABLE(MyFrame, wxFrame)
 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_QUIT, MyFrame::OnQuit)
+    EVT_MENU(wxID_ABOUT, MyFrame::OnAbout)
+    EVT_MENU(INTERNAT_TEST, MyFrame::OnPlay)
+    EVT_MENU(INTERNAT_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)
 
 END_EVENT_TABLE()
 
 IMPLEMENT_APP(MyApp)
 

+// ============================================================================
+// implementation
+// ============================================================================

 
 

-MyApp::MyApp() : m_locale("french", "fr", "C")
-{
-  // 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
-  
-}
+// ----------------------------------------------------------------------------
+// MyApp
+// ----------------------------------------------------------------------------

 
 // `Main program' equivalent, creating windows and returning main app frame
 
 // `Main program' equivalent, creating windows and returning main app frame

-bool MyApp::OnInit(void)
+bool MyApp::OnInit()

 {
 {

-  // Create the main frame window
-  MyFrame *frame = new MyFrame(NULL, _("Minimal wxWindows App"), 50, 50, 150, 40);
-
-  // Give it an icon
-#ifdef __WXMSW__
-  frame->SetIcon(wxIcon("mondrian"));
-#else
-  frame->SetIcon(wxIcon(mondrian_xpm));
+    long lng = -1;
+
+    if ( argc == 2 )
+    {
+        // the parameter must be the lang index
+        wxString tmp(argv[1]);
+        tmp.ToLong(&lng);
+    }
+
+    static const wxLanguage langIds[] =
+    {
+        wxLANGUAGE_DEFAULT,
+        wxLANGUAGE_FRENCH,
+        wxLANGUAGE_GERMAN,
+        wxLANGUAGE_RUSSIAN,
+        wxLANGUAGE_BULGARIAN,
+        wxLANGUAGE_CZECH,
+#if wxUSE_UNICODE
+        wxLANGUAGE_JAPANESE,
+        wxLANGUAGE_GEORGIAN,
+#endif
+        wxLANGUAGE_ENGLISH,
+        wxLANGUAGE_ENGLISH_US
+    };
+
+    if ( lng == -1 )
+    {
+        // note that it makes no sense to translate these strings, they are
+        // shown before we set the locale anyhow
+        const wxString langNames[] =
+        {
+            _T("System default"),
+            _T("French"),
+            _T("German"),
+            _T("Russian"),
+            _T("Bulgarian"),
+            _T("Czech"),
+#if wxUSE_UNICODE
+            _T("Japanese"),
+            _T("Georgian"),
+#endif
+            _T("English"),
+            _T("English (U.S.)")
+        };
+
+        // the arrays should be in sync
+        wxCOMPILE_TIME_ASSERT( WXSIZEOF(langNames) == WXSIZEOF(langIds),
+                               LangArraysMismatch );
+
+        lng = wxGetSingleChoiceIndex
+              (
+                _T("Please choose language:"),
+                _T("Language"), 
+                WXSIZEOF(langNames),
+                langNames
+              );
+    }
+
+    if ( lng != -1 )
+        m_locale.Init(langIds[lng]);
+
+
+    // Initialize the catalogs we'll be using
+    m_locale.AddCatalog(wxT("internat"));
+
+    // 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(_T("fileutils"));
+    }

 #endif
 
 #endif
 

-  // Make a menubar
-  wxMenu *file_menu = new wxMenu;
-  file_menu->Append(MINIMAL_ABOUT, _("&About"));
-  file_menu->AppendSeparator();
-  file_menu->Append(MINIMAL_QUIT, _("E&xit"));
+    // Create the main frame window
+    MyFrame *frame = new MyFrame(m_locale);

 
 

-  wxMenu *test_menu = new wxMenu;
-  test_menu->Append(MINIMAL_OPEN, _("&Open bogus file"));
-  test_menu->Append(MINIMAL_TEST, _("&Play a game"));
+    // Give it an icon
+    frame->SetIcon(wxICON(mondrian));

 
 

-  wxMenuBar *menu_bar = new wxMenuBar;
-  menu_bar->Append(file_menu, _("&File"));
-  menu_bar->Append(test_menu, _("&Test"));
-  frame->SetMenuBar(menu_bar);
+    // Make a menubar
+    wxMenu *file_menu = new wxMenu;
+    file_menu->Append(wxID_ABOUT, _("&About..."));
+    file_menu->AppendSeparator();
+    file_menu->Append(INTERNAT_QUIT, _("E&xit"));

 
 

-  // Show the frame
-  frame->Show(TRUE);
-  SetTopWindow(frame);
+    wxMenu *test_menu = new wxMenu;
+    test_menu->Append(INTERNAT_OPEN, _("&Open bogus file"));
+    test_menu->Append(INTERNAT_TEST, _("&Play a game"));
+    test_menu->AppendSeparator();
+    test_menu->Append(INTERNAT_TEST_1, _("&1 _() (gettext)"));
+    test_menu->Append(INTERNAT_TEST_2, _("&2 _N() (ngettext)"));
+    test_menu->Append(INTERNAT_TEST_3, _("&3 wxTRANSLATE() (gettext_noop)"));

 
 

-  return TRUE;
+    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;

 }
 
 }
 

-// 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,
+                 -1,
+                 _("International wxWidgets App"),
+                 wxPoint(50, 50),
+                 wxSize(350, 60)),
+         m_locale(locale)

 {
 {

+    // Empty

 }
 
 void MyFrame::OnQuit(wxCommandEvent& WXUNUSED(event) )
 {
 }
 
 void MyFrame::OnQuit(wxCommandEvent& WXUNUSED(event) )
 {

-  Close(TRUE);
+    Close(TRUE);

 }
 
 void MyFrame::OnAbout(wxCommandEvent& WXUNUSED(event))
 {
 }
 
 void MyFrame::OnAbout(wxCommandEvent& WXUNUSED(event))
 {

-  wxMessageDialog(this, _("I18n sample\n© Vadim Zeitlin & 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
+    (
+        this,
+        wxString(_("I18n sample\n(c) 1998, 1999 Vadim Zeitlin and Julian Smart"))
+            + wxT("\n\n")
+            + localeInfo,
+        _("About Internat"), 
+        wxOK | wxICON_INFORMATION
+    ).ShowModal();

 }
 
 void MyFrame::OnPlay(wxCommandEvent& WXUNUSED(event))
 {
 }
 
 void MyFrame::OnPlay(wxCommandEvent& WXUNUSED(event))
 {

-  wxString str = wxGetTextFromUser(_("Enter your number:"),
-                                   _("Try to guess my number!"),
-                                  "", this);
-  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 wxGetTranslation())
+        str = wxGetTranslation(_T("Bad luck! try again..."));
+    }
+
+    wxMessageBox(str, _("Result"), wxOK | wxICON_INFORMATION);

 }
 
 void MyFrame::OnOpen(wxCommandEvent&)
 {
 }
 
 void MyFrame::OnOpen(wxCommandEvent&)
 {

-  // 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");
-}
\ No newline at end of file
+    // open a bogus file -- the error message should be also translated if
+    // you've got wxstd.mo somewhere in the search path
+    wxFile file(wxT("NOTEXIST.ING"));
+}
+
+void MyFrame::OnTest1(wxCommandEvent& WXUNUSED(event))
+{
+    const wxChar* title = _("Testing _() (gettext)");
+    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 << _T("\n") << v << _T(" -> ")
+           << wxGetTranslation(v.c_str()) << _T("\n");
+       wxMessageBox(s);
+    }
+}
+
+void MyFrame::OnTest2(wxCommandEvent& WXUNUSED(event))
+{
+    const wxChar* title = _("Testing _N() (ngettext)");
+    wxTextEntryDialog d(this,
+           _("Please enter range for plural forms of \"n files deleted\" phrase"),
+           title, _T("0-10"));
+    if (d.ShowModal() == wxID_OK)
+    {
+       int first, last;
+       wxSscanf(d.GetValue(), _T("%d-%d"), &first, &last);
+       wxString s(title);
+       s << _T("\n");
+       for (int n = first; n <= last; ++n)
+        {
+            s << n << _T(" ") << 
+                wxGetTranslation(_T("file deleted"), _T("files deleted"), n) <<
+                _T("\n");
+       }
+        wxMessageBox(s);
+    }
+}
+
+void MyFrame::OnTest3(wxCommandEvent& WXUNUSED(event))
+{
+    const wxChar* lines[] =
+    {
+       wxTRANSLATE("line 1"),
+       wxTRANSLATE("line 2"),
+       wxTRANSLATE("line 3"),
+    };
+    wxString s(_("Testing wxTRANSLATE() (gettext_noop)"));
+    s << _T("\n");
+    for (size_t i = 0; i < WXSIZEOF(lines); ++i)
+    {
+       s << lines[i] << _T(" -> ") << wxGetTranslation(lines[i]) << _T("\n");
+    }
+    wxMessageBox(s);
+}
+
+