sgcNavigation Feature Matrix
Everything sgcNavigation does, grouped by task, with a link to the help topic of each feature.
Everything sgcNavigation does, grouped by task, with a link to the help topic of each feature.
3 features
8 features
5 features
5 features
5 features
4 features
6 NuGet packages
Online help and PDF manuals
Registered marks the features that are in the Registered and Trial editions and not in the free Community edition. ~ marks a feature that Community has in part, with the difference below it.
Every row links to its help topic. The Community column shows what the free .NET Community edition includes; everything is in Registered and Trial.
| Feature | Details | Community | Help |
|---|---|---|---|
| Sidebar mode | A vertical sidebar of items. Switch the whole look with Mode := nbmSidebar. | Help | |
| Accordion mode | Groups that open and close with IsGroup headers, Expanded and AllowMultiExpand. Switch with Mode := nbmAccordion. | Help | |
| Collapse to an icon rail | Collapsed, AnimateCollapse, ExpandedWidth, CollapsedWidth and OnCollapsedChange collapse the bar to its icons with a smooth animation. | Help |
| Feature | Details | Community | Help |
|---|---|---|---|
| Tree mode | Mode := nbmTree turns the bar into a multi-level tree: Depth per item sets the level, every level is indented and collapsible, with ExpandAll, CollapseAll and ItemPath. | Help | |
| Search | Filter shows the matches and their ancestors, FilterMode nfmContains or nfmFuzzy, and ShowSearch draws a search row. Matched characters are highlighted. | Help | |
| Tabs | A tab strip for FireMonkey, VCL, WinForms, WPF and Avalonia: icons, close buttons, a modified dot, TabSizing, new tab and list buttons, scrolling, Ctrl+Tab, and a Control per tab as its page. | Help | |
| Tab reorder, pinned tabs and tear-off | Drag reorder, Pinned tabs, OnTabTearOff to open a tab in its own window, and SaveLayout and LoadLayout for the arrangement. | Registered | Help |
| Tabbed form | TsgcVCLNavigationTabbedForm, TsgcFMXNavigationTabbedForm and the WinForms, WPF and Avalonia tabbed forms move the tab strip, or in Delphi the strip of a notebook, into a themed title bar with the window icon and the caption buttons. The shadow, the resize borders and the Windows 11 snap layouts stay, and the empty strip drags the window. Tear-off into a new window and the drop on the title bar of another window are in the Registered edition. | Help | |
| Breadcrumb | Segments with chevrons that list the children, an overflow button, and a NavigationBar link that follows the selected item, or a Path of its own. | Help | |
| Breadcrumb edit mode | A click on the empty area, F4 or Ctrl+L edits the full path, with OnPathEdit to accept or refuse it. | Registered | Help |
| Command palette | Ctrl+Shift+P opens a palette that ranks every command by a fuzzy match, with recently used commands, categories, paths and shortcuts. | Registered | Help |
| Command sources | IsgcUICommandSource lists commands for the palette: the navigation bar, the ribbon and toolbar (Delphi), action lists and your own sources. ICommand in .NET. | Help |
| Feature | Details | Community | Help |
|---|---|---|---|
| Docking and drop guides | TsgcVCLDockManager, TsgcFMXDockManager and the WinForms, WPF and Avalonia dock managers dock tool panels on the four sides of the form, in nested splits with splitters and in tabbed groups. A drag on a caption or a tab shows a compass, edge guides and a preview rectangle. | Registered | Help |
| Auto hide | The pin button moves a group to a strip at the side of the form, and a hover or a click slides the panel out over the content. SetAutoHide and AutoHideDelay. | Registered | Help |
| Floating windows | A panel dropped away from the guides floats in its own window, and more panels dock into a float. FloatPanel, AllowFloating and CanFloat. VCL, WinForms, WPF, Avalonia desktop and FireMonkey on Windows and macOS. | Registered | Help |
| Document area | Document groups with the navigation tabs in the centre: reorder, pinned and modified documents, groups side by side or stacked, tear-off, maximize and OnNewDocument. | Registered | Help |
| Layout persistence | SaveLayout and LoadLayout write and read the whole arrangement as JSON, the same text in Delphi and .NET, with OnRestorePanel for panels created at run time. | Registered | Help |
| Feature | Details | Community | Help |
|---|---|---|---|
| Icons | Images and ImageIndex, or a Glyph letter or symbol per item. | Help | |
| Badges | A Badge string per item for unread counts. | Help | |
| Disabled and hidden items | Enabled, Hint and Visible per item. | Help | |
| Events | OnClick per item, OnItemClick and OnSelectionChange on the bar. | Help | |
| Action links | Link an item to a TAction so caption and state follow the action. | Registered | Help |
| Feature | Details | Community | Help |
|---|---|---|---|
| Notification model | TsgcNotificationModel keeps the notifications of a user with title, body, severity, group, time and read state, counts the unread ones, marks them read, dismisses them and saves them as JSON. One model feeds the VCL and FireMonkey views, and TsgcToolbarBadgeLink of sgcToolbar shows its unread count on a toolbar button. | Help | |
| Toast manager | TsgcVCLToastManager and TsgcFMXToastManager show a toast for every new unread notification of the Model: a severity glyph, a title, a body of up to three lines and up to two action buttons. Toasts stack, count down, pause while the pointer is over them and queue when they do not fit, and Show pops a standalone toast such as "Saved". | Help | |
| Notification inbox | TsgcVCLNotificationInbox and TsgcFMXNotificationInbox list the notifications newest first under Today, Yesterday and date headers, with All and Unread tabs, a Mark all as read button and a dismiss button per row. Filter, GroupFilter and Severities narrow the list. | Help | |
| Notification preferences and editor | TsgcNotificationPreferences keeps the channels (in app, pop-up, email and push) the user wants for each category, and TsgcVCLNotificationPrefsEditor and TsgcFMXNotificationPrefsEditor show one row per category and one check box per channel. A category with the pop-up channel off shows no toast, and the inbox still lists it. | Help | |
| Live notifications | A server keeps the notifications current with one JSON message per change (add, update, remove, read, unread, snapshot) through ApplyMessage, or with no code from the WebSocket, MQTT and SSE live sources of the sgcUICoreWS bridge, which need sgcWebSockets. The toasts, the inbox and the badges follow the model. | Registered | Help |
| Feature | Details | Community | Help |
|---|---|---|---|
| Keyboard navigation | Arrow keys, Home, End and Enter move and select, with a focused row. | Help | |
| Themes | Light and dark themes (utLight, utDark) and an AccentColor, shared with the other sgcUI products. | Help | |
| Headless rendering | sgcNavigationSaveToPNG and sgcNavigationSaveToSVG render a bar to PNG or SVG without a window, also on Linux64. | Help | |
| Right to left (Arabic and Hebrew) | Icon and caption order, indent, chevrons, badges and the collapse button are mirrored, and captions read right to left. | Help | |
| Accessibility | The items and groups are exposed to UI Automation as a tree, with the selected item and the expanded state of each group. Up, Down, Home and End move between rows, Enter or Space activates a row, Left and Right collapse and expand groups, the focus ring is always visible and Windows high contrast is followed. On by default on VCL (Delphi 7 to 13), FireMonkey on Windows, WinForms, WPF and Avalonia. | Help |
The .NET navigation bar is a C# port with the same model types, for WinForms, WPF and Avalonia. Items are added in code.
| Package | Edition | Contents |
|---|---|---|
esegece.sgcNavigation.Community | Community (free) | Core library |
esegece.sgcNavigation.WinForms.Community | Community (free) | Windows Forms controls |
esegece.sgcNavigation.Wpf.Community | Community (free) | WPF controls |
esegece.sgcNavigation.Avalonia.Community | Community (free) | Avalonia controls |
esegece.sgcNavigation.Rendering.Community | Community (free) | Headless rendering |
esegece.sgcNavigation | Registered | Core library |
esegece.sgcNavigation.WinForms | Registered | Windows Forms controls |
esegece.sgcNavigation.Wpf | Registered | WPF controls |
esegece.sgcNavigation.Avalonia | Registered | Avalonia controls |
esegece.sgcNavigation.Rendering | Registered | Headless rendering |
Every feature of sgcNavigation is documented in the sgcUI help, with one build for each development environment.
Start with the sgcNavigation introduction, then follow the quick start and the feature topics.
Delphi →The complete sgcUI help as a PDF file, to read offline or print.
Delphi (PDF) →