DevExpress控件库 开发使用经验总结2 DevExpress汉化之WinForm开发模式汉化

  DevExpress控件库默认安装后,使用的本地资源为英文。Developer Express .NET产品都有本地化资源,比如按钮属性,控件属性描述,菜单项,确认和错误的信息等等,所有这些资源字符串可以很容易地被翻译成各种语言。对于要求使用中文汉字资源的项目来说,首要任务就是处理汉化。

  在WinForm开发模式下,处理汉化相对简单。有以下几种方法。

方法一:使用已经制作完成的汉化资源DLL

  对于早期的DevExpress版本,已经有制作好的汉化资源DLL,例如:基于v13.1的汉化文件“Dxper.LocalizationCHS.Win.v13.1.5.dll”,使用起来非常方便,将其复制到项目中使用即可。

  使用方法:引用 Dxper.LocalizationCHS.Win.v13.1.5.dll文件,并在窗体Form_Load事件中添加以下代码。仅适用于WinForm。

 DevExpress.XtraGrid.Localization.GridResLocalizer.Active = new
Dxper.LocalizationCHS.Win.XtraGridCHS(); DevExpress.XtraEditors.Controls.Localizer.Active = new
Dxper.LocalizationCHS.Win.XtraEditorsCHS(); DevExpress.XtraCharts.Localization.ChartResLocalizer.Active = new Dxper.LocalizationCHS.Win.XtraChartsCHS(); DevExpress.XtraBars.Localization.BarLocalizer.Active = new
Dxper.LocalizationCHS.Win.XtraBars(); DevExpress.XtraLayout.Localization.LayoutLocalizer.Active = new Dxper.LocalizationCHS.Win.XtraLayoutCHS(); DevExpress.XtraPrinting.Localization.PreviewLocalizer.Active = new Dxper.LocalizationCHS.Win.XtraPrintingCHS(); DevExpress.XtraTreeList.Localization.TreeListResLocalizer.Active = new Dxper.LocalizationCHS.Win.XtraTreeListCHS(); DevExpress.Office.Localization.OfficeResLocalizer.Active = new
Dxper.LocalizationCHS.Win.OfficeCHS(); DevExpress.XtraSpreadsheet.Localization.XtraSpreadsheetLocalizer.Active = new Dxper.LocalizationCHS.Win.XtraSpreadsheetCHS();

展开查看代码

然而此类汉化包同步更新速度较慢,当使用高版本DevExpress时就无法使用了。

方法二:使用DevExpress官方汉化资源DLL

  使用高版本的DevExpress后,需要使用官方的汉化资源文件。到官方下载汉化包后,打开目录,看到汉化文件是一系列的独立资源类,它对应着不同的控件汉化内容

DevExpress控件库 开发使用经验总结2 DevExpress汉化之WinForm开发模式汉化

以上是DevExpress控件库的全部汉化资源,我们不需要全部复制,根据项目的实际使用的控件,找到对应控件的汉化资源,按需复制。

DevExpress控件库 开发使用经验总结2 DevExpress汉化之WinForm开发模式汉化

红色框内即为项目中实际使用的控件(可能有更多其他引用),找到对应控件的汉化资源,将其拷贝到DevExpress安装目录D:\Program Files (x86)\DevExpress 14.1\Components\Bin\Framework(视具体安装路径)

DevExpress控件库 开发使用经验总结2 DevExpress汉化之WinForm开发模式汉化

以上操作完成后,在程序入口函数中,注册该资源文件:

Thread.CurrentThread.CurrentUICulture = new System.Globalization.CultureInfo("zh-cn"); //加载汉化语言包

DevExpress控件库 开发使用经验总结2 DevExpress汉化之WinForm开发模式汉化

  当项目安装部署,制作安装包时,同样需要以上汉化资源(后续文章会详细讲解基于DevExpress控件库开发项目的安装包制作过程)。如果是直接拷贝项目到其他机器上运行,需要把zh-cn目录拷贝到项目中才能正常运行。

  即使做了以上汉化,有些资源还是显示为英文

DevExpress控件库 开发使用经验总结2 DevExpress汉化之WinForm开发模式汉化

此消息提示框是按照方法二汉化后,在程序中运行的实际效果。其中按钮的显示文字汉化不成功,仍然为英文。

为了解决该问题,请参考方法三。

方法三:使用本地对象汉化,自定义汉化资源内容

每一个DevExpress组件或者库都有其相对应的本地化类。步骤为:

  1、创建一个子类继承相对应的本地化基类;

  2、重载GetLocalizedString方法,这方法应该返回字符串的具体字符串资源标识符;

  3、调用该类,实例化对应类的静态Active属性。

以XtraTreeList控件为例说明:

DevExpress控件库 开发使用经验总结2 DevExpress汉化之WinForm开发模式汉化

DevExpress控件库 开发使用经验总结2 DevExpress汉化之WinForm开发模式汉化

 /// <summary>
/// 自定义DevExpress汉化资源,汉化XtraTreeList控件
/// </summary>
public class CustomLocalizedXtraTreeList : TreeListLocalizer
{
/// <summary>
/// 重写GetLocalizedString方法
/// </summary>
/// <param name="id">StringId</param>
/// <returns></returns>
public override string GetLocalizedString(TreeListStringId id)
{
switch (id)
{
case TreeListStringId.MenuColumnBestFit:
return "最佳匹配";
case TreeListStringId.PrintDesignerHeader:
return "打印设置";
case TreeListStringId.ColumnCustomizationText:
return "自定义";
case TreeListStringId.MenuFooterMin:
return "最小值";
case TreeListStringId.MenuFooterMax:
return "最大值";
case TreeListStringId.MenuFooterSum:
return "和";
case TreeListStringId.MenuFooterAllNodes:
return "所有节点";
case TreeListStringId.MenuFooterCount:
return "计数";
case TreeListStringId.MenuColumnSortAscending:
return "升序排列";
case TreeListStringId.MenuFooterNone:
return "无";
case TreeListStringId.MenuColumnSortDescending:
return "降序排列";
case TreeListStringId.PrintDesignerDescription:
return "为当前的树状列表设置不同的打印选项";
case TreeListStringId.MenuColumnBestFitAllColumns:
return "最佳匹配 (所有列)";
case TreeListStringId.MenuFooterAverageFormat:
return "平均值={0:#.##}";
case TreeListStringId.ColumnNamePrefix:
return "列";
case TreeListStringId.MenuFooterMinFormat:
return "最小值={0}";
case TreeListStringId.MenuFooterCountFormat:
return "{0}";
case TreeListStringId.MenuColumnColumnCustomization:
return "列选择";
case TreeListStringId.MenuFooterMaxFormat:
return "最大值={0}";
case TreeListStringId.MenuFooterSumFormat:
return "和={0:#.##}";
case TreeListStringId.MultiSelectMethodNotSupported:
return "OptionsBehavior.MultiSelect未激活时,指定方法不能工作.";
case TreeListStringId.InvalidNodeExceptionText:
return " 要修正当前值吗?";
case TreeListStringId.MenuFooterAverage:
return "平均值";
} return base.GetLocalizedString(id);
}
}

展开查看代码

其他控件的自定义汉化方式与以上相同,我自己汉化了XtraBar控件、XtraEditor控件、XtraGrid控件、XtraLayout控件、XtraNavBar控件、XtraTreeList控件、XtraVerticalGrid控件,如下图:

DevExpress控件库 开发使用经验总结2 DevExpress汉化之WinForm开发模式汉化

为了统一调用,封装了一个方法

DevExpress控件库 开发使用经验总结2 DevExpress汉化之WinForm开发模式汉化

  最后在项目的入口函数或者窗体的Load事件中调用一次:

CustomDevExpressLocalizationCHS.SetSimpleChinese();方法即可实现自定义的汉化资源。

在项目中引用自定义汉化资源后,消息提示框如下:

DevExpress控件库 开发使用经验总结2 DevExpress汉化之WinForm开发模式汉化

按钮上的文字显示为汉字了,此时才算是真正的汉化。

由于无法上传附件,需要自定义汉化代码的朋友请加入.Net技术交流与分享群427789286,自行下载文件《DotNetLib.DevExpress.rar》。

上一篇:C语言复习4_while循环


下一篇:初始化 CSS 样式