# HyperlinkLabel 超链接文本

`AntdUI.HyperlinkLabel` 可以在普通文本中嵌入 HTML 风格的 `<a href=...>链接</a>`，点击链接时触发事件或自动用默认浏览器打开。

## 最小示例

```aardio
import win.ui;
import dotNet.AntdUI;
import System.Windows.Forms;
import System.Drawing;

var winform = win.form(text="AntdUI HyperlinkLabel";right=620;bottom=220);
winform.add(
    host={cls="custom";left=20;top=20;right=600;bottom=180;dl=1;dt=1;dr=1;db=1;z=1}
);

var link = AntdUI.HyperlinkLabel(winform.host);
link.Dock = System.Windows.Forms.DockStyle.Fill;
link.Text = "访问 <a href=https://www.aardio.com>aardio 官网</a>，或查看 <a href=docs>本地文档</a>。";
link.TextAlign = System.Drawing.ContentAlignment.MiddleCenter;
link.LinkAutoNavigation = false;

link.LinkClicked = function(sender,e){
    winform.msgbox("点击链接：" + e.Text + "\r\nHref：" + e.Href);
}

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

## 链接文本格式

```aardio
link.Text = "这是一个 <a href=help>帮助链接</a>";
link.Text = "多个链接：<a href=one>链接1</a> 和 <a href=two>链接2</a>";
```

## 常用属性

| 属性 | 说明 |
| --- | --- |
| `Text` | 文本，可包含 `<a href=...>...</a>`。 |
| `TextAlign` | 文本对齐方式。 |
| `ForeColor` | 普通文本颜色。 |
| `NormalStyle` | 链接常规状态样式。 |
| `HoverStyle` | 链接悬停状态样式。 |
| `LinkPadding` | 链接与周围文本的间距。 |
| `LinkAutoNavigation` | 是否自动用默认浏览器打开 href。 |
| `Badge` / `BadgeAlign` | 角标文本与位置。 |

## 自定义链接样式

```aardio
var style = AntdUI.HyperlinkLabel.LinkAppearance();
style.LinkColor = 0xFF1677FF;
style.UnderlineThickness = 1;
link.NormalStyle = style;
```

## 事件

`LinkClicked` 是最常用事件，事件参数通常包含 `Text` 与 `Href`。

```aardio
link.LinkClicked = function(sender,e){
    winform.msgbox("Text=" + e.Text + "\r\nHref=" + e.Href);
}
```

## 注意事项

- `<a>` 标签用于富文本链接，不是完整 HTML 渲染器。
- 如果 `LinkAutoNavigation = true`，href 会尝试交给默认浏览器处理；内部业务动作建议设为 `false`，在 `LinkClicked` 中自行分发。