因公司業務需要,需要將原有的ERP系統加上支持繁體語言,但不能改變原有的編碼方式,即:普通程序員感受不到編碼有什么不同。經過我與幾個同事的多番溝通,確定了以下兩種方案:
方案一:在窗體基類中每次加載并顯示窗體時,會自動遞歸遍歷含文本顯示的控件(Button,CheckBox,GroupBox,Label,LinkLabel,TextBox,StatusStrip,TabPage,ToolStrip,RadioButton,DateTimePicker,DataGridView,CheckedListBox,TreeView,MenuStrip),并根據不同的控件類型的文本屬性調用簡繁轉換方法進行轉換并重新設置新的相應文本屬性的內容(比如:繁體內容)
優點:編碼簡單,對普通程序員的編碼無影響(除窗體類的基類由Form類變成MyStyleFormBase類);
缺點:因每次打開窗體都需要遍歷控件并進行簡繁轉換,如果界面上的控件較多,則可能導致打開窗體較慢,影響用戶體驗,且子控件的文本內容改變時需程序員手動通知,無法自動感知并轉換。
具體實現思路如下:
一.對Form類進行二次封裝(繼承),定義一個MyStyleFormBase類,并在里面加入每次加載并顯示窗體類型時,會自動遞歸遍歷含文本顯示的控件,并根據不同的控件類型的文本屬性調用簡繁轉換方法進行轉換并重新設置新的相應文本屬性的內容,這樣當所有的窗體都繼承MyStyleFormBase類時,均默認就實現了遍歷與轉換的過程,程序員無需再次編碼,甚至都無需知道存在遍歷與轉換的過程,從而提高了代碼的復用性,具體代碼如下:
public class MyStyleFormBase : Form{ public MyStyleFormBase() { if (!Thread.CurrentThread.CurrentUICulture.Name.Equals("zh-CHS", StringComparison.OrdinalIgnoreCase)) //如果是簡體,則無需轉換 { base.TextChanged += MyStyleFormBase_TextChanged; base.Shown += MyStyleFormBase_Shown; } } private void MyStyleFormBase_TextChanged(object sender, EventArgs e) { this.Text = LanguageHelper.GetLanguageText(this.Text); } private void MyStyleFormBase_Shown(object sender, EventArgs e) { LanguageHelper.SetControlLanguageText(this); base.ControlAdded += MyStyleFormBase_ControlAdded; } private void MyStyleFormBase_ControlAdded(object sender, ControlEventArgs e) { LanguageHelper.SetControlLanguageText(e.Control); } /// <summary> /// 強制通知子控件改變消息 /// </summary> /// <param name="target"></param> protected virtual void PerformChildrenChange(Control target) { LanguageHelper.SetControlLanguageText(target); } /// <summary> /// 彈出消息框 /// </summary> /// <param name="text"></param> /// <param name="caption"></param> /// <param name="buttons"></param> /// <param name="icon"></param> /// <param name="defaultButton"></param> /// <returns></returns> protected DialogResult MessageBoxShow(string text, string caption, MessageBoxButtons buttons = MessageBoxButtons.OK, MessageBoxIcon icon = MessageBoxIcon.None, MessageBoxDefaultButton defaultButton = MessageBoxDefaultButton.Button1) { return MessageBox.Show(LanguageHelper.GetLanguageText(text), LanguageHelper.GetLanguageText(caption), buttons, icon, defaultButton); }}
代碼邏輯簡要說明:
1.當當前UI的文化區域不為中文簡體時(因為本程序本身都是基于簡體開發的),就訂閱窗體顯示事件Shown及窗體標題改變事件TextChanged,作用:當窗體顯示時,則會遍歷控件并轉換為繁體,當標題的文本改變時,也會自動轉換為繁體;
2.當窗體顯示后訂閱窗體的控件增加事件ControlAdded,作用:當窗體顯示后,若后續存在代碼增加控件時,會自動將控件及其子控件進行繁體的轉換,保證一個都不漏;
3.增加一個消息提示框方法,目的是彈出消息窗口前能夠將簡體文本轉換成繁體文本;
4.增加一個強制通知子控件改變消息的方法PerformChildrenChange,當某個控件的文本內容或增加子控件發生時,由于窗體本身無法捕獲到,故需要調用該方法來遍歷與轉換子控件的文本內容;(感覺這里不太好,但目前沒有更好的辦法,如果大家有更好的辦法,歡迎留言評論)
二、LanguageHelper:語方轉換公共類(目前僅支持簡繁轉換,依賴于:ChineseConverter.dll)代碼如下:
由于代碼過長,請點擊下載
該類邏輯很簡單,就是從一個父控件開始,遍歷所有的子控件,并根據不同的控件類型將控件相應的文本內容轉換成簡體或繁體,調用方法:SetControlLanguageText
以上二步就實現了多語言的支持了(準確的說是簡繁轉換),應用到項目中很簡單,只需將窗體默認的基類Form改成:MyStyleFormBase即可,如:public partial class FormTest : MyStyleFormBase
方案二:由控件依據當前區域信息+緩存語言字典直接實現各控件自行轉換
優點:無需遍歷,各控件自行根據區域信息自支轉換,因此效率較高,對普通程序員的編碼無影響(除窗體類的基類由Form類變成MyStyleFormBase類外,還需要使用支持多語言的控件,這些控件均由普通控件二次封裝得來,保留原有的所有屬性及事件);
缺點:需將所有帶文本顯示的控件(如:Button,CheckBox,GroupBox,Label,LinkLabel,TextBox,StatusStrip,TabPage,ToolStrip,RadioButton,DateTimePicker,DataGridView,CheckedListBox,TreeView)均進行二次封裝,控件統一命名為:MyStyleXXX
涉及的控件較多,編碼相對復雜;
具體實現思路如下:
一.對Form類進行二次封裝(繼承),定義一個MyStyleFormBase類,里面加入對窗體標題進行修改時,能自動進行多語言轉換功能,具體代碼如下:
public partial class MyStyleFormBase : Form{ public MyStyleFormBase() { base.TextChanged += MyStyleFormBase_TextChanged; } private void MyStyleFormBase_TextChanged(object sender, EventArgs e) { if (!Common.IsChsLanguage()) { this.Text = LanguageHelper.GetLanguageText(this.Text); } } /// <summary> /// 彈出消息框 /// </summary> /// <param name="text"></param> /// <param name="caption"></param> /// <param name="buttons"></param> /// <param name="icon"></param> /// <param name="defaultButton"></param> /// <returns></returns> protected DialogResult MessageBoxShow(string text, string caption = "提示", MessageBoxButtons buttons = MessageBoxButtons.OK, MessageBoxIcon icon = MessageBoxIcon.None, MessageBoxDefaultButton defaultButton = MessageBoxDefaultButton.Button1) { if (!Common.IsChsLanguage()) { text = LanguageHelper.GetLanguageText(text); caption = LanguageHelper.GetLanguageText(caption); } return MessageBox.Show(text, caption, buttons, icon, defaultButton); }}
代碼邏輯很簡單,就是訂閱一個Form.TextChanged事件,以便當根據IsChsLanguage(判斷是否為簡體模式)判斷不是簡體時,則需進行Form.Text轉換
二.定義多語言支持普通控件及容器控件接口(IMultiLanguageControl、IMultiLanguageContainerControl),具體代碼如下:(此處僅是為了作一個規范,支持手動設置轉換控件的文本內容)
/// <summary>/// 支持多語言普通控件(無子控件)/// </summary>public interface IMultiLanguageControl{ string DefaultLangText { get; } string CurrentLangText { get; set; }}/// <summary>/// 支持多語言容器控件(包含子控件)/// </summary>public interface IMultiLanguageContainerControl{ Dictionary<object, string> DefaultLangTexts { get; } Dictionary<object, string> CurrentLangTexts { get; set; } Control this[string ctrlName] { get; set; } void SetItemCurrentLangText(string ctrlName, string langText);event EventHandler<ChildrenAddedEventArgs> ChildrenChanged;}public class ChildrenAddedEventArgs : EventArgs{ public Dictionary<object, string> LangTexts { get; private set; } public ChildrenAddedEventArgs() { LangTexts = new Dictionary<object, string>(); } public ChildrenAddedEventArgs(Dictionary<object, string> langTexts) { this.LangTexts = langTexts; } public string this[object key] {get {return LangTexts[key]; }set { LangTexts[key] = value; } }}
三、實現支持多語言普通控件:基于原有標準控件(Button,CheckBox,GroupBox,Label,LinkLabel,TextBox,RadioButton,DateTimePicker)進行二次封裝,實現IMultiLanguageControl接口,各控件代碼如下:
以下是MyStyleButton定義代碼,MyStyleCheckBox、MyStyleGroupBox、MyStyleLabel、MyStyleLinkLabel、MyStyleTextBox、MyStyleRadioButton里面的實現代碼均相同
public partial class MyStyleButton : MyButton, IMultiLanguageControl { static Dictionary<string, string> LanDict = new Dictionary<string, string>(); public MyStyleButton() { } public override string Text { get { if (!DesignMode && System.Threading.Thread.CurrentThread.CurrentUICulture.Name != "zh-CHS") { if (LanDict.ContainsKey(DefaultLangText)) { return CurrentLangText; }else { string langText = LanguageHelper.GetLanguageText(base.Text); LanDict[base.Text] = langText;return langText; } } return base.Text; }set { base.Text = value; } } [Browsable(false)] [DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)] public string DefaultLangText { get { return base.Text; } } [Browsable(false)] [DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)] public string CurrentLangText { get {try { return LanDict[DefaultLangText]; } catch (Exception) { return ""; } }set { if (System.Threading.Thread.CurrentThread.CurrentUICulture.Name != "zh-CHS") { if (LanDict.ContainsKey(DefaultLangText)) { LanDict[DefaultLangText] = value; } else { LanDict.Add(DefaultLangText, value); } } } } }
二次封裝這些控件的目的是:1.暴露統一的屬性,便于直接遍歷并賦值(需手動改變文本內容語言的情況);2.當文本內容發生改變時,能夠根據語言緩存字典,快速直接的自我簡繁轉換,無需再次遍歷;
四、實現支持多語言容器控件:基于原有標準控件(StatusStrip,TabPage,ToolStrip,DataGridView,CheckedListBox,TreeView)進行二次封裝,實現IMultiLanguageContainerControl接口,各控件代碼如下:
MyStyleDataGridView:
由于代碼過長,請點擊下載
MyStyleTabControl:
由于代碼過長,請點擊下載
二次封裝這些控件的目的是:1.暴露統一的屬性,便于直接遍歷并賦值(僅當直接改變文本內容語言時需要);2.當文本內容或子控件文本內容或新增子控件發生改變時,能夠根據語言緩存字典,快速直接的自我簡繁轉換,無需再次遍歷;
五.LanguageHelper:語方轉換公共類,與方案一原理相同,但相對方案一要簡單很多,代碼如下:
由于代碼過長,請點擊下載
Common.IsChsLanguage方法定義如下:
public static bool IsChsLanguage(){ return System.Threading.Thread.CurrentThread.CurrentUICulture.Name.Equals("zh-CHS", StringComparison.OrdinalIgnoreCase);}
多語言支持的容器類控件的實現難點是:捕獲子控件文本內容的改變,由于沒有現成的事件或方法,故需要通過其它的途徑來實現文本內容改時能夠進行處理。
以上就是本文的全部內容,有人可能會說,為何不采用資源文件的形式,原因文章一開頭就說明了,是在原有的系統上,且不能改變原有的編碼風格,故才花了這么大的力氣來實現這個簡繁轉換的功能,我公司經領導確認最終采用的方案二。文中若有不足,歡迎交流,謝謝!
注:控件的實現代碼都貼出來了,大家若需要的話,可以直接COPY走,另外為了系統安全,簡繁體的系統截圖我就不貼出來了,大家可以自行測試。
新聞熱點
疑難解答