W poprzednim wpisie przedstawi\u0142em w jaki spos\u00f3b mo\u017cna lokalizowa\u0107 aplikacj\u0119 napisan\u0105 w Silverlight 4 oraz Windows Phone, wykorzystuj\u0105c do tego ten sam mechanizm. Tym razem zademonstruje w jaki spos\u00f3b mo\u017cna nieco upro\u015bci\u0107 sk\u0142adnie t\u0142umaczenia wykorzystuj\u0105c do tego MarkupExtension.
\nJe\u017celi kiedykolwiek pisa\u0142e\u015b co\u015b w Silverlighcie, Windows Phonie lub WPF-ie istnieje du\u017ca szansa, \u017ce u\u017cywa\u0142e\u015b ju\u017c MarkupExtension. Do najpopularniejszych MarkupExtensions nale\u017c\u0105 takie s\u0142owa kluczowe (u\u017cywane w XAML-u) jak:<\/p>\n
Na potrzeby mechanizmu lokalizowania aplikacji WPF (ewentualnie Silverlight 5) stworzymy customowe MarkupExtenssion, kt\u00f3re b\u0119dzie odpowiedzialne za t\u0142umaczenie element\u00f3w UI naszej aplikacji.
\nZacznijmy od przygotowania plik\u00f3w zasob\u00f3w. Podobnie jak w poprzednim wpisie utw\u00f3rzmy trzy pliki:<\/p>\n
W plikach tych b\u0119dziemy przechowywa\u0107 nasze t\u0142umaczenia. Nast\u0119pnie stw\u00f3rzmy klas\u0119 Translator, kt\u00f3ra b\u0119dzie dziedziczy\u0142a po klasie MarkupExtension.Do klasy tej dodajmy w\u0142a\u015bciwo\u015b\u0107<\/p>\n
\r\npublic string Key{ get; set; }\r\n<\/pre>\n,kt\u00f3ra b\u0119dzie przechowywa\u0107 klucz dzi\u0119ki kt\u00f3remu z pliku zasob\u00f3w wyci\u0105gniemy tekst w odpowiednim j\u0119zyku. W kolejnym kroku musimy przeci\u0105\u017cy\u0107 funkcj\u0119<\/p>\n
\r\npublic abstract object ProvideValue(IServiceProvider serviceProvider)\r\n<\/pre>\ntak aby dostarczy\u0142a nam ona przet\u0142umaczony tekst.W moim pierwszym podej\u015bciu funkcja ta wygl\u0105da\u0142a w nast\u0119puj\u0105cy spos\u00f3b<\/p>\n
\r\npublic override object ProvideValue(IServiceProvider serviceProvider)\r\n{\r\n Binding binding = new Binding(Key) { Source = new Localization(),Mode = BindingMode.OneWay};\r\n return binding.ProvideValue(serviceProvider);\r\n}\r\n<\/pre>\nWadami takiego rozwi\u0105zania by\u0142o:<\/p>\n
Ostatecznie zatem zrezygnowa\u0142em z przedstawionej wy\u017cej opcji i zdecydowa\u0142em si\u0119 na metod\u0119 odrobin\u0119 bardziej zaawansowan\u0105. Po pierwsze utworzy\u0142em klas\u0119 TranslationManager<\/p>\n
\r\npublic class TranslationManager\r\n{\r\n public event Action LanguageChanged = val => { };\r\n private static TranslationManager _instance;\r\n private static readonly object LockInstance = new object();\r\n public static TranslationManager Instance\r\n {\r\n get\r\n {\r\n lock (LockInstance)\r\n {\r\n return _instance = _instance ?? new TranslationManager();\r\n }\r\n }\r\n }\r\n \r\n private CultureInfo _currentCulture;\r\n public CultureInfo CurrentCulture\r\n {\r\n get { return _currentCulture ?? (CurrentCulture = Thread.CurrentThread.CurrentUICulture); }\r\n set\r\n {\r\n _currentCulture = value;\r\n OnLanguageChanged(CurrentCulture);\r\n }\r\n }\r\n \r\n protected void OnLanguageChanged(CultureInfo culture)\r\n {\r\n LanguageChanged(culture);\r\n }\r\n \r\n private TranslationManager()\r\n {\r\n }\r\n \r\n public string Translate(string key)\r\n {\r\n return Localization.ResourceManager.GetString(key, CurrentCulture);\r\n }\r\n}\r\n<\/pre>\nkt\u00f3ra b\u0119dzie zarz\u0105dza\u0142a t\u0142umaczeniami. Najwa\u017cniejsz\u0105 metod\u0105 tej klasy jest oczywi\u015bcie funkcja<\/p>\n
\r\npublic string Translate(string key)\r\n<\/pre>\nkt\u00f3ra to zwraca tekst w odpowiednim j\u0119zyku – w zale\u017cno\u015bci od kultury, kt\u00f3ra zostanie ustawiona w TranslationManagerze. Ponadto TranslationManager posiada jedno zdarzenie<\/p>\n
\r\npublic event Action LanguageChanged\r\n<\/pre>\nkt\u00f3re ma za zadanie poinformowa\u0107 UI o potrzebie od\u015bwie\u017cenia zbindowanych element\u00f3w. W jaki spos\u00f3b si\u0119 to odbywa ? Wszystko zawdzi\u0119czamy interfejsowi INotifyPropertyChanged oraz bindingom. Funkcja ProvideValue zosta\u0142a zmodyfikowana w nast\u0119puj\u0105cy spos\u00f3b<\/p>\n
\r\npublic override object ProvideValue(IServiceProvider serviceProvider)\r\n{\r\n Binding binding = new Binding(\"Value\") { Source = new TranslationItem(Key), Mode = BindingMode.OneWay };\r\n return binding.ProvideValue(serviceProvider);\r\n}\r\n<\/pre>\nW funkcji tej tworze binding, kt\u00f3ry binduje si\u0119 do w\u0142a\u015bciwo\u015bci Value obiektu TranslationItem. TranslationItem jest to prosty obiekt kt\u00f3ry udost\u0119pnia w\u0142a\u015bciwo\u015b\u0107 Value zwracaj\u0105c\u0105 przet\u0142umaczony tekst. Dodatkowo obiekt ten podpina si\u0119 do zdarzenia LanguageChanged z klasy TranslationManager. W przypadku gdy kto\u015b zmieni j\u0119zyk aplikacji, odpalone zostanie zdarzenie NotifyPropertyChanged, kt\u00f3re poinformuje widok o potrzebie od\u015bwie\u017cenia odpowiednich element\u00f3w. Klasa TranslationItem wygl\u0105da zatem w nast\u0119puj\u0105cy spos\u00f3b<\/p>\n
\r\npublic sealed class TranslationItem : INotifyPropertyChanged, IDisposable\r\n{\r\n public event PropertyChangedEventHandler PropertyChanged = delegate { };\r\n private readonly string _key;\r\n public TranslationItem(string key)\r\n {\r\n _key = key;\r\n TranslationManager.Instance.LanguageChanged += Instance_LanguageChanged;\r\n }\r\n\r\n ~TranslationItem()\r\n {\r\n Dispose();\r\n }\r\n\r\n void Instance_LanguageChanged(System.Globalization.CultureInfo obj)\r\n {\r\n PropertyChanged(this, new PropertyChangedEventArgs(\"Value\"));\r\n }\r\n\r\n public string Value\r\n {\r\n get { return TranslationManager.Instance.Translate(_key); }\r\n }\r\n\r\n public void Dispose()\r\n {\r\n TranslationManager.Instance.LanguageChanged -= Instance_LanguageChanged;\r\n }\r\n}\r\n<\/pre>\nMaj\u0105c gotowy mechanizm t\u0142umacz\u0105cy mo\u017cemy wykorzysta\u0107 go w nast\u0119puj\u0105cy spos\u00f3b w XAML-u<\/p>\n
\r\n