# Divider 分割线

`AntdUI.Divider` 用于在页面中区隔内容，可显示水平线、竖线，也可在线中显示标题文字。

## 最小示例

```aardio
import win.ui;
import dotNet.AntdUI;
import System.Windows.Forms;
import System.Drawing;
/*DSG{{*/
var winform = win.form(text="AntdUI Divider";right=520;bottom=220)
winform.add(host={cls="custom";left=0;top=0;right=520;bottom=220;db=1;dl=1;dr=1;dt=1;z=1})
/*}}*/

var panel = AntdUI.StackPanel(winform.host);
panel.Vertical = true;
panel.Gap = 12;
panel.Padding = System.Windows.Forms.Padding(20);

// StackPanel 纵向布局中，ItemSize 表示每一项的高度。
panel.ItemSize = "38";

var title = AntdUI.Label();
title.Text = "用户信息";
title.Size = System.Drawing.Size(120,38);

var div = AntdUI.Divider();
div.Text = "基础资料";
div.Orientation = AntdUI.TOrientation.Left;
div.Thickness = 1;
div.Size = System.Drawing.Size(120,38);

var note = AntdUI.Label();
note.Text = "分割线可以带文字，也可以竖向显示。";
note.Size = System.Drawing.Size(120,38);

// AntdUI 2.4.1 的 StackPanel 会将后添加的控件排在前面。
// 下面按反序添加，使视觉顺序为：标题、分割线、说明文字。
panel.Controls.Add(note);
panel.Controls.Add(div);
panel.Controls.Add(title);

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

## 常用属性

| 属性 | 说明 |
| --- | --- |
| `Text` | 分割线中显示的文字。 |
| `Vertical` | 是否竖向分割线。 |
| `Orientation` | 文字位置，常用 `AntdUI.TOrientation.Left/Right/None`。 |
| `OrientationMargin` | 文字与边缘的距离比例。 |
| `TextPadding` | 文字与线之间的距离。 |
| `Thickness` | 线条厚度。 |
| `ColorSplit` | 线条颜色。 |

## 注意事项

- 只是区隔内容时通常只设置 `Text`、`Orientation`、`Thickness`。
- `Divider` 放入 `StackPanel` 等布局容器时，要确保它在布局主轴上有非零尺寸。纵向 `StackPanel` 中可设置 `panel.ItemSize` 或 `div.Height`，否则无宿主创建的 `Divider` 初始高度为 0，会看不到分割线。
- 如果在少数环境中先添加子控件、后显示窗体时布局没有立即刷新，可在 `winform.show()` 后调用一次 `panel.PerformLayout()`。
- 竖向分割线需要给控件合理宽度；放在布局容器内时要注意父容器的布局方向。