// 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
// ============================================================================
#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
// ----------------------------------------------------------------------------
void OnTest1(wxCommandEvent& event);
void OnTest2(wxCommandEvent& event);
void OnTest3(wxCommandEvent& event);
+ void OnTestMsgBox(wxCommandEvent& event);
DECLARE_EVENT_TABLE()
INTERNAT_PLAY,
INTERNAT_TEST_1,
INTERNAT_TEST_2,
- INTERNAT_TEST_3
+ INTERNAT_TEST_3,
+ INTERNAT_TEST_MSGBOX
};
// language data
{
wxLANGUAGE_DEFAULT,
wxLANGUAGE_FRENCH,
+ wxLANGUAGE_ITALIAN,
wxLANGUAGE_GERMAN,
wxLANGUAGE_RUSSIAN,
wxLANGUAGE_BULGARIAN,
// 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__)
- _T("Japanese"),
+ "Japanese",
#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
};
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)
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
- wxLocale::AddCatalogLookupPathPrefix(wxT("."));
+ wxLocale::AddCatalogLookupPathPrefix(".");
// 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
#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);
- // 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);
- SetTopWindow(frame);
return true;
}
_("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")),
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"))
- + wxT("\n\n")
+ + "\n\n"
+ localeInfo,
_("About Internat"),
wxOK | wxICON_INFORMATION
}
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
- str = _T("You've found a bug in this program!");
+ str = wxT("You've found a bug in this program!");
}
else if ( num == 17 )
{
{
// 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);
}
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::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))
{
- 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"),
- title, wxTRANSLATE("default value"));
+ title, wxTRANSLATE("default value"));
+
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))
{
- 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"),
- title, _T("0-10"));
+ title, "0-10");
+
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);
- s << _T("\n");
+ s << "\n";
for (int n = first; n <= last; ++n)
{
- s << n << _T(" ") <<
+ s << n << " " <<
wxPLURAL("file deleted", "files deleted", n) <<
- _T("\n");
+ "\n";
}
wxMessageBox(s);
}
wxTRANSLATE("line 2"),
wxTRANSLATE("line 3"),
};
+
wxString s(_("Testing wxTRANSLATE() (gettext_noop)"));
- s << _T("\n");
+ s << "\n";
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);
}
-
+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."));
+ }
+}