KryptonNavigator ✓ LCode 已集成 Navigator

简介

KryptonNavigator 是一个功能强大的导航容器控件，用于在多个页面（KryptonPage）之间切换。它支持多种显示模式，包括选项卡（Tab）、Outlook 风格、堆叠按钮（Stack）、HeaderGroup 等，可满足不同 UI 布局需求。每个页面可包含独立的控件集合，用户通过点击标签、按钮或列表项来切换当前显示的页面。

常用属性

NavigatorMode 模式一览

快速上手

基本用法（代码创建）

using Krypton.Navigator;

// 创建导航器
var navigator = new KryptonNavigator();
navigator.Dock = DockStyle.Fill;
navigator.NavigatorMode = NavigatorMode.BarTabGroup;

// 创建页面
var page1 = new KryptonPage("页面一", "第一个页面的标题", "描述文字");
page1.TextTitle = "欢迎";
page1.TextDescription = "这是第一个导航页面";

var page2 = new KryptonPage("页面二", "第二个页面的标题", "描述文字");

// 向页面添加控件
var label = new KryptonLabel();
label.Text = "Hello Navigator!";
page1.Controls.Add(label);

// 添加页面到导航器
navigator.Pages.AddRange(new KryptonPage[] { page1, page2 });

this.Controls.Add(navigator);

切换模式

// 切换为 Outlook 风格
navigator.NavigatorMode = NavigatorMode.OutlookFull;

// 切换为堆叠按钮
navigator.NavigatorMode = NavigatorMode.StackCheckButtonGroup;
navigator.Stack.Orientation = VisualOrientation.Left;

// 切换为 HeaderGroup
navigator.NavigatorMode = NavigatorMode.HeaderGroup;

响应页面切换事件

navigator.SelectedPageChanged += (s, e) =>
{
    var page = navigator.SelectedPage;
    if (page != null)
    {
        statusLabel.Text = "当前页面：" + page.Text;
    }
};

进阶用法

动态添加/移除页面

// 动态添加
var newPage = new KryptonPage("新页面", "动态添加", "");
navigator.Pages.Add(newPage);

// 移除指定页面
navigator.Pages.Remove(page2);

// 移除当前选中页面
if (navigator.SelectedPage != null)
    navigator.Pages.Remove(navigator.SelectedPage);

自定义选项卡外观

// 设置选项卡方向为左侧
navigator.Bar.Orientation = VisualOrientation.Left;

// 允许多行标签
navigator.Bar.BarMultiline = BarMultiline.MultiLine;

// 设置按钮显示内容（图标+文字）
navigator.Button.ButtonDisplay = ButtonDisplay.Logic;

// 显示关闭按钮
navigator.Button.CloseButtonDisplay = ButtonDisplay.ShowEnabled;

Outlook 模式配置

navigator.NavigatorMode = NavigatorMode.OutlookFull;

// 设置溢出按钮数量（底部小按钮）
navigator.Outlook.OverflowSize = 3;

// 设置大按钮的最小高度
navigator.Outlook.MiniButtonSize = new Size(0, 24);

对应示例项目

📁 Source/Krypton Navigator Examples/

包含多个子项目：

• Navigator Modes — 演示所有 NavigatorMode 的切换效果
• Navigator Playground — 交互式调整各属性
• Navigator Palettes — 不同调色板下的外观对比
• Navigator PerPageButtons — 每页独立按钮配置
• Navigator ToolTips — 工具提示配置
• Navigator Adorned Buttons — 装饰按钮示例
• Navigator Basic — 最简用法入门

相关控件