Fix return value of wxGenericTreeCtrl::FindItem().

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

diff --git a/samples/internat/internat.cpp b/samples/internat/internat.cpp
index a9d2233b4d1b83abf1b7e2a8906c191e20ed33d8..d285652e7ceeab879b28efb059c31bc283e77df4 100644 (file)
--- a/samples/internat/internat.cpp
+++ b/samples/internat/internat.cpp
@@ -6,9 +6,13 @@
 // Created:     04/01/98
 // RCS-ID:      $Id$
 // Copyright:   (c) Julian Smart
 // Created:     04/01/98
 // RCS-ID:      $Id$
 // Copyright:   (c) Julian Smart

-// Licence:     wxWindows license
+// Licence:     wxWindows licence

 /////////////////////////////////////////////////////////////////////////////
 
 /////////////////////////////////////////////////////////////////////////////
 

+// NOTE: don't miss the "readme.txt" file which comes with this sample!
+
+
+

 // ============================================================================
 // declarations
 // ============================================================================
 // ============================================================================
 // declarations
 // ============================================================================


@@ -33,8 +37,8 @@
 #include "wx/log.h"
 #include "wx/cmdline.h"
 
 #include "wx/log.h"
 #include "wx/cmdline.h"
 

-#if defined(__WXGTK__) || defined(__WXX11__) || defined(__WXMOTIF__) || defined(__WXMAC__) || defined(__WXMGL__)
-#include "mondrian.xpm"
+#ifndef wxHAS_IMAGES_IN_RESOURCES
+    #include "../sample.xpm"

 #endif
 
 // ----------------------------------------------------------------------------
 #endif
 
 // ----------------------------------------------------------------------------


@@ -72,6 +76,7 @@ public:
     void OnTest1(wxCommandEvent& event);
     void OnTest2(wxCommandEvent& event);
     void OnTest3(wxCommandEvent& event);
     void OnTest1(wxCommandEvent& event);
     void OnTest2(wxCommandEvent& event);
     void OnTest3(wxCommandEvent& event);

+    void OnTestMsgBox(wxCommandEvent& event);

 
     DECLARE_EVENT_TABLE()
 
 
     DECLARE_EVENT_TABLE()
 


@@ -89,7 +94,8 @@ enum
     INTERNAT_PLAY,
     INTERNAT_TEST_1,
     INTERNAT_TEST_2,
     INTERNAT_PLAY,
     INTERNAT_TEST_1,
     INTERNAT_TEST_2,

-    INTERNAT_TEST_3
+    INTERNAT_TEST_3,
+    INTERNAT_TEST_MSGBOX

 };
 
 // language data
 };
 
 // language data


@@ -97,6 +103,7 @@ static const wxLanguage langIds[] =
 {
     wxLANGUAGE_DEFAULT,
     wxLANGUAGE_FRENCH,
 {
     wxLANGUAGE_DEFAULT,
     wxLANGUAGE_FRENCH,

+    wxLANGUAGE_ITALIAN,

     wxLANGUAGE_GERMAN,
     wxLANGUAGE_RUSSIAN,
     wxLANGUAGE_BULGARIAN,
     wxLANGUAGE_GERMAN,
     wxLANGUAGE_RUSSIAN,
     wxLANGUAGE_BULGARIAN,


@@ -119,23 +126,24 @@ static const wxLanguage langIds[] =
 // shown before we set the locale anyhow
 const wxString langNames[] =
 {
 // shown before we set the locale anyhow
 const wxString langNames[] =
 {

-    _T("System default"),
-    _T("French"),
-    _T("German"),
-    _T("Russian"),
-    _T("Bulgarian"),
-    _T("Czech"),
-    _T("Polish"),
-    _T("Swedish"),
+    "System default",
+    "French",
+    "Italian",
+    "German",
+    "Russian",
+    "Bulgarian",
+    "Czech",
+    "Polish",
+    "Swedish",

 #if wxUSE_UNICODE || defined(__WXMOTIF__)
 #if wxUSE_UNICODE || defined(__WXMOTIF__)

-    _T("Japanese"),
+    "Japanese",

 #endif
 #if wxUSE_UNICODE
 #endif
 #if wxUSE_UNICODE

-    _T("Georgian"),
-    _T("English"),
-    _T("English (U.S.)"),
-    _T("Arabic"),
-    _T("Arabic (Egypt)")
+    "Georgian",
+    "English",
+    "English (U.S.)",
+    "Arabic",
+    "Arabic (Egypt)"

 #endif
 };
 
 #endif
 };
 


@@ -157,6 +165,7 @@ BEGIN_EVENT_TABLE(MyFrame, wxFrame)
     EVT_MENU(INTERNAT_TEST_1, MyFrame::OnTest1)
     EVT_MENU(INTERNAT_TEST_2, MyFrame::OnTest2)
     EVT_MENU(INTERNAT_TEST_3, MyFrame::OnTest3)
     EVT_MENU(INTERNAT_TEST_1, MyFrame::OnTest1)
     EVT_MENU(INTERNAT_TEST_2, MyFrame::OnTest2)
     EVT_MENU(INTERNAT_TEST_3, MyFrame::OnTest3)

+    EVT_MENU(INTERNAT_TEST_MSGBOX, MyFrame::OnTestMsgBox)

 END_EVENT_TABLE()
 
 IMPLEMENT_APP(MyApp)
 END_EVENT_TABLE()
 
 IMPLEMENT_APP(MyApp)


@@ -194,7 +203,7 @@ bool MyApp::OnCmdLineParsed(wxCmdLineParser& parser)
             return false;
         }
 
             return false;
         }
 

-        m_lang = wx_static_cast(wxLanguage, lang->Language);
+        m_lang = static_cast<wxLanguage>(lang->Language);

     }
 
     return true;
     }
 
     return true;


@@ -218,26 +227,33 @@ bool MyApp::OnInit()
         m_lang = lng == -1 ? wxLANGUAGE_DEFAULT : langIds[lng];
     }
 
         m_lang = lng == -1 ? wxLANGUAGE_DEFAULT : langIds[lng];
     }
 

-    if ( m_lang != wxLANGUAGE_DEFAULT )
+    // 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_DONT_LOAD_DEFAULT) )

     {
     {

-        // 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."));
+        wxLogWarning(_("This language is not supported by the system."));

 
 

-            // continue nevertheless
-        }
+        // 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
     }
 
     // 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(wxT("."));
+    wxLocale::AddCatalogLookupPathPrefix(".");

 
     // Initialize the catalogs we'll be using
 
     // Initialize the catalogs we'll be using

-    m_locale.AddCatalog(wxT("internat"));
+    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");
+        // 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
 
     // this catalog is installed in standard location on Linux systems and
     // shows that you may make use of the standard message catalogs as well


@@ -246,40 +262,15 @@ bool MyApp::OnInit()
 #ifdef __LINUX__
     {
         wxLogNull noLog;
 #ifdef __LINUX__
     {
         wxLogNull noLog;

-        m_locale.AddCatalog(_T("fileutils"));
+        m_locale.AddCatalog("fileutils");

     }
 #endif
 
     // Create the main frame window
     MyFrame *frame = new MyFrame(m_locale);
 
     }
 #endif
 
     // Create the main frame window
     MyFrame *frame = new MyFrame(m_locale);
 

-    // Give it an icon
-    frame->SetIcon(wxICON(mondrian));
-
-    // Make a menubar
-    wxMenu *file_menu = new wxMenu;
-    file_menu->Append(INTERNAT_TEST, _("&Test locale availability...\tCtrl-T"));
-    file_menu->AppendSeparator();
-    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"));
-    test_menu->Append(INTERNAT_PLAY, _("&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)"));
-
-    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);
     // Show the frame
     frame->Show(true);

-    SetTopWindow(frame);

 
     return true;
 }
 
     return true;
 }


@@ -295,6 +286,37 @@ MyFrame::MyFrame(wxLocale& locale)
                  _("International wxWidgets App")),
          m_locale(locale)
 {
                  _("International wxWidgets App")),
          m_locale(locale)
 {

+    SetIcon(wxICON(sample));
+
+    // 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"));
+    test_menu->Append(INTERNAT_TEST_MSGBOX, _("&Message box test"),
+                      _("Tests message box buttons labels translation"));
+
+    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")),
     // this demonstrates RTL layout mirroring for Arabic locales
     wxSizer *sizer = new wxBoxSizer(wxHORIZONTAL);
     sizer->Add(new wxStaticText(this, wxID_ANY, _("First")),


@@ -316,13 +338,13 @@ void MyFrame::OnAbout(wxCommandEvent& WXUNUSED(event))
     wxString sysname = m_locale.GetSysName();
     wxString canname = m_locale.GetCanonicalName();
 
     wxString sysname = m_locale.GetSysName();
     wxString canname = m_locale.GetCanonicalName();
 

-    localeInfo.Printf(_("Language: %s\nSystem locale name:\n%s\nCanonical locale name: %s\n"),
-        locale.c_str(), sysname.c_str(), canname.c_str() );
+    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"))
 
     wxMessageDialog dlg(
                         this,
                         wxString(_("I18n sample\n(c) 1998, 1999 Vadim Zeitlin and Julian Smart"))

-                                 + wxT("\n\n")
+                                 + "\n\n"

                                  + localeInfo,
                                  _("About Internat"),
                         wxOK | wxICON_INFORMATION
                                  + localeInfo,
                                  _("About Internat"),
                         wxOK | wxICON_INFORMATION


@@ -353,9 +375,9 @@ void MyFrame::OnPlay(wxCommandEvent& WXUNUSED(event))
     }
     else if ( num == 9 )
     {
     }
     else if ( num == 9 )
     {

-        // this message is not translated (not in catalog) because we used _T()
+        // this message is not translated (not in catalog) because we used wxT()

         // and not _() around it
         // and not _() around it

-        str = _T("You've found a bug in this program!");
+        str = wxT("You've found a bug in this program!");

     }
     else if ( num == 17 )
     {
     }
     else if ( num == 17 )
     {


@@ -370,9 +392,15 @@ void MyFrame::OnPlay(wxCommandEvent& WXUNUSED(event))
     {
         // 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
     {
         // 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..."));
+        // 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 explicitly 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);
     }
 
     wxMessageBox(str, _("Result"), wxOK | wxICON_INFORMATION);


@@ -400,50 +428,63 @@ void MyFrame::OnTestLocaleAvail(wxCommandEvent& WXUNUSED(event))
     }
 
     if ( wxLocale::IsAvailable(info->Language) )
     }
 
     if ( wxLocale::IsAvailable(info->Language) )

+    {

         wxLogMessage(_("Locale \"%s\" is available."), s_locale.c_str());
         wxLogMessage(_("Locale \"%s\" is available."), s_locale.c_str());

+    }

     else
     else

+    {

         wxLogWarning(_("Locale \"%s\" is not available."), s_locale.c_str());
         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
 }
 
 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
-    wxFile file(wxT("NOTEXIST.ING"));
+    // you've got wxstd.mo somewhere in the search path (see MyApp::OnInit)
+    wxFile file("NOTEXIST.ING");

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

-    const wxString title = _("Testing _() (gettext)");
+    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"),
     wxTextEntryDialog d(this, _("Please enter text to translate"),

-        title, wxTRANSLATE("default value"));
+                        title, wxTRANSLATE("default value"));
+

     if (d.ShowModal() == wxID_OK)
     {
         wxString v = d.GetValue();
         wxString s(title);
     if (d.ShowModal() == wxID_OK)
     {
         wxString v = d.GetValue();
         wxString s(title);

-        s << _T("\n") << v << _T(" -> ")
-            << wxGetTranslation(v.c_str()) << _T("\n");
+        s << "\n" << v << " -> "
+            << wxGetTranslation(v.c_str()) << "\n";

         wxMessageBox(s);
     }
 }
 
 void MyFrame::OnTest2(wxCommandEvent& WXUNUSED(event))
 {
         wxMessageBox(s);
     }
 }
 
 void MyFrame::OnTest2(wxCommandEvent& WXUNUSED(event))
 {

-    const wxString title = _("Testing _N() (ngettext)");
+    const wxString& title = _("Testing _N() (ngettext)");

     wxTextEntryDialog d(this,
         _("Please enter range for plural forms of \"n files deleted\" phrase"),
     wxTextEntryDialog d(this,
         _("Please enter range for plural forms of \"n files deleted\" phrase"),

-        title, _T("0-10"));
+        title, "0-10");
+

     if (d.ShowModal() == wxID_OK)
     {
         int first, last;
     if (d.ShowModal() == wxID_OK)
     {
         int first, last;

-        wxSscanf(d.GetValue(), _T("%d-%d"), &first, &last);
+        wxSscanf(d.GetValue(), "%d-%d", &first, &last);

         wxString s(title);
         wxString s(title);

-        s << _T("\n");
+        s << "\n";

         for (int n = first; n <= last; ++n)
         {
         for (int n = first; n <= last; ++n)
         {

-            s << n << _T(" ") <<
+            s << n << " " <<

                 wxPLURAL("file deleted", "files deleted", n) <<
                 wxPLURAL("file deleted", "files deleted", n) <<

-                _T("\n");
+                "\n";

         }
         wxMessageBox(s);
     }
         }
         wxMessageBox(s);
     }


@@ -457,13 +498,27 @@ void MyFrame::OnTest3(wxCommandEvent& WXUNUSED(event))
         wxTRANSLATE("line 2"),
         wxTRANSLATE("line 3"),
     };
         wxTRANSLATE("line 2"),
         wxTRANSLATE("line 3"),
     };

+

     wxString s(_("Testing wxTRANSLATE() (gettext_noop)"));
     wxString s(_("Testing wxTRANSLATE() (gettext_noop)"));

-    s << _T("\n");
+    s << "\n";

     for (size_t i = 0; i < WXSIZEOF(lines); ++i)
     {
     for (size_t i = 0; i < WXSIZEOF(lines); ++i)
     {

-        s << lines[i] << _T(" -> ") << wxGetTranslation(lines[i]) << _T("\n");
+        s << lines[i] << " -> " << wxGetTranslation(lines[i]) << "\n";

     }
     wxMessageBox(s);
 }
 
     }
     wxMessageBox(s);
 }
 

-
+void MyFrame::OnTestMsgBox(wxCommandEvent& WXUNUSED(event))
+{
+    if ( wxMessageBox
+         (
+            _("Are the labels of the buttons in this message box "
+              "translated into the current locale language?"),
+            _("wxWidgets i18n sample"),
+            wxYES_NO,
+            this
+         ) != wxYES )
+    {
+        wxMessageBox(_("Please report the details of your platform to us."));
+    }
+}