Avatar 头像

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

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 事件。

Markdown 格式