MessageBoxEx 使用文档

概述

MessageBoxEx 是一个非模态悬浮消息提示控件。支持四种消息类型（成功、信息、警告、错误），七种显示位置，自动关闭和淡入淡出动画效果。

特性

• 非模态显示：不影响用户操作其他界面
• 四种消息类型：成功(绿色)、信息(蓝色)、警告(橙色)、错误(红色)
• 七种显示位置：顶部左/中/右、居中、底部左/中/右
• 自动关闭：默认3秒自动关闭，支持自定义延迟或永久显示
• 淡入淡出动画：优雅的显示和关闭动画效果
• 多消息堆叠：同一位置的消息自动排列，不重叠
• 点击关闭：点击消息窗口即可手动关闭
• 异步支持：提供异步方法，防止线程阻塞
• 资源优化：完善的资源释放机制，防止内存泄漏
• 显示位置控制：支持相对于父容器或屏幕显示
• 声音提示：可选启用声音提示
• 最大宽度限制：支持设置消息框最大宽度

快速开始

基本用法

// 显示成功消息
MessageBoxEx.ShowSuccess(this, "操作成功！");

// 显示信息消息
MessageBoxEx.ShowInfo(this, "这是一条信息提示");

// 显示警告消息
MessageBoxEx.ShowWarning(this, "请注意警告信息");

// 显示错误消息
MessageBoxEx.ShowError(this, "操作失败！");

指定位置和自动关闭时间

// 在右上角显示，5秒后自动关闭
MessageBoxEx.ShowInfo(this, "右上角消息", MessageBoxExPosition.TopRight, 5);

// 在底部居中显示，不自动关闭（autoCloseDelay = 0）
MessageBoxEx.ShowWarning(this, "需要手动关闭的消息", MessageBoxExPosition.BottomCenter, 0);

API 参考

消息类型枚举

public enum MessageBoxExType
{
    Success,  // 成功 - 绿色
    Info,     // 信息 - 蓝色
    Warning,  // 警告 - 橙色
    Error     // 错误 - 红色
}