How To: Localize Bar and Ribbon Skin Items

发布于:2024-06-12 ⋅ 阅读:(72) ⋅ 点赞:(0)

您可以使用Localizer对象自定义皮肤菜单,而不是迭代每个条形皮肤子菜单项和功能区皮肤库项容器来手动修改这些项。此方法允许您同时自定义所有现有栏子菜单和功能区库中的外观项目。

  • 创建BarLocalizer类的派生类并重写XtraLocalizer.GetLocalizedString方法。
public class MyBarLocalizer : BarLocalizer {
    public override string GetLocalizedString(BarString id) {
        if(id == BarString.SkinCaptions) {
            string defaultSkinCaptions = base.GetLocalizedString(id);
            string newSkinCaptions = defaultSkinCaptions.Replace("|DevExpress Style|", "|Default Skin|");
            newSkinCaptions = newSkinCaptions.Replace("|DevExpress Dark Style|", "|Default Dark Skin|");
            return newSkinCaptions;
        }
        return base.GetLocalizedString(id);
    }
}

  • 使用静态BarLocalizer.Active属性,将自定义类的新实例设置为当前条形图定位器。在应用程序之前在Program类中调用此方法。运行方法调用,如下所示。
static class Program {
    /// <summary>
    /// The main entry point for the application.
    /// </summary>
    [STAThread]
    static void Main() {
        BonusSkins.Register();
        SkinManager.EnableFormSkins();
        BarLocalizer.Active = new MyBarLocalizer();
        Application.Run(new Form1());
    }
}

  • 运行应用程序以查看结果。
    在这里插入图片描述
    重要提示
    如果自定义定位器是在条形外观子项之后指定的,或者功能区外观库已经初始化(例如,在“加载”事件中),则外观项将显示默认标题。在这种情况下,请调用静态SkinHelper。InitSkinPopupMenu和SkinHelper。InitSkinGallery方法再次初始化皮肤项目并激活定位器。
void ucBar_Load(object sender, EventArgs e) {
    BarLocalizer.Active = new MyBarLocalizer();
    //refresh bar sub-item links
    skinBarSubItem1.ClearLinks();
    SkinHelper.InitSkinPopupMenu(skinBarSubItem1);
    //refresh Ribbon gallery links
    SkinHelper.InitSkinGallery(skinRibbonGalleryBarItem1);
}