X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/2049ba38adafa0ec146880de29f26e32dd69a125..e0dec8753abaf97e006ea1185bfb6775b28df0a8:/samples/internat/internat.cpp diff --git a/samples/internat/internat.cpp b/samples/internat/internat.cpp index 9bcf7ae964..d285652e7c 100644 --- a/samples/internat/internat.cpp +++ b/samples/internat/internat.cpp @@ -1,18 +1,25 @@ ///////////////////////////////////////////////////////////////////////////// // 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$ -// 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" @@ -22,130 +29,496 @@ #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" + +#ifndef wxHAS_IMAGES_IN_RESOURCES + #include "../sample.xpm" +#endif + +// ---------------------------------------------------------------------------- +// private classes +// ---------------------------------------------------------------------------- // 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: - 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, 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); - 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 -#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) - 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) +// ============================================================================ +// 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(lang->Language); + } + + return true; } // `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 __WXMSW__ - 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 - // 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); + + 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 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); } -// 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.")); + } +}