sgcNavigation 功能矩阵
按任务分类的 sgcNavigation 全部功能，每项功能都链接到对应的帮助主题。
按任务分类的 sgcNavigation 全部功能，每项功能都链接到对应的帮助主题。
| 功能 | 详情 | 社区版 | 帮助 |
|---|---|---|---|
| 树模式 | Mode := nbmTree 把导航栏变成多级树：每个条目的 Depth 决定层级，每一级都有缩进且可以折叠，并提供 ExpandAll、CollapseAll 和 ItemPath。 | 帮助 | |
| 搜索 | Filter 显示匹配项及其祖先，FilterMode 可选 nfmContains 或 nfmFuzzy，ShowSearch 绘制搜索行。匹配的字符会高亮。 | 帮助 | |
| 选项卡 | 适用于 FireMonkey、VCL、WinForms、WPF 和 Avalonia 的选项卡条：图标、关闭按钮、已修改圆点、TabSizing、新建选项卡和列表按钮、滚动、Ctrl+Tab，以及每个选项卡一个作为其页面的 Control。 | 帮助 | |
| 选项卡重新排序、固定选项卡与分离 | 拖动重新排序、Pinned 选项卡、用于在自己窗口中打开选项卡的 OnTabTearOff，以及用于布局的 SaveLayout 和 LoadLayout。 | 注册版 | 帮助 |
| 选项卡窗体 | TsgcVCLNavigationTabbedForm、TsgcFMXNavigationTabbedForm 以及 WinForms、WPF 和 Avalonia 的选项卡窗体，会把选项卡条（在 Delphi 中也可以是 notebook 的选项卡条）移到带主题的标题栏中，标题栏包含窗口图标和标题按钮。阴影、调整大小的边框和 Windows 11 贴靠布局都会保留，空白的选项卡条可以拖动窗口。分离到新窗口，以及放到另一个窗口的标题栏上，属于注册版。 | 帮助 | |
| 面包屑导航 | 带箭头并可列出子项的分段、溢出按钮，以及跟随所选条目的 NavigationBar 绑定，或自行设置的 Path。 | 帮助 | |
| 面包屑导航编辑模式 | 点击空白区域、按 F4 或 Ctrl+L 即可编辑完整路径，并通过 OnPathEdit 接受或拒绝。 | 注册版 | 帮助 |
| 命令面板 | Ctrl+Shift+P 打开面板，按模糊匹配对每个命令排序，并提供最近使用的命令、类别、路径和快捷键。 | 注册版 | 帮助 |
| 命令源 | IsgcUICommandSource 为面板列出命令：导航栏、功能区和工具栏（Delphi）、操作列表以及您自己的命令源。.NET 中使用 ICommand。 | 帮助 |
| 功能 | 详情 | 社区版 | 帮助 |
|---|---|---|---|
| 停靠与停靠引导 | TsgcVCLDockManager、TsgcFMXDockManager 以及 WinForms、WPF 和 Avalonia 的停靠管理器，把工具面板停靠在窗体的四个边上，可以嵌套拆分并带有拆分器，也可以放进选项卡组。拖动标题栏或选项卡时会显示罗盘、边缘引导和预览矩形。 | 注册版 | 帮助 |
| 自动隐藏 | 固定按钮把一个组移到窗体侧边的栏上，悬停或单击会让面板在内容之上滑出。SetAutoHide 和 AutoHideDelay。 | 注册版 | 帮助 |
| 浮动窗口 | 拖离停靠引导放下的面板会浮动在自己的窗口中，更多面板可以停靠进浮动窗口。FloatPanel、AllowFloating 和 CanFloat。适用于 VCL、WinForms、WPF、Avalonia 桌面应用程序，以及 Windows 和 macOS 上的 FireMonkey。 | 注册版 | 帮助 |
| 文档区 | 中央是带导航选项卡的文档组：重新排序、固定和已修改的文档、并排或上下堆叠的组、分离、最大化和 OnNewDocument。 | 注册版 | 帮助 |
| 布局持久化 | SaveLayout 和 LoadLayout 把整个排列写成并读取为 JSON，该文本在 Delphi 和 .NET 中相同，OnRestorePanel 用于在运行时创建的面板。 | 注册版 | 帮助 |
| 功能 | 详情 | 社区版 | 帮助 |
|---|---|---|---|
| 通知模型 | TsgcNotificationModel 保存用户的通知及其标题、正文、严重程度、分组、时间和已读状态，统计未读数，可将其标为已读、关闭，并保存为 JSON。一个模型可同时为 VCL 和 FireMonkey 视图供数，sgcToolbar 的 TsgcToolbarBadgeLink 在工具栏按钮上显示它的未读数。 | 帮助 | |
| 弹出通知管理器 | TsgcVCLToastManager 和 TsgcFMXToastManager 为 Model 的每条新未读通知显示一条弹出通知：严重程度图标、标题、最多三行的正文和最多两个操作按钮。弹出通知会堆叠、倒计时、在鼠标指针悬停时暂停，放不下时排队等待，Show 则弹出独立的弹出通知，例如“已保存”。 | 帮助 | |
| 通知收件箱 | TsgcVCLNotificationInbox 和 TsgcFMXNotificationInbox 按最新在前的顺序，在“今天”“昨天”和日期标题下列出通知，带有“全部”和“未读”选项卡、“全部标为已读”按钮以及每行一个关闭按钮。Filter、GroupFilter 和 Severities 可缩小列表范围。 | 帮助 | |
| 通知偏好设置和编辑器 | TsgcNotificationPreferences 保存用户为每个类别选择的渠道（应用内、弹出、电子邮件和推送），TsgcVCLNotificationPrefsEditor 和 TsgcFMXNotificationPrefsEditor 则为每个类别显示一行、为每个渠道显示一个复选框。关闭了弹出渠道的类别不显示弹出通知，收件箱仍会列出它。 | 帮助 | |
| 实时通知 | 服务器每次变化发送一条 JSON 消息（add、update、remove、read、unread、snapshot），通过 ApplyMessage 使通知保持最新，也可以无需代码，使用 sgcUICoreWS 桥接的 WebSocket、MQTT 和 SSE 实时数据源，它们需要 sgcWebSockets。弹出通知、收件箱和徽标都跟随该模型。 | 注册版 | 帮助 |
| 功能 | 详情 | 社区版 | 帮助 |
|---|---|---|---|
| 键盘导航 | 方向键、Home、End 和 Enter 可移动和选择，并带有焦点行。 | 帮助 | |
| 主题 | 浅色和深色主题（utLight、utDark）和 AccentColor，与其他 sgcUI 产品共享。 | 帮助 | |
| 无界面渲染 | sgcNavigationSaveToPNG 和 sgcNavigationSaveToSVG 无需窗口即可将导航栏渲染为 PNG 或 SVG，在 Linux64 上同样可用。 | 帮助 | |
| 从右到左（阿拉伯语和希伯来语） | 图标与标题的顺序、缩进、展开箭头、徽章和折叠按钮已镜像，标题从右向左阅读。 | 帮助 | |
| 无障碍 | 项目和分组作为树向 UI Automation 公开，包括所选项目和每个分组的展开状态。Up、Down、Home 和 End 在行之间移动，Enter 或 Space 激活一行，Left 和 Right 折叠和展开分组，焦点环始终可见，并遵循 Windows 高对比度。默认开启，可用于 VCL（Delphi 7 到 13）、Windows 上的 FireMonkey、WinForms、WPF 和 Avalonia。 | 帮助 |
.NET 导航栏是模型类型相同的 C# 移植版本，适用于 WinForms、WPF 和 Avalonia。条目通过代码添加。
| 包 | 版本 | 内容 |
|---|---|---|
esegece.sgcNavigation.Community | 社区版（免费） | 核心库 |
esegece.sgcNavigation.WinForms.Community | 社区版（免费） | Windows Forms 控件 |
esegece.sgcNavigation.Wpf.Community | 社区版（免费） | WPF 控件 |
esegece.sgcNavigation.Avalonia.Community | 社区版（免费） | Avalonia 控件 |
esegece.sgcNavigation.Rendering.Community | 社区版（免费） | 无头渲染 |
esegece.sgcNavigation | 注册版 | 核心库 |
esegece.sgcNavigation.WinForms | 注册版 | Windows Forms 控件 |
esegece.sgcNavigation.Wpf | 注册版 | WPF 控件 |
esegece.sgcNavigation.Avalonia | 注册版 | Avalonia 控件 |
esegece.sgcNavigation.Rendering | 注册版 | 无界面渲染 |
sgcNavigation 的每项功能都记录在 sgcUI 帮助中，每种开发环境各有一个版本。