KryptonTrackBar ✓ LCode 已集成 Toolkit
命名空间:Krypton.Toolkit · 程序集:Krypton.Toolkit.dll
简介
KryptonTrackBar 是增强型滑动条控件,替代标准 System.Windows.Forms.TrackBar。它自动跟随 Krypton 主题渲染,支持水平和垂直方向、自定义刻度频率、滑块大小调整,以及丰富的状态外观自定义(Normal / Tracking / Pressed / Disabled)。
常用属性
| 属性 | 类型 | 说明 |
|---|---|---|
Value | int | 当前滑块位置值 |
Minimum | int | 滑动条最小值 |
Maximum | int | 滑动条最大值 |
SmallChange | int | 方向键单次步进值 |
LargeChange | int | 点击轨道或 PageUp/Down 的步进值 |
TickFrequency | int | 刻度线间隔(0 表示不显示刻度) |
Orientation | Orientation | 方向:Horizontal 或 Vertical |
TickStyle | TickStyle | 刻度位置(TopLeft / BottomRight / Both / None) |
TrackSize | Size | 轨道的宽度和高度 |
StateCommon.Track.Color1 | Color | 轨道背景色 |
StateCommon.Position.Color1 | Color | 滑块颜色 |
StateTracking.Position.Color1 | Color | 鼠标悬停时滑块颜色 |
快速上手
基本用法
using Krypton.Toolkit;
// 创建滑动条
var trackBar = new KryptonTrackBar();
trackBar.Minimum = 0;
trackBar.Maximum = 100;
trackBar.Value = 50;
trackBar.TickFrequency = 10;
trackBar.Location = new Point(20, 20);
trackBar.Size = new Size(300, 45);
// 值变化事件
trackBar.ValueChanged += (s, e) =>
{
lblValue.Text = $"当前值:{trackBar.Value}";
};
this.Controls.Add(trackBar);
垂直方向滑动条
var vTrackBar = new KryptonTrackBar();
vTrackBar.Orientation = Orientation.Vertical;
vTrackBar.Minimum = 0;
vTrackBar.Maximum = 255;
vTrackBar.Value = 128;
vTrackBar.TickFrequency = 25;
vTrackBar.Size = new Size(45, 200);
vTrackBar.Location = new Point(350, 20);
this.Controls.Add(vTrackBar);
进阶用法
音量控制器(带实时反馈)
// 模拟音量调节
var volumeBar = new KryptonTrackBar();
volumeBar.Minimum = 0;
volumeBar.Maximum = 100;
volumeBar.Value = 70;
volumeBar.SmallChange = 1;
volumeBar.LargeChange = 10;
volumeBar.TickFrequency = 5;
volumeBar.TickStyle = TickStyle.BottomRight;
volumeBar.ValueChanged += (s, e) =>
{
// 更新音量图标和进度标签
lblVolume.Text = $"🔊 {volumeBar.Value}%";
progressBar.Value = volumeBar.Value;
};
this.Controls.Add(volumeBar);
自定义滑块外观
// 自定义轨道和滑块颜色
trackBar.StateCommon.Track.Color1 = Color.FromArgb(230, 230, 230);
trackBar.StateCommon.Track.Color2 = Color.FromArgb(200, 200, 200);
trackBar.StateCommon.Position.Color1 = Color.FromArgb(15, 118, 110); // 翡翠绿
trackBar.StateCommon.Position.Color2 = Color.FromArgb(13, 148, 136);
// 悬停时高亮
trackBar.StateTracking.Position.Color1 = Color.FromArgb(20, 184, 166);
trackBar.StateTracking.Position.Color2 = Color.FromArgb(45, 212, 191);
// 按下时加深
trackBar.StatePressed.Position.Color1 = Color.FromArgb(17, 94, 89);
提示:在 LCode 设计器中,从工具箱「LCode Components」分类拖放 KryptonTrackBar 即可。属性面板中可设置
Orientation 切换水平/垂直方向。
对应示例项目
📁 Source/Krypton Toolkit Examples/KryptonTrackBar Examples/
包含:水平/垂直滑动条、刻度样式对比、自定义外观演示。