# Avatar 头像

`Avatar` 用于展示用户、组织或对象的头像，支持文字、图片、SVG、圆形头像、边框、阴影与悬浮状态。

```aardio
import win.ui;
var winform = win.form(text="AntdUI Avatar";right=520;bottom=260)
winform.add(host={cls="custom";left=20;top=20;right=490;bottom=220;z=1})

import dotNet.AntdUI;
import System.Drawing;

var avatar = AntdUI.Avatar(winform.host);
avatar.Text = "A";
avatar.Round = true;
avatar.BackColor = 0xFF167AD8;
avatar.BorderWidth = 2;
avatar.BorderColor = 0xFFFFFFFF;
avatar.EnableHover = true;
avatar.HoverBack = 0xFF409EFF;
avatar.Dock = System.Windows.Forms.DockStyle.Left;

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

## 常用属性

- `Text`：无图片时显示的文字，常用于姓名首字母或简称。当前版本可能只显示首个字符，多字符简称建议先实际确认效果。
- `Image` / `ImageSvg`：头像图片或 SVG。
- `ImageFit`：图片填充方式，常见 `AntdUI.TFit.Cover`、`Contain`。
- `Round` / `Radius`：圆形头像或自定义圆角。
- `BackColor`：文字头像背景色。
- `BorderWidth` / `BorderColor`：边框。
- `Shadow` / `ShadowColor` / `ShadowOpacity`：阴影。
- `Loading` / `LoadingProgress`：加载状态与进度。
- `EnableHover` / `HoverBack` / `HoverImageSvg`：启用悬浮反馈。

## 常用方法

- `SetImage(image, id)` / `SetImage(id, image)`：设置图片并绑定标识。参数为 .NET `System.Drawing.Image`。

## 注意

- 如果只显示文字，建议设置 `BackColor` 与 `Round=true`。
- 图片文件可用 `System.Drawing.Image.FromFile(path)` 读取，记得实际项目中注意文件占用与释放。
- 需要点击事件时可直接使用 WinForms 常规 `Click` 事件。