DevExpress&WinForms-XtraMessageBox-定制和汉化

原创于 2025-05-20 16:23:29 发布 · 1.2k 阅读

10 ·

CC 4.0 BY-SA版权

文章标签：

#C# #DevExpress #WinForms

DevExpress 专栏收录该内容

19 篇文章

订阅专栏

XtraMessageBox-定制和汉化

在 Windows 应用开发中，消息框是用户交互的重要组件。Devexpress 的 XtraMessageBox 作为标准 MessageBox 的增强控件，提供了高度可定制的特性，支持界面样式、按钮布局、国际化等深度调整。本文将结合官方文档，详细介绍如何通过代码实现个性化定制，并附汉化实践方案。

一、定制图标：从系统图标到自定义矢量图

XtraMessageBox 支持替换默认图标为自定义图片（如 SVG 矢量图），提升视觉一致性。

1. 使用系统预设图标

通过 XtraMessageBoxArgs.ImageOptions 属性设置系统图标（如警告、错误等）：

var args = new XtraMessageBoxArgs
{
    Caption = "警告",
    Text = "操作将导致数据丢失！",
    Buttons = new[] { DialogResult.OK, DialogResult.Cancel },
    ImageOptions = 
    {
        // 为了方便使用了simpleButton1的图标
        // 使用时，可以自己选择图标
        Image = this.simpleButton1.ImageOptions.Image,
    }
};

XtraMessageBox.Show(args);

效果示例：

2. 加载自定义 SVG 图标

可以通过属性XtraMessageBoxArgs.ImageOptions.SvgImage，设置SVG图标。
另外还可以结合 SvgImageCollection 组件，嵌入矢量图标。

var args = new XtraMessageBoxArgs
{
    Caption = "警告",
    Text = "操作将导致数据丢失！",
    Buttons = new[] { DialogResult.OK, DialogResult.Cancel },
    ImageOptions = 
    {
        // 为了方便使用了simpleButton1的图标
        // 使用时，可以自己选择图标
        SvgImage = this.simpleButton1.ImageOptions.SvgImage,
    }
};

XtraMessageBox.Show(args);

效果示例：
svgimage

二、定制按钮：从布局到交互的全面改造

XtraMessageBox 支持按钮文本、图标、排列方式的灵活配置。

1. 自定义按钮文本与行为

通过 Buttons 属性指定按钮对应的 DialogResult，并在事件中处理用户选择：

var args = new XtraMessageBoxArgs
{
    Caption = "提示",
    Text = "是否保存修改并退出？",
    Buttons = new[] { DialogResult.Yes, DialogResult.No, DialogResult.Cancel },
};
XtraMessageBox.Show(args);

效果示例：
Buttons

2. 按钮添加 SVG 图标

通过 Showing 事件为按钮动态绑定图标（需引用 SimpleButton 组件）：

args.Showing += OnButtonArgsShowing;

private void OnButtonArgsShowing(object sender, XtraMessageShowingArgs e)
{
    //备注: sicImages 为 SvgImageCollection
    foreach (var control in e.MessageBoxForm.Controls)
    {
        if (control is SimpleButton button)
        {
            button.ImageOptions.SvgImageSize = new Size(16, 16);
            switch (button.DialogResult)
            {
                case DialogResult.Yes:
                    // 对勾图标
                    button.ImageOptions.SvgImage = this.sicImages[1]; 
                    break;
                case DialogResult.No:
                    // 叉号图标
                    button.ImageOptions.SvgImage = this.sicImages[3]; 
                    break;
                case DialogResult.Cancel:
                    // 随便来个图标吧
                    button.ImageOptions.SvgImage = this.sicImages[0];
                    break;
            }
        }
    }
}

效果示例：
button-icon

3. 调整按钮对齐方式

通过静态属性 ButtonsAlignment 控制按钮布局（左对齐/右对齐）：

XtraMessageBox.ButtonsAlignment = HorizontalAlignment.Right; // 右对齐（默认）
// XtraMessageBox.ButtonsAlignment = HorizontalAlignment.Left; // 左对齐

三、样式与字体：打造品牌化视觉风格

1. 修改文本字体与格式

通过 Showing 事件访问消息框窗体，调整字体样式：

var args = new XtraMessageBoxArgs
{
    Caption = "提示",
    Text = "我们要改变字体了？",
    Buttons = new[] { DialogResult.Yes, DialogResult.No },
};
args.Showing += OnFontArgsShowing;
XtraMessageBox.Show(args);


private void OnFontArgsShowing(object sender, XtraMessageShowingArgs e)
{
    // 正文字体大小
    e.Form.Appearance.Font = new Font("微软雅黑", 12, FontStyle.Bold);

    // 按钮字体与高度

    foreach (var control in e.MessageBoxForm.Controls)
    {
        if (control is SimpleButton button)
        {
            button.Appearance.Font = new Font("黑体", 10);
            button.Height = 30; // 增加按钮高度

            button.ImageOptions.SvgImageSize = new Size(16, 16);
            switch (button.DialogResult)
            {
                case DialogResult.Yes:
                    button.ImageOptions.SvgImage = this.sicImages[1];
                    button.Text = "是";
                    break;
                case DialogResult.No:
                    button.ImageOptions.SvgImage = this.sicImages[3];
                    button.Text = "否";
                    break;

            }
        }
    }
}

效果示例：
font

2. 使用 HTML 格式化文本

开启 AllowHtmlText 后，支持 HTML 标签渲染（如居中、加粗、嵌入图片）：

var args = new XtraMessageBoxArgs
{
    Caption = "提示",
    Buttons = new[] { DialogResult.Yes, DialogResult.No },
    AllowHtmlText = DefaultBoolean.True,
    Text = @"
        <p align='center'>
            <br><b>重要提示</b><br>
            这次我们使用HTML自定义MessageBox。
        </p>
    "
};

XtraMessageBox.Show(args);

效果示例：
html

四、汉化实践：让界面更贴合中文用户

1. 按钮文本汉化

默认按钮文本（如 “OK”、“Cancel”）需替换为中文：

var args = new XtraMessageBoxArgs
{
    Caption = "提示",
    Text = "我们正在进行汉化演示？",
    Buttons = new[] { DialogResult.Yes, DialogResult.No, DialogResult.Cancel },
};

args.Showing += OnLocalizeArgsShowing;

XtraMessageBox.Show(args);

private void OnLocalizeArgsShowing(object sender, XtraMessageShowingArgs e)
{
    foreach (var control in e.MessageBoxForm.Controls)
    {
        if (control is SimpleButton button)
        {
            switch (button.DialogResult)
            {
                case DialogResult.Yes:
                    button.Text = "是";
                    break;
                case DialogResult.No:
                    button.Text = "否";
                    break;
                case DialogResult.Cancel:
                    button.Text = "取消";
                    break;

            }
        }
    }
}

效果示例：

2. 使用`DevExpress.XtraEditors.Controls.Localizer`

Localizer提供本地化编辑器界面元素的方法：

public class XtraLocalizer : Localizer
{
    public override string GetLocalizedString(StringId id)
    {
        switch (id)
        {
            case StringId.XtraMessageBoxCancelButtonText:
                return "取消";
            case StringId.XtraMessageBoxOkButtonText:
                return "确定";
            case StringId.XtraMessageBoxYesButtonText:
                return "是";
            case StringId.XtraMessageBoxNoButtonText:
                return "否";
            case StringId.XtraMessageBoxIgnoreButtonText:
                return "忽略";
            case StringId.XtraMessageBoxAbortButtonText:
                return "中止";
            case StringId.XtraMessageBoxRetryButtonText:
                return "重试";
            default:
                return base.GetLocalizedString(id);
        }
    }
}

// 使用
DevExpress.XtraEditors.Controls.Localizer.Active = new XtraLocalizer();

3. 系统消息汉化

对于 Devexpress 内置提示（如许可证过期），需通过资源文件或全局本地化方案修改，可参考官方文档 Localization Guide。

五、总结：XtraMessageBox 的核心优势

特性	标准 MessageBox	XtraMessageBox
图标定制	仅系统图标	支持 SVG/PNG 自定义图标
按钮样式	固定文本	支持图标、字体、对齐方式调整
文本格式	纯文本	HTML/CSS 格式化文本
国际化支持	有限	完全可定制化（含字体、布局）
交互扩展	无	支持自动关闭、记忆用户选择