# Panel 面板

`Panel` 是 AntdUI 风格容器控件，适合承载其他控件，并提供圆角、阴影、边框、背景、箭头等视觉能力。

```aardio
import win.ui;
var winform = win.form(text="AntdUI Panel";right=620;bottom=360)
winform.add(host={cls="custom";left=20;top=20;right=590;bottom=320;z=1})

import dotNet.AntdUI;
import System.Drawing;
import System.Windows.Forms;

var panel = AntdUI.Panel(winform.host);
panel.Radius = 10;
panel.Shadow = 8;
panel.BorderWidth = 1;
panel.BorderColor = 0xFFE0E0E0;
panel.InnerPadding = System.Windows.Forms.Padding(16);
panel.Dock = System.Windows.Forms.DockStyle.Fill;

var btn = AntdUI.Button();
btn.Text = "面板内按钮";
btn.Type = AntdUI.TTypeMini.Primary;
btn.Dock = System.Windows.Forms.DockStyle.Top;
panel.Controls.Add(btn);

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

## 常用属性

- `Controls`：子控件集合。
- `Radius` / `RadiusAlign`：圆角与圆角方向。
- `padding` / `InnerPadding`：外层/内层边距。
- `Back` / `BackExtend`：背景色与渐变背景。
- `BackgroundImage` / `BackgroundImageLayout`：背景图。
- `BorderWidth` / `BorderColor` / `BorderStyle`：边框。
- `Shadow` / `ShadowColor` / `ShadowOpacity` / `ShadowAlign`：阴影。
- `AutoScroll`：启用滚动。
- `ArrowSize` / `ArrowAlign`：箭头样式，做气泡卡片时可用。

## 常用方法

- `Add(control)`：添加 WinForms/AntdUI 子控件。
- `ScrollControlIntoView(control)`：滚动到指定子控件。

## 注意

- 在 `Panel` 内添加控件时，推荐使用 `Dock`、`Anchor` 或明确坐标尺寸。
- 如果只需要 aardio 自绘背景，原生 `plus/bkplus` 也可能更轻量；需要 AntdUI 风格容器时再用本控件。