1 /////////////////////////////////////////////////////////////////////////////
3 // Purpose: Demonstrates internationalisation (i18n) support
4 // Author: Vadim Zeitlin/Julian Smart
8 // Copyright: (c) Julian Smart
9 // Licence: wxWindows license
10 /////////////////////////////////////////////////////////////////////////////
12 // ============================================================================
14 // ============================================================================
16 // ----------------------------------------------------------------------------
18 // ----------------------------------------------------------------------------
20 // For compilers that support precompilation, includes "wx/wx.h".
21 #include "wx/wxprec.h"
34 #include "wx/cmdline.h"
36 #if defined(__WXGTK__) || defined(__WXX11__) || defined(__WXMOTIF__) || defined(__WXMAC__) || defined(__WXMGL__)
37 #include "mondrian.xpm"
40 // ----------------------------------------------------------------------------
42 // ----------------------------------------------------------------------------
44 // Define a new application type
45 class MyApp
: public wxApp
48 MyApp() { m_lang
= wxLANGUAGE_UNKNOWN
; }
50 virtual void OnInitCmdLine(wxCmdLineParser
& parser
);
51 virtual bool OnCmdLineParsed(wxCmdLineParser
& parser
);
52 virtual bool OnInit();
55 wxLanguage m_lang
; // language specified by user
56 wxLocale m_locale
; // locale we'll be using
59 // Define a new frame type
60 class MyFrame
: public wxFrame
63 MyFrame(wxLocale
& m_locale
);
66 void OnTestLocaleAvail(wxCommandEvent
& event
);
67 void OnAbout(wxCommandEvent
& event
);
68 void OnQuit(wxCommandEvent
& event
);
70 void OnPlay(wxCommandEvent
& event
);
71 void OnOpen(wxCommandEvent
& event
);
72 void OnTest1(wxCommandEvent
& event
);
73 void OnTest2(wxCommandEvent
& event
);
74 void OnTest3(wxCommandEvent
& event
);
81 // ----------------------------------------------------------------------------
83 // ----------------------------------------------------------------------------
85 // ID for the menu commands
88 INTERNAT_TEST
= wxID_HIGHEST
+ 1,
96 static const wxLanguage langIds
[] =
103 wxLANGUAGE_BULGARIAN
,
107 #if wxUSE_UNICODE || defined(__WXMOTIF__)
113 wxLANGUAGE_ENGLISH_US
,
115 wxLANGUAGE_ARABIC_EGYPT
119 // note that it makes no sense to translate these strings, they are
120 // shown before we set the locale anyhow
121 const wxString langNames
[] =
132 #if wxUSE_UNICODE || defined(__WXMOTIF__)
144 // the arrays must be in sync
145 wxCOMPILE_TIME_ASSERT( WXSIZEOF(langNames
) == WXSIZEOF(langIds
),
146 LangArraysMismatch
);
148 // ----------------------------------------------------------------------------
150 // ----------------------------------------------------------------------------
152 BEGIN_EVENT_TABLE(MyFrame
, wxFrame
)
153 EVT_MENU(INTERNAT_TEST
, MyFrame::OnTestLocaleAvail
)
154 EVT_MENU(wxID_ABOUT
, MyFrame::OnAbout
)
155 EVT_MENU(wxID_EXIT
, MyFrame::OnQuit
)
157 EVT_MENU(INTERNAT_PLAY
, MyFrame::OnPlay
)
158 EVT_MENU(wxID_OPEN
, MyFrame::OnOpen
)
159 EVT_MENU(INTERNAT_TEST_1
, MyFrame::OnTest1
)
160 EVT_MENU(INTERNAT_TEST_2
, MyFrame::OnTest2
)
161 EVT_MENU(INTERNAT_TEST_3
, MyFrame::OnTest3
)
166 // ============================================================================
168 // ============================================================================
170 // ----------------------------------------------------------------------------
172 // ----------------------------------------------------------------------------
174 // command line arguments handling
175 void MyApp::OnInitCmdLine(wxCmdLineParser
& parser
)
177 parser
.AddParam(_("locale"),
178 wxCMD_LINE_VAL_STRING
,
179 wxCMD_LINE_PARAM_OPTIONAL
);
181 wxApp::OnInitCmdLine(parser
);
184 bool MyApp::OnCmdLineParsed(wxCmdLineParser
& parser
)
186 if ( !wxApp::OnCmdLineParsed(parser
) )
189 if ( parser
.GetParamCount() )
191 const wxString loc
= parser
.GetParam();
192 const wxLanguageInfo
* const lang
= wxLocale::FindLanguageInfo(loc
);
195 wxLogError(_("Locale \"%s\" is unknown."), loc
);
199 m_lang
= static_cast<wxLanguage
>(lang
->Language
);
205 // `Main program' equivalent, creating windows and returning main app frame
208 if ( !wxApp::OnInit() )
211 if ( m_lang
== wxLANGUAGE_UNKNOWN
)
213 int lng
= wxGetSingleChoiceIndex
215 _("Please choose language:"),
220 m_lang
= lng
== -1 ? wxLANGUAGE_DEFAULT
: langIds
[lng
];
223 // don't use wxLOCALE_LOAD_DEFAULT flag so that Init() doesn't return
224 // false just because it failed to load wxstd catalog
225 if ( !m_locale
.Init(m_lang
, wxLOCALE_CONV_ENCODING
) )
227 wxLogWarning(_("This language is not supported by the system."));
229 // continue nevertheless
232 // normally this wouldn't be necessary as the catalog files would be found
233 // in the default locations, but when the program is not installed the
234 // catalogs are in the build directory where we wouldn't find them by
236 wxLocale::AddCatalogLookupPathPrefix(wxT("."));
238 // Initialize the catalogs we'll be using
239 if (!m_locale
.AddCatalog(wxT("internat")))
240 wxLogError(_("Couldn't find/load the 'internat' catalog."));
242 // this catalog is installed in standard location on Linux systems and
243 // shows that you may make use of the standard message catalogs as well
245 // if it's not installed on your system, it is just silently ignored
249 m_locale
.AddCatalog("fileutils");
253 // Create the main frame window
254 MyFrame
*frame
= new MyFrame(m_locale
);
257 frame
->SetIcon(wxICON(mondrian
));
260 wxMenu
*file_menu
= new wxMenu
;
261 file_menu
->Append(INTERNAT_TEST
, _("&Test locale availability...\tCtrl-T"));
262 file_menu
->AppendSeparator();
263 file_menu
->Append(wxID_ABOUT
, _("&About..."));
264 file_menu
->AppendSeparator();
265 file_menu
->Append(wxID_EXIT
, _("E&xit"));
267 wxMenu
*test_menu
= new wxMenu
;
268 test_menu
->Append(wxID_OPEN
, _("&Open bogus file"));
269 test_menu
->Append(INTERNAT_PLAY
, _("&Play a game"));
270 test_menu
->AppendSeparator();
271 test_menu
->Append(INTERNAT_TEST_1
, _("&1 _() (gettext)"));
272 test_menu
->Append(INTERNAT_TEST_2
, _("&2 _N() (ngettext)"));
273 test_menu
->Append(INTERNAT_TEST_3
, _("&3 wxTRANSLATE() (gettext_noop)"));
275 wxMenuBar
*menu_bar
= new wxMenuBar
;
276 menu_bar
->Append(file_menu
, _("&File"));
277 menu_bar
->Append(test_menu
, _("&Test"));
278 frame
->SetMenuBar(menu_bar
);
287 // ----------------------------------------------------------------------------
289 // ----------------------------------------------------------------------------
291 // main frame constructor
292 MyFrame::MyFrame(wxLocale
& locale
)
295 _("International wxWidgets App")),
298 // this demonstrates RTL layout mirroring for Arabic locales
299 wxSizer
*sizer
= new wxBoxSizer(wxHORIZONTAL
);
300 sizer
->Add(new wxStaticText(this, wxID_ANY
, _("First")),
301 wxSizerFlags().Border());
302 sizer
->Add(new wxStaticText(this, wxID_ANY
, _("Second")),
303 wxSizerFlags().Border());
307 void MyFrame::OnQuit(wxCommandEvent
& WXUNUSED(event
) )
312 void MyFrame::OnAbout(wxCommandEvent
& WXUNUSED(event
))
315 wxString locale
= m_locale
.GetLocale();
316 wxString sysname
= m_locale
.GetSysName();
317 wxString canname
= m_locale
.GetCanonicalName();
319 localeInfo
.Printf(_("Language: %s\nSystem locale name:\n%s\nCanonical locale name: %s\n"),
320 locale
.c_str(), sysname
.c_str(), canname
.c_str() );
324 wxString(_("I18n sample\n(c) 1998, 1999 Vadim Zeitlin and Julian Smart"))
328 wxOK
| wxICON_INFORMATION
333 void MyFrame::OnPlay(wxCommandEvent
& WXUNUSED(event
))
335 wxString str
= wxGetTextFromUser
337 _("Enter your number:"),
338 _("Try to guess my number!"),
350 if ( !str
.ToLong(&num
) || num
< 0 )
352 str
= _("You've probably entered an invalid number.");
356 // this message is not translated (not in catalog) because we used _T()
357 // and not _() around it
358 str
= _T("You've found a bug in this program!");
360 else if ( num
== 17 )
364 // string must be split in two -- otherwise the translation would't be
366 str
<< _("Congratulations! you've won. Here is the magic phrase:")
367 << _("cannot create fifo `%s'");
371 // this is a more implicit way to write _() but note that if you use it
372 // you must ensure that the strings get extracted in the message
373 // catalog as by default xgettext won't do it; it only knows of _(),
374 // not of wxTRANSLATE(). As internat's readme.txt says you should thus
375 // call xgettext with -kwxTRANSLATE.
376 str
= wxTRANSLATE("Bad luck! try again...");
379 wxMessageBox(str
, _("Result"), wxOK
| wxICON_INFORMATION
);
382 void MyFrame::OnTestLocaleAvail(wxCommandEvent
& WXUNUSED(event
))
384 static wxString s_locale
;
385 wxString locale
= wxGetTextFromUser
387 _("Enter the locale to test"),
388 wxGetTextFromUserPromptStr
,
392 if ( locale
.empty() )
396 const wxLanguageInfo
* const info
= wxLocale::FindLanguageInfo(s_locale
);
399 wxLogError(_("Locale \"%s\" is unknown."), s_locale
.c_str());
403 if ( wxLocale::IsAvailable(info
->Language
) )
404 wxLogMessage(_("Locale \"%s\" is available."), s_locale
.c_str());
406 wxLogWarning(_("Locale \"%s\" is not available."), s_locale
.c_str());
409 void MyFrame::OnOpen(wxCommandEvent
& WXUNUSED(event
))
411 // open a bogus file -- the error message should be also translated if
412 // you've got wxstd.mo somewhere in the search path
413 wxFile
file(wxT("NOTEXIST.ING"));
416 void MyFrame::OnTest1(wxCommandEvent
& WXUNUSED(event
))
418 const wxString title
= _("Testing _() (gettext)");
419 wxTextEntryDialog
d(this, _("Please enter text to translate"),
420 title
, wxTRANSLATE("default value"));
422 if (d
.ShowModal() == wxID_OK
)
424 wxString v
= d
.GetValue();
426 s
<< "\n" << v
<< " -> "
427 << wxGetTranslation(v
.c_str()) << "\n";
432 void MyFrame::OnTest2(wxCommandEvent
& WXUNUSED(event
))
434 const wxString title
= _("Testing _N() (ngettext)");
435 wxTextEntryDialog
d(this,
436 _("Please enter range for plural forms of \"n files deleted\" phrase"),
439 if (d
.ShowModal() == wxID_OK
)
442 wxSscanf(d
.GetValue(), "%d-%d", &first
, &last
);
445 for (int n
= first
; n
<= last
; ++n
)
448 wxPLURAL("file deleted", "files deleted", n
) <<
455 void MyFrame::OnTest3(wxCommandEvent
& WXUNUSED(event
))
457 const char* lines
[] =
459 wxTRANSLATE("line 1"),
460 wxTRANSLATE("line 2"),
461 wxTRANSLATE("line 3"),
464 wxString
s(_("Testing wxTRANSLATE() (gettext_noop)"));
466 for (size_t i
= 0; i
< WXSIZEOF(lines
); ++i
)
468 s
<< lines
[i
] << " -> " << wxGetTranslation(lines
[i
]) << "\n";