KryptonSeparator ✓ LCode 已集成 Toolkit
命名空间:Krypton.Toolkit · 程序集:Krypton.Toolkit.dll
简介
KryptonSeparator 是增强型分隔线控件,用于在界面中创建视觉分隔区域。它自动跟随 Krypton 主题渲染,支持水平和垂直方向,可自定义线条样式、颜色和间距,比标准 Panel 或 Label 模拟的分隔线更美观、更易维护。
常用属性
| 属性 | 类型 | 说明 |
|---|---|---|
Orientation | Orientation | 分隔线方向:Horizontal 或 Vertical |
SeparatorStyle | SeparatorStyle | 分隔线视觉风格(LowProfile / HighProfile / Custom1~3) |
StateCommon.Back.Color1 | Color | 分隔线主颜色 |
StateCommon.Back.Color2 | Color | 分隔线渐变次颜色 |
StateCommon.Border.Color1 | Color | 分隔线边框颜色 |
StateDisabled.Back.Color1 | Color | 禁用状态颜色 |
StateNormal.Back.Color1 | Color | 正常状态颜色 |
Size | Size | 控件尺寸(水平时高度决定线粗,垂直时宽度决定线粗) |
Dock | DockStyle | 停靠方式(常用于 DockStyle.Top 或 Left) |
Margin | Padding | 外边距,控制分隔线与周围控件的间距 |
快速上手
水平分隔线
using Krypton.Toolkit;
// 创建水平分隔线
var separator = new KryptonSeparator();
separator.Orientation = Orientation.Horizontal;
separator.Dock = DockStyle.Top;
separator.Height = 2;
separator.Margin = new Padding(10, 5, 10, 5);
this.Controls.Add(separator);
垂直分隔线
var vSeparator = new KryptonSeparator();
vSeparator.Orientation = Orientation.Vertical;
vSeparator.Dock = DockStyle.Left;
vSeparator.Width = 2;
vSeparator.Margin = new Padding(5, 10, 5, 10);
this.Controls.Add(vSeparator);
进阶用法
表单分组分隔
// 在表单中分隔「基本信息」和「高级设置」区域
var lblBasic = new KryptonLabel();
lblBasic.Values.Text = "基本信息";
lblBasic.Dock = DockStyle.Top;
var sep1 = new KryptonSeparator();
sep1.Dock = DockStyle.Top;
sep1.Height = 2;
sep1.SeparatorStyle = SeparatorStyle.LowProfile;
var lblAdvanced = new KryptonLabel();
lblAdvanced.Values.Text = "高级设置";
lblAdvanced.Dock = DockStyle.Top;
// 注意 Dock 添加顺序(后添加的先显示)
this.Controls.Add(lblAdvanced);
this.Controls.Add(sep1);
this.Controls.Add(lblBasic);
自定义分隔线颜色
// 使用主题色(翡翠绿)作为分隔线
var sep = new KryptonSeparator();
sep.Dock = DockStyle.Top;
sep.Height = 3;
sep.StateCommon.Back.Color1 = Color.FromArgb(15, 118, 110);
sep.StateCommon.Back.Color2 = Color.FromArgb(45, 212, 191);
this.Controls.Add(sep);
提示:KryptonSeparator 通常配合
Dock 属性使用。水平分隔线设置 DockStyle.Top,垂直分隔线设置 DockStyle.Left,可自动适应父容器宽度/高度。
对应示例项目
📁 Source/Krypton Toolkit Examples/KryptonSeparator Examples/
包含:水平/垂直分隔线、各种 SeparatorStyle 对比、自定义颜色演示。