Codex
47 lines
1.8 KiB
C++
47 lines
1.8 KiB
C++
/*******************************************************************************
|
|
* @类: MessageBox
|
|
* @摘要: 消息框工厂类，提供简化的对话框创建接口
|
|
* @描述:
|
|
* 封装对话框的创建和显示逻辑，提供静态方法供快速调用。
|
|
* 支持模态阻塞和非模态回调两种使用方式。
|
|
*
|
|
* @特性:
|
|
* - 静态方法调用，无需实例化
|
|
* - 自动处理模态和非模态的逻辑差异
|
|
* - 集成到窗口的对话框管理系统中
|
|
* - 提供去重机制防止重复对话框
|
|
*
|
|
* @使用场景: 快速创建标准消息框，减少样板代码
|
|
* @所属框架: 星垣(StellarX) GUI框架
|
|
* @作者: 我在人间做废物
|
|
******************************************************************************/
|
|
#pragma once
|
|
#include <string>
|
|
#include <functional>
|
|
#include "CoreTypes.h"
|
|
#include "Dialog.h"
|
|
#include "Window.h"
|
|
|
|
namespace StellarX
|
|
{
|
|
class MessageBox
|
|
{
|
|
public:
|
|
// 模态：直接创建并显示对话框，阻塞到用户关闭后返回结果。
|
|
// 调用期间会运行 Dialog 自己的模态事件循环。
|
|
static MessageBoxResult showModal(Window& wnd,
|
|
const std::string& text,
|
|
const std::string& caption = "提示",
|
|
MessageBoxType type = MessageBoxType::OK);
|
|
|
|
// 非模态：创建后立即返回，由 Window 托管生命周期和绘制层级。
|
|
// 若同一窗口中已存在相同 caption/text 的可见非模态对话框，则不会重复创建。
|
|
// 用户关闭时通过 onResult 异步返回结果；回调允许排队修改宿主控件树。
|
|
static void showAsync(Window& wnd,
|
|
const std::string& text,
|
|
const std::string& caption = "提示",
|
|
MessageBoxType type = MessageBoxType::OK,
|
|
std::function<void(MessageBoxResult)> onResult = nullptr);
|
|
};
|
|
} // namespace StellarX
|