Suppress warnings about double to int truncation in wxHTML code.

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

diff --git a/samples/internat/internat.cpp b/samples/internat/internat.cpp
index e8e4fd58127b8e434e5ffaf57d92cf513fb870c4..4ce95d0d13e69ab9bbf670f4cff4932feb793fbd 100644 (file)
--- a/samples/internat/internat.cpp
+++ b/samples/internat/internat.cpp
@@ -1,18 +1,25 @@
 /////////////////////////////////////////////////////////////////////////////
 // Name:        internat.cpp
 /////////////////////////////////////////////////////////////////////////////
 // Name:        internat.cpp

-// Purpose:     Demonstrates internationalisation support
+// Purpose:     Demonstrates internationalisation (i18n) support

 // Author:      Vadim Zeitlin/Julian Smart
 // Modified by:
 // Created:     04/01/98
 // RCS-ID:      $Id$
 // Author:      Vadim Zeitlin/Julian Smart
 // Modified by:
 // Created:     04/01/98
 // RCS-ID:      $Id$

-// Copyright:   (c) Julian Smart and Markus Holzem
-// Licence:    wxWindows license
+// Copyright:   (c) Julian Smart
+// Licence:     wxWindows licence

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

-#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"
 
 // For compilers that support precompilation, includes "wx/wx.h".
 #include "wx/wxprec.h"


@@ -22,130 +29,497 @@
 #endif
 
 #ifndef WX_PRECOMP
 #endif
 
 #ifndef WX_PRECOMP

-#include "wx/wx.h"
+    #include "wx/wx.h"

 #endif
 
 #include "wx/intl.h"
 #endif
 
 #include "wx/intl.h"

+#include "wx/file.h"

 #include "wx/log.h"
 #include "wx/log.h"

+#include "wx/cmdline.h"
+
+#if !defined(__WXMSW__) && !defined(__WXPM__)
+    #include "../sample.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();
-    bool OnInit(void);
+    MyApp() { m_lang = wxLANGUAGE_UNKNOWN; }
+
+    virtual void OnInitCmdLine(wxCmdLineParser& parser);
+    virtual bool OnCmdLineParsed(wxCmdLineParser& parser);
+    virtual bool OnInit();
+

 protected:
 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
 };
 
 // Define a new frame type
 class MyFrame: public wxFrame

-{ public:
-    MyFrame(wxFrame *frame, char *title, int x, int y, int w, int h);
-    
- public:
-    void OnQuit(wxCommandEvent& event);
+{
+public:
+    MyFrame(wxLocale& m_locale);
+
+public:
+    void OnTestLocaleAvail(wxCommandEvent& event);

     void OnAbout(wxCommandEvent& event);
     void OnAbout(wxCommandEvent& event);

-       bool OnClose(void) { return TRUE; }
+    void OnQuit(wxCommandEvent& event);

 
 

-   DECLARE_EVENT_TABLE()
-    
+    void OnPlay(wxCommandEvent& event);
+    void OnOpen(wxCommandEvent& event);
+    void OnTest1(wxCommandEvent& event);
+    void OnTest2(wxCommandEvent& event);
+    void OnTest3(wxCommandEvent& event);
+    void OnTestMsgBox(wxCommandEvent& event);
+
+    DECLARE_EVENT_TABLE()
+
+    wxLocale& m_locale;

 };
 
 };
 

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

 // ID for the menu commands
 // ID for the menu commands

-#define MINIMAL_QUIT   1
-#define MINIMAL_TEXT   101
-#define MINIMAL_ABOUT  102
+enum
+{
+    INTERNAT_TEST = wxID_HIGHEST + 1,
+    INTERNAT_PLAY,
+    INTERNAT_TEST_1,
+    INTERNAT_TEST_2,
+    INTERNAT_TEST_3,
+    INTERNAT_TEST_MSGBOX
+};
+
+// 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)
 
 BEGIN_EVENT_TABLE(MyFrame, wxFrame)

-       EVT_MENU(MINIMAL_QUIT, MyFrame::OnQuit)
-       EVT_MENU(MINIMAL_ABOUT, MyFrame::OnAbout)
+    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)
+    EVT_MENU(INTERNAT_TEST_MSGBOX, MyFrame::OnTestMsgBox)

 END_EVENT_TABLE()
 
 IMPLEMENT_APP(MyApp)
 
 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);
+}

 
 

-MyApp::MyApp():
-  m_locale("french", "fr", "C")
+bool MyApp::OnCmdLineParsed(wxCmdLineParser& parser)

 {
 {

-  // 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 Liux 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
-  
+    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
 }
 
 // `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, 450, 340);
+    if ( !wxApp::OnInit() )
+        return false;

 
 

-  // Give it an icon
-#ifdef __WINDOWS__
-  frame->SetIcon(wxIcon("mondrian"));
-#endif
-#ifdef __X__
-  frame->SetIcon(wxIcon("aiai.xbm"));
+    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_DONT_LOAD_DEFAULT) )
+    {
+        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");
+        // 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
 
 #endif
 

-  // Make a menubar
-  wxMenu *file_menu = new wxMenu;
+    // Create the main frame window
+    MyFrame *frame = new MyFrame(m_locale);
+
+    // Show the frame
+    frame->Show(true);
+    SetTopWindow(frame);
+
+    return true;
+}
+
+// ----------------------------------------------------------------------------
+// MyFrame
+// ----------------------------------------------------------------------------
+
+// main frame constructor
+MyFrame::MyFrame(wxLocale& locale)
+       : wxFrame(NULL,
+                 wxID_ANY,
+                 _("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")),
+                wxSizerFlags().Border());
+    sizer->Add(new wxStaticText(this, wxID_ANY, _("Second")),
+                wxSizerFlags().Border());
+    SetSizer(sizer);
+}
+
+void MyFrame::OnQuit(wxCommandEvent& WXUNUSED(event) )
+{
+    Close(true);
+}
+
+void MyFrame::OnAbout(wxCommandEvent& WXUNUSED(event))
+{
+    wxString localeInfo;
+    wxString locale = m_locale.GetLocale();
+    wxString sysname = m_locale.GetSysName();
+    wxString canname = m_locale.GetCanonicalName();

 
 

-  file_menu->Append(MINIMAL_ABOUT, "&About");
-  file_menu->Append(MINIMAL_QUIT, "E&xit");
-  wxMenuBar *menu_bar = new wxMenuBar;
-  menu_bar->Append(file_menu, "&File");
-  frame->SetMenuBar(menu_bar);
+    localeInfo.Printf(_("Language: %s\nSystem locale name: %s\nCanonical locale name: %s\n"),
+                      locale.c_str(), sysname.c_str(), canname.c_str() );

 
 

-  // Make a panel with a message
-  wxPanel *panel = new wxPanel(frame, -1, wxPoint(0, 0), wxSize(400, 200), wxTAB_TRAVERSAL);
+    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();
+}

 
 

-  wxString msgString;
-  int num = 2;
-  if ( num == 0 )
-    msgString = wxTString("you've probably entered an invalid number.");
-  else if ( num == 9 ) // this message is not translated
-    msgString = wxTString("You've found a bug in this program!");
-  else if ( num != 17 )
-    msgString = wxTString("bad luck! try again...");
-  else {
-    msgString = wxTString("congratulations! you've won. Here is the magic phrase:");
-  }
+void MyFrame::OnPlay(wxCommandEvent& WXUNUSED(event))
+{
+    wxString str = wxGetTextFromUser
+                   (
+                    _("Enter your number:"),
+                    _("Try to guess my number!"),
+                    wxEmptyString,
+                    this
+                   );

 
 

-  wxStaticText *msg = new wxStaticText(panel, 311, msgString, wxPoint(10, 10), wxSize(-1, -1),
-    0);
+    if ( str.empty() )
+    {
+        // cancelled
+        return;
+    }

 
 

-  // Show the frame
-  frame->Show(TRUE);
-  
+    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 wxT()
+        // and not _() around it
+        str = wxT("You've found a bug in this program!");
+    }
+    else if ( num == 17 )
+    {
+        str.clear();

 
 

-  SetTopWindow(frame);
+        // 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..."));

 
 

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

 }
 
 }
 

-// My frame constructor
-MyFrame::MyFrame(wxFrame *frame, char *title, int x, int y, int w, int h):
-  wxFrame(frame, -1, title, wxPoint(x, y), wxSize(w, h))
-{}
+void MyFrame::OnTestLocaleAvail(wxCommandEvent& WXUNUSED(event))
+{
+    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::OnQuit(wxCommandEvent& event)
+void MyFrame::OnOpen(wxCommandEvent& WXUNUSED(event))

 {
 {

-  Close(TRUE);
+    // 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::OnAbout(wxCommandEvent& event)
+void MyFrame::OnTest1(wxCommandEvent& WXUNUSED(event))

 {
 {

-  wxMessageDialog dialog(this, "This is a minimal sample\nA second line in the message box",
-       "About Minimal", wxYES_NO|wxCANCEL);
+    const wxString& title = _("Testing _() (gettext)");

 
 

-  dialog.ShowModal();
+    // 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);
+}

 
 

+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."));
+    }
+}