KryptonLabel ✓ LCode 已集成 Toolkit
命名空间:Krypton.Toolkit · 程序集:Krypton.Toolkit.dll
简介
KryptonLabel 是增强型标签控件,替代标准 System.Windows.Forms.Label。它跟随 Krypton 主题渲染文字颜色与字体,支持通过 LabelStyle 切换标题、面板标题、粗体等不同风格,并可通过状态对象精细自定义正常 / 禁用 / 悬停时的外观。常用于表单字段标题、分组说明、状态提示等。
常用属性
| 属性 | 类型 | 说明 |
|---|---|---|
Values.Text | string | 标签显示的文字 |
Values.Image | Image | 文字旁的图标 |
Values.ExtraText | string | 副标题文字(显示在主文字下方) |
LabelStyle | LabelStyle | 标签风格(Normal / TitleControl / TitlePanel / Bold / Italic 等) |
StateCommon.ShortText.Font | Font | 所有状态下文字的字体 |
StateCommon.ShortText.Color1 | Color | 文字颜色 |
StateDisabled.ShortText.Color1 | Color | 禁用状态文字颜色 |
AutoSizeMode | AutoSizeMode | 自动大小模式 |
AutoSize | bool | 是否根据内容自动调整大小 |
TextAlign | ContentAlignment | 文字对齐方式 |
快速上手
基本用法(表单字段标题)
using Krypton.Toolkit;
// 创建标签
var lblName = new KryptonLabel();
lblName.Values.Text = "用户名:";
lblName.Location = new Point(20, 24);
lblName.AutoSize = true;
// 配套文本框
var txtName = new KryptonTextBox();
txtName.Location = new Point(100, 20);
txtName.Size = new Size(200, 25);
this.Controls.Add(lblName);
this.Controls.Add(txtName);
使用 LabelStyle 创建标题
// 面板大标题
var lblTitle = new KryptonLabel();
lblTitle.Values.Text = "账户设置";
lblTitle.LabelStyle = LabelStyle.TitlePanel;
lblTitle.Location = new Point(20, 10);
// 控件小标题
var lblSub = new KryptonLabel();
lblSub.Values.Text = "基本信息";
lblSub.LabelStyle = LabelStyle.TitleControl;
lblSub.Location = new Point(20, 50);
进阶用法
自定义文字颜色与字体
// 创建醒目的提示标签(翡翠绿主题)
var lblTip = new KryptonLabel();
lblTip.Values.Text = "提示:保存后配置立即生效";
lblTip.StateCommon.ShortText.Font = new Font("Microsoft YaHei UI", 9f);
lblTip.StateCommon.ShortText.Color1 = Color.FromArgb(15, 118, 110);
lblTip.Location = new Point(20, 200);
带图标的状态标签
// 显示连接状态
var lblStatus = new KryptonLabel();
lblStatus.Values.Image = Properties.Resources.icon_online;
lblStatus.Values.Text = "已连接";
lblStatus.AutoSize = true;
// 状态切换时同步更新图标和颜色
void SetStatus(bool online)
{
lblStatus.Values.Image = online
? Properties.Resources.icon_online
: Properties.Resources.icon_offline;
lblStatus.Values.Text = online ? "已连接" : "已断开";
lblStatus.StateCommon.ShortText.Color1 = online
? Color.FromArgb(22, 163, 74)
: Color.FromArgb(220, 38, 38);
}
提示:若需要文字自动换行,请使用
KryptonWrapLabel;若需要可点击的链接文字,请使用 KryptonLinkLabel。KryptonLabel 本身不支持自动换行和点击交互。
对应示例项目
📁 Source/Krypton Toolkit Examples/KryptonLabel Examples/
包含:各种 LabelStyle 对比、带图标标签、自定义颜色字体演示。