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"
35 #if defined(__WXGTK__) || defined(__WXX11__) || defined(__WXMOTIF__) || defined(__WXMAC__) || defined(__WXMGL__)
36 #include "mondrian.xpm"
39 // ----------------------------------------------------------------------------
41 // ----------------------------------------------------------------------------
43 // Define a new application type
44 class MyApp
: public wxApp
47 virtual bool OnInit();
50 wxLocale m_locale
; // locale we'll be using
53 // Define a new frame type
54 class MyFrame
: public wxFrame
57 MyFrame(wxLocale
& m_locale
);
60 void OnQuit(wxCommandEvent
& event
);
61 void OnAbout(wxCommandEvent
& event
);
62 void OnPlay(wxCommandEvent
& event
);
63 void OnOpen(wxCommandEvent
& event
);
64 void OnTest1(wxCommandEvent
& event
);
65 void OnTest2(wxCommandEvent
& event
);
66 void OnTest3(wxCommandEvent
& event
);
73 // ----------------------------------------------------------------------------
75 // ----------------------------------------------------------------------------
77 // ID for the menu commands
80 INTERNAT_TEXT
= wxID_HIGHEST
+ 1,
89 static const wxLanguage langIds
[] =
99 #if wxUSE_UNICODE || defined(__WXMOTIF__)
105 wxLANGUAGE_ENGLISH_US
109 // note that it makes no sense to translate these strings, they are
110 // shown before we set the locale anyhow
111 const wxString langNames
[] =
113 _T("System default"),
121 #if wxUSE_UNICODE || defined(__WXMOTIF__)
131 // the arrays must be in sync
132 wxCOMPILE_TIME_ASSERT( WXSIZEOF(langNames
) == WXSIZEOF(langIds
),
133 LangArraysMismatch
);
135 // ----------------------------------------------------------------------------
137 // ----------------------------------------------------------------------------
139 BEGIN_EVENT_TABLE(MyFrame
, wxFrame
)
140 EVT_MENU(wxID_EXIT
, MyFrame
::OnQuit
)
141 EVT_MENU(wxID_ABOUT
, MyFrame
::OnAbout
)
142 EVT_MENU(INTERNAT_TEST
, MyFrame
::OnPlay
)
143 EVT_MENU(INTERNAT_OPEN
, MyFrame
::OnOpen
)
144 EVT_MENU(INTERNAT_TEST_1
, MyFrame
::OnTest1
)
145 EVT_MENU(INTERNAT_TEST_2
, MyFrame
::OnTest2
)
146 EVT_MENU(INTERNAT_TEST_3
, MyFrame
::OnTest3
)
151 // ============================================================================
153 // ============================================================================
155 // ----------------------------------------------------------------------------
157 // ----------------------------------------------------------------------------
159 // `Main program' equivalent, creating windows and returning main app frame
166 // the parameter must be the lang index
167 wxString
tmp(argv
[1]);
173 lng
= wxGetSingleChoiceIndex
175 _T("Please choose language:"),
184 // don't use wxLOCALE_LOAD_DEFAULT flag so that Init() doesn't return
185 // false just because it failed to load wxstd catalog
186 if ( !m_locale
.Init(langIds
[lng
], wxLOCALE_CONV_ENCODING
) )
188 wxLogError(_T("This language is not supported by the system."));
193 // if the message catalogs are installed in non-default locations you can
194 // use this function to let wxLocale know about them
195 // wxLocale::AddCatalogLookupPathPrefix(wxT("message_catalogs_subdir"));
197 // Initialize the catalogs we'll be using
198 m_locale
.AddCatalog(wxT("internat"));
200 // this catalog is installed in standard location on Linux systems and
201 // shows that you may make use of the standard message catalogs as well
203 // if it's not installed on your system, it is just silently ignored
207 m_locale
.AddCatalog(_T("fileutils"));
211 // Create the main frame window
212 MyFrame
*frame
= new MyFrame(m_locale
);
215 frame
->SetIcon(wxICON(mondrian
));
218 wxMenu
*file_menu
= new wxMenu
;
219 file_menu
->Append(wxID_ABOUT
, _("&About..."));
220 file_menu
->AppendSeparator();
221 file_menu
->Append(wxID_EXIT
, _("E&xit"));
223 wxMenu
*test_menu
= new wxMenu
;
224 test_menu
->Append(INTERNAT_OPEN
, _("&Open bogus file"));
225 test_menu
->Append(INTERNAT_TEST
, _("&Play a game"));
226 test_menu
->AppendSeparator();
227 test_menu
->Append(INTERNAT_TEST_1
, _("&1 _() (gettext)"));
228 test_menu
->Append(INTERNAT_TEST_2
, _("&2 _N() (ngettext)"));
229 test_menu
->Append(INTERNAT_TEST_3
, _("&3 wxTRANSLATE() (gettext_noop)"));
231 wxMenuBar
*menu_bar
= new wxMenuBar
;
232 menu_bar
->Append(file_menu
, _("&File"));
233 menu_bar
->Append(test_menu
, _("&Test"));
234 frame
->SetMenuBar(menu_bar
);
243 // ----------------------------------------------------------------------------
245 // ----------------------------------------------------------------------------
247 // main frame constructor
248 MyFrame
::MyFrame(wxLocale
& locale
)
251 _("International wxWidgets App")),
257 void MyFrame
::OnQuit(wxCommandEvent
& WXUNUSED(event
) )
262 void MyFrame
::OnAbout(wxCommandEvent
& WXUNUSED(event
))
265 wxString locale
= m_locale
.GetLocale();
266 wxString sysname
= m_locale
.GetSysName();
267 wxString canname
= m_locale
.GetCanonicalName();
269 localeInfo
.Printf(_("Language: %s\nSystem locale name:\n%s\nCanonical locale name: %s\n"),
270 locale
.c_str(), sysname
.c_str(), canname
.c_str() );
274 wxString(_("I18n sample\n(c) 1998, 1999 Vadim Zeitlin and Julian Smart"))
278 wxOK
| wxICON_INFORMATION
283 void MyFrame
::OnPlay(wxCommandEvent
& WXUNUSED(event
))
285 wxString str
= wxGetTextFromUser
287 _("Enter your number:"),
288 _("Try to guess my number!"),
300 if ( !str
.ToLong(&num
) || num
< 0 )
302 str
= _("You've probably entered an invalid number.");
306 // this message is not translated (not in catalog) because we used _T()
307 // and not _() around it
308 str
= _T("You've found a bug in this program!");
310 else if ( num
== 17 )
314 // string must be split in two -- otherwise the translation would't be
316 str
<< _("Congratulations! you've won. Here is the magic phrase:")
317 << _("cannot create fifo `%s'");
321 // this is a more implicit way to write _() but note that if you use it
322 // you must ensure that the strings get extracted in the message
323 // catalog as by default xgettext won't do it (it only knows of _(),
324 // not wxGetTranslation())
325 str
= wxGetTranslation(_T("Bad luck! try again..."));
328 wxMessageBox(str
, _("Result"), wxOK
| wxICON_INFORMATION
);
331 void MyFrame
::OnOpen(wxCommandEvent
&)
333 // open a bogus file -- the error message should be also translated if
334 // you've got wxstd.mo somewhere in the search path
335 wxFile
file(wxT("NOTEXIST.ING"));
338 void MyFrame
::OnTest1(wxCommandEvent
& WXUNUSED(event
))
340 const wxChar
* title
= _("Testing _() (gettext)");
341 wxTextEntryDialog
d(this, _("Please enter text to translate"),
342 title
, wxTRANSLATE("default value"));
343 if (d
.ShowModal() == wxID_OK
)
345 wxString v
= d
.GetValue();
347 s
<< _T("\n") << v
<< _T(" -> ")
348 << wxGetTranslation(v
.c_str()) << _T("\n");
353 void MyFrame
::OnTest2(wxCommandEvent
& WXUNUSED(event
))
355 const wxChar
* title
= _("Testing _N() (ngettext)");
356 wxTextEntryDialog
d(this,
357 _("Please enter range for plural forms of \"n files deleted\" phrase"),
359 if (d
.ShowModal() == wxID_OK
)
362 wxSscanf(d
.GetValue(), _T("%d-%d"), &first
, &last
);
365 for (int n
= first
; n
<= last
; ++n
)
368 wxPLURAL("file deleted", "files deleted", n
) <<
375 void MyFrame
::OnTest3(wxCommandEvent
& WXUNUSED(event
))
377 const wxChar
* lines
[] =
379 wxTRANSLATE("line 1"),
380 wxTRANSLATE("line 2"),
381 wxTRANSLATE("line 3"),
383 wxString
s(_("Testing wxTRANSLATE() (gettext_noop)"));
385 for (size_t i
= 0; i
< WXSIZEOF(lines
); ++i
)
387 s
<< lines
[i
] << _T(" -> ") << wxGetTranslation(lines
[i
]) << _T("\n");