# 静态弹层组件

AntdUI 中很多反馈/弹层不是普通控件，而是静态类方法：`Message`、`Notification`、`Modal`、`Drawer`、`Popover`、`Tooltip`、`Tour`、`Preview`。它们通常通过 `open(...)` 或 `success/info/warn/error(...)` 方法弹出。

## owner：在 aardio 中优先使用 BaseForm

静态弹层需要一个 AntdUI 可识别的所有者窗口。推荐在 aardio 窗口里放一个 `custom` 宿主，然后创建并嵌入 `AntdUI.BaseForm`，再把这个 `baseForm` 传给 `Message.Config`、`Notification.Config`、`Modal.Config`、`Drawer.Config` 等。

```aardio
import win.ui;
import dotNet;
import dotNet.AntdUI;
import System.Windows.Forms;
/*DSG{{*/
var winform = win.form(text="AntdUI 弹层";right=620;bottom=360)
winform.add(
btn={cls="button";text="提示";left=40;top=40;right=180;bottom=76;z=2};
customBase={cls="custom";left=40;top=316;right=337;bottom=344;hide=1;z=1}
)
/*}}*/

// 构造一个 AntdUI / WinForms 所有者窗口（可设为隐藏不显示），供静态弹层定位与挂载。
var baseForm = AntdUI.BaseForm(winform.customBase);

winform.btn.oncommand = function(){
    var cfg = AntdUI.Message.Config(baseForm,"保存成功",AntdUI.TType.Success);
    cfg.AutoClose = 3;
    cfg.Align = AntdUI.TAlignFrom.Top;
    AntdUI.Message.open(cfg);
}

winform.show();
win.loopMessage();
```

> `BaseForm` 本质上是 .NET `System.Windows.Forms.Form`，符合 AntdUI 静态弹层的 owner/target 需求；普通 aardio `win.form` 或窗口句柄不等价于 AntdUI 期望的 WinForms `Form`。

## Message 全局提示

适合短反馈：保存成功、删除失败、加载中。

常用方法：

- `AntdUI.Message.open(config)`：配置对象方式，推荐。
- `AntdUI.Message.success/info/warn/error(...)`：快捷提示。
- `AntdUI.Message.loading(...)`：加载提示，常返回可继续更新状态的对象。
- `close_all()` / `close_id(id)` / `contains(id)`：关闭或查询提示。

常用配置字段：`Target`、`Text`、`Icon`、`AutoClose`、`ClickClose`、`TopMost`、`Align`、`ShowInWindow`、`MaxWidth`。

## Notification 通知提醒

适合更明显的通知卡片，可包含标题、正文、状态图标、关闭按钮与链接操作。

```aardio
var cfg = AntdUI.Notification.Config(baseForm,"任务完成","文件已导出。",AntdUI.TType.Success,AntdUI.TAlignFrom.TR);
cfg.AutoClose = 5;
cfg.ShowInWindow = true;
AntdUI.Notification.open(cfg);
```

常用配置字段：`ID`、`Title`、`Text`、`Icon`、`Align`、`Radius`、`AutoClose`、`ClickClose`、`CloseIcon`、`ShowInWindow`、`EnableSound`、`OnClose`。

## Modal 模态对话框

适合需要用户确认的场景：删除确认、提交前确认、展示复杂内容。

```aardio
var cfg = AntdUI.Modal.Config(baseForm,"删除确认","确定删除这条记录吗？",AntdUI.TType.Warn);
cfg.OkText = "删除";
cfg.CancelText = "取消";
cfg.MaskClosable = false;
var result = AntdUI.Modal.open(cfg);
```

常用配置字段：`Title`、`Content`、`Icon`、`Width`、`Mask`、`MaskClosable`、`CloseIcon`、`Keyboard`、`OkText`、`CancelText`、`OkType`、`OnOk`、`Btns`、`OnBtns`、`Resizable`。

复杂内容可传入 `System.Windows.Forms.Control` 或 `Modal.TextLine[]`。

## Drawer 抽屉

适合从侧边滑出的表单、详情页、设置面板。

```aardio
import System.Windows.Forms;
import System.Drawing;

var panel = System.Windows.Forms.Panel();
panel.Size = System.Drawing.Size(360,240);

var cfg = AntdUI.Drawer.Config(baseForm,panel);
cfg.Align = AntdUI.TAlignMini.Right;
cfg.Padding = 24;
AntdUI.Drawer.open(cfg);
```

常用配置字段：`Form`、`Content`、`Align`、`Padding`、`Mask`、`MaskClosable`、`Dispose`、`OnLoad`、`OnClose`、`DisplayDelay`。

## Popover 气泡卡片

`Popover` 依附在某个 WinForms/AntdUI 控件上，适合显示轻量详情、操作说明或短操作入口。

```aardio
var cfg = AntdUI.Popover.Config(btn,"订单提醒","您有 3 条待处理订单。");
cfg.SetArrow(AntdUI.TAlign.Bottom).SetAutoClose(0).SetPadding(16,12);
AntdUI.Popover.open(cfg);
```

`Content` 可为字符串、WinForms 控件或 `Popover.TextRow[]`。多段文本示例：

```aardio
import dotNet;
import System.Drawing;

var rows = dotNet.createArray(AntdUI.Popover.TextRow,2);
rows.SetValue(AntdUI.Popover.TextRow("查看"),0);
rows.SetValue(AntdUI.Popover.TextRow("详情",2,0xFF0000FF),1);
AntdUI.Popover.open(btn,rows,AntdUI.TAlign.BL);
```

常见注意点：目标必须是 WinForms/AntdUI 控件，普通 aardio 按钮不能直接作为 Popover 目标。

## Tooltip 文字提示

`Tooltip` 用于非常短的解释性文字，可直接打开，也可用配置对象控制宽度、圆角、箭头和颜色。

```aardio
var cfg = AntdUI.Tooltip.Config(btn,"这是一个文字提示");
cfg.SetArrow(AntdUI.TAlign.Top).SetRadius(8).SetCustomWidth(180);
AntdUI.Tooltip.open(cfg);
```

如果需要标题、复杂内容或可点击内容，请改用 `Popover`。

## Preview / ImagePreview 图片预览

- `Preview` 是静态图片预览弹层，调用 `AntdUI.Preview.open(cfg)` 打开。
- `ImagePreview` 是普通控件，嵌入在窗体指定区域内持续显示图片集合。

```aardio
import System.Drawing;

var image = System.Drawing.Bitmap(160,90);
var cfg = AntdUI.Preview.Config(baseForm,image);
cfg.SetFit(AntdUI.TFit.Contain).SetKeyboard(true);
AntdUI.Preview.open(cfg);
```

`Preview.Config` 的 owner 是 WinForms `Form`，在 aardio 中仍建议使用 `AntdUI.BaseForm`。

## Tour 漫游式引导

Tour 用于分步骤引导用户认识界面。每一步由 `StepCall` 回调决定要高亮的控件或区域。

```aardio
var cfg = AntdUI.Tour.Config(baseForm,function(result){
    if(result.Index == 0){
        result.Set(btn);
    }
    else {
        result.Close();
    }
});
cfg.SetScale(1.08).SetMaskClosable(true).SetClickNext(true);
AntdUI.Tour.open(cfg);
```

常见注意点：`baseForm` 必须是 WinForms `Form`，`result.Set(control)` 的 control 也必须是 WinForms/AntdUI 控件。

## 通用建议

1. **优先配置对象**：字段名比长参数列表更稳定，也更适合 aardio 调用。
2. **绑定 BaseForm**：在 aardio 中用嵌入的 `AntdUI.BaseForm` 作为 owner。
3. **避免跨线程直接操作 UI**：工作线程完成后，把结果切回 UI 线程再弹提示。
4. **长耗时任务用 loading**：完成后调用返回对象的 `OK/Error/Warn/Info` 或关闭方法。
5. **版本差异用反射确认**：若示例参数不匹配，使用 aardio 反射脚本查看当前 DLL 的方法签名。