简介

KryptonSeparator 是增强型分隔线控件,用于在界面中创建视觉分隔区域。它自动跟随 Krypton 主题渲染,支持水平和垂直方向,可自定义线条样式、颜色和间距,比标准 Panel 或 Label 模拟的分隔线更美观、更易维护。

KryptonSeparator 示例截图
KryptonSeparator 水平与垂直分隔效果

常用属性

属性类型说明
OrientationOrientation分隔线方向:Horizontal 或 Vertical
SeparatorStyleSeparatorStyle分隔线视觉风格(LowProfile / HighProfile / Custom1~3)
StateCommon.Back.Color1Color分隔线主颜色
StateCommon.Back.Color2Color分隔线渐变次颜色
StateCommon.Border.Color1Color分隔线边框颜色
StateDisabled.Back.Color1Color禁用状态颜色
StateNormal.Back.Color1Color正常状态颜色
SizeSize控件尺寸(水平时高度决定线粗,垂直时宽度决定线粗)
DockDockStyle停靠方式(常用于 DockStyle.Top 或 Left)
MarginPadding外边距,控制分隔线与周围控件的间距

快速上手

水平分隔线

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 对比、自定义颜色演示。

相关控件