aardio 文档

Label 文本

AntdUI.Label 是 AntdUI 的自绘文本控件,相比普通 WinForms Label,提供更好的主题样式、阴影、图标、自动省略、多行等能力。

最小示例

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

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

var label = AntdUI.Label(winform.host);
label.Dock = System.Windows.Forms.DockStyle.Fill;
label.Text = "这是一段 AntdUI.Label 文本,支持多行、自动省略、颜色与图标等常用样式。";
label.TextAlign = System.Drawing.ContentAlignment.MiddleCenter;
label.TextMultiLine = true;
label.AutoEllipsis = true;
label.ForeColor = 0xFF1677FF;

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

常用属性

属性 说明
Text 显示文本。
ForeColor 文字颜色;aardio 中直接使用 0xAARRGGBB 数值。
ColorExtend 文字渐变色字符串,高级样式可参考上游源码/示例。
TextAlign 文本对齐,使用 System.Drawing.ContentAlignment
AutoEllipsis 文本超出时自动省略。
TextMultiLine 是否允许多行。
Icon / IconSvg 图标或 SVG 图标。
IconRatio / IconGap 图标比例与图文间距。
Shadow / ShadowColor 文本阴影。

单行省略

label.Text = "很长很长的标题文本……";
label.TextMultiLine = false;
label.AutoEllipsis = true;
label.TextAlign = System.Drawing.ContentAlignment.MiddleLeft;

常见坑

Markdown 格式