Siticone Left Sidebar

using SiticoneNetFrameworkUI;
using System;
using System.Drawing;
using System.Windows.Forms;

public partial class MainForm : Form
{
    private SiticoneLeftSidebar _sidebar;
    private Panel _pageHost;
    private Button _menuButton;

    public MainForm()
    {
        InitializeComponent();
        BuildNavigation();
    }

    private void BuildNavigation()
    {
        _menuButton = new Button();
        _menuButton.Text = "Menu";
        _menuButton.Dock = DockStyle.Top;

        _pageHost = new Panel();
        _pageHost.Dock = DockStyle.Fill;

        _sidebar = new SiticoneLeftSidebar();
        _sidebar.Name = "mainSidebar";
        _sidebar.SidebarSide = SiticoneSidebarSide.Left;
        _sidebar.ExpandedWidth = 260;
        _sidebar.CollapsedWidth = 64;
        _sidebar.EnableIconRailMode = true;
        _sidebar.EnableCollapsedToolTips = true;
        _sidebar.AnimationDuration = 220;
        _sidebar.AnimationEasing = SiticoneSidebarEasing.EaseInOut;
        _sidebar.ToggleControl = _menuButton;

        Controls.Add(_pageHost);
        Controls.Add(_sidebar);
        Controls.Add(_menuButton);

        SiticoneSidebarItem dashboard = _sidebar.AddItem("Dashboard", Properties.Resources.DashboardIcon);
        dashboard.Tag = "Dashboard";

        SiticoneSidebarItem patients = _sidebar.AddItem("Patients", Properties.Resources.PatientsIcon);
        patients.Tag = "Patients";

        Font glyphFont = new Font("Segoe MDL2 Assets", 16f, FontStyle.Regular);
        SiticoneSidebarItem settings = _sidebar.AddGlyphItem("Settings", "\uE713", glyphFont, null);
        settings.Tag = "Settings";

        _sidebar.ItemClicked += Sidebar_ItemClicked;
        _sidebar.SelectItem(dashboard);
        ShowPage("Dashboard");
    }

    private void Sidebar_ItemClicked(object sender, SiticoneSidebarItemEventArgs e)
    {
        string pageKey = e.ItemTag as string;

        if (!string.IsNullOrEmpty(pageKey))
        {
            ShowPage(pageKey);
        }
    }

    private void ShowPage(string pageKey)
    {
        _pageHost.Controls.Clear();
        Label page = new Label();
        page.Text = pageKey;
        page.Dock = DockStyle.Fill;
        page.TextAlign = ContentAlignment.MiddleCenter;
        _pageHost.Controls.Add(page);
    }
}

private void MainForm_Load(object sender, EventArgs e)
{
    siticoneLeftSidebar1.ExpandedWidth = 260;
    siticoneLeftSidebar1.CollapsedWidth = 60;
    siticoneLeftSidebar1.ToggleControl = menuButton;
    siticoneLeftSidebar1.EnableIconRailMode = true;
    siticoneLeftSidebar1.EnableCollapsedToolTips = true;
    siticoneLeftSidebar1.SelectIndex(0);
}

private void UpdateSidebarStatus()
{
    switch (siticoneLeftSidebar1.State)
    {
        case SiticoneSidebarState.Expanded:
            statusLabel.Text = "Navigation is open";
            break;

        case SiticoneSidebarState.Collapsed:
            statusLabel.Text = "Navigation is collapsed";
            break;

        case SiticoneSidebarState.Animating:
            statusLabel.Text = "Navigation is moving";
            break;
    }
}

private void MainForm_Shown(object sender, EventArgs e)
{
    siticoneLeftSidebar1.CollapsedWidth = 60;
    siticoneLeftSidebar1.EnableIconRailMode = true;
    siticoneLeftSidebar1.Collapse(false);
}

private void ConfigureHiddenDrawer()
{
    siticoneLeftSidebar1.CollapsedWidth = 0;
    siticoneLeftSidebar1.CollapseMode = SiticoneSidebarCollapseMode.Hide;
}

private void closeButton_Click(object sender, EventArgs e)
{
    siticoneLeftSidebar1.Collapse();
}

private void openButton_Click(object sender, EventArgs e)
{
    siticoneLeftSidebar1.Expand();
}

// Caption only.
SiticoneSidebarItem home = sidebar.AddItem("Home");

// Caption and bitmap icon.
SiticoneSidebarItem patients = sidebar.AddItem(
    "Patients",
    Properties.Resources.PatientsIcon);

// Caption, icon, and click handler.
SiticoneSidebarItem reports = sidebar.AddItem(
    "Reports",
    Properties.Resources.ReportsIcon,
    delegate { OpenReports(); });

SiticoneSidebarItem inbox = new SiticoneSidebarItem();
inbox.Text = "Inbox";
inbox.Icon = Properties.Resources.InboxIcon;
inbox.IconSize = new Size(22, 22);
inbox.Height = 48;
inbox.CornerRadius = 8;
inbox.SelectedBackColor = Color.FromArgb(32, 52, 211, 153);
inbox.SelectedForeColor = Color.FromArgb(16, 185, 129);
inbox.IndicatorColor = Color.FromArgb(16, 185, 129);
inbox.ToolTipText = "Open your messages";
inbox.Tag = "InboxPage";

sidebar.AddItem(inbox);

private Font _navigationGlyphFont;

private void AddGlyphNavigation()
{
    _navigationGlyphFont = new Font("Segoe MDL2 Assets", 17f, FontStyle.Regular);
    FormClosed += MainForm_FormClosed;

    sidebar.AddGlyphItem("Home", "\uE80F", _navigationGlyphFont, delegate { ShowHome(); });
    sidebar.AddGlyphItem("Calendar", "\uE787", _navigationGlyphFont, delegate { ShowCalendar(); });
    sidebar.AddGlyphItem("Settings", "\uE713", _navigationGlyphFont, delegate { ShowSettings(); });
}

private void MainForm_FormClosed(object sender, FormClosedEventArgs e)
{
    if (_navigationGlyphFont != null)
    {
        _navigationGlyphFont.Dispose();
        _navigationGlyphFont = null;
    }
}

private SiticoneSidebarItem _inboxItem;

private void CreateInboxItem()
{
    _inboxItem = sidebar.AddItem("Inbox", Properties.Resources.InboxIcon);
    _inboxItem.BadgeBackColor = Color.Crimson;
    _inboxItem.BadgeForeColor = Color.White;
    SetUnreadCount(12);
}

private void SetUnreadCount(int unreadCount)
{
    _inboxItem.ShowBadge = unreadCount > 0;
    _inboxItem.BadgeText = unreadCount > 99 ? "99+" : unreadCount.ToString();
}

SiticoneSidebarItem signOut = sidebar.AddGlyphItem(
    "Sign out",
    "\uE8AC",
    _navigationGlyphFont,
    delegate { SignOut(); });

signOut.Selectable = false;
signOut.ToolTipText = "Sign out of this account";

SiticoneSidebarItem billing = sidebar.AddItem("Billing", Properties.Resources.BillingIcon);
billing.Enabled = false;
billing.DisabledForeColor = Color.FromArgb(145, 145, 145);
billing.ToolTipText = "Billing is not available for your account";

// Select a known item.
sidebar.SelectItem(dashboardItem);

// Include a reason in the resulting selection event.
sidebar.SelectItem(dashboardItem, SiticoneSidebarTriggerReason.Code);

// Select the first visible-position item.
sidebar.SelectIndex(0);

// The properties route through the same selection behavior.
sidebar.SelectedItem = patientsItem;
sidebar.SelectedIndex = 2;

// Remove the current selection.
sidebar.ClearSelection();

private void ConfigurePageRouting()
{
    dashboardItem.Tag = dashboardPage;
    patientsItem.Tag = patientsPage;
    settingsItem.Tag = settingsPage;

    sidebar.ItemSelectionChanged += Sidebar_ItemSelectionChanged;
}

private void Sidebar_ItemSelectionChanged(
    object sender,
    SiticoneSidebarSelectionChangedEventArgs e)
{
    UserControl page = e.SelectedTag as UserControl;

    if (page == null)
    {
        return;
    }

    pageHost.Controls.Clear();
    page.Dock = DockStyle.Fill;
    pageHost.Controls.Add(page);
}

private bool _hasUnsavedChanges;

private void sidebar_ItemSelectionChanging(
    object sender,
    SiticoneSidebarSelectionChangingEventArgs e)
{
    if (!_hasUnsavedChanges)
    {
        return;
    }

    DialogResult answer = MessageBox.Show(
        "Discard your unsaved changes and leave this page?",
        "Unsaved changes",
        MessageBoxButtons.YesNo,
        MessageBoxIcon.Warning);

    e.Cancel = answer != DialogResult.Yes;
}

patientsItem.Text = "People and patients";
patientsItem.ToolTipText = "Open the patient directory";

// Text and ToolTipText already refresh that item's tooltip automatically.
// Call this when several layout-related values changed together.
sidebar.RefreshItems();

// Or explicitly re-evaluate only one tooltip.
sidebar.RefreshItemToolTip(patientsItem);

private void ConfigureIconRail()
{
    sidebar.ExpandedWidth = 260;
    sidebar.CollapsedWidth = 60;
    sidebar.EnableIconRailMode = true;

    // Zero means: use CollapsedWidth + 24.
    sidebar.RailSwitchWidth = 0;

    sidebar.EnableCollapsedToolTips = true;
    sidebar.ShowToolTipsWhenExpanded = false;
    sidebar.ToolTipInitialDelay = 350;
    sidebar.ToolTipAutoPopDelay = 5000;
    sidebar.ToolTipReshowDelay = 100;
}

dashboardItem.RailIconAlignment = SiticoneSidebarRailIconAlignment.Center;
patientsItem.RailIconAlignment = SiticoneSidebarRailIconAlignment.Center;
brandItem.RailIconAlignment = SiticoneSidebarRailIconAlignment.Left;

private void sidebar_ItemToolTipShowing(
    object sender,
    SiticoneSidebarToolTipEventArgs e)
{
    if (ReferenceEquals(e.Item, signOutItem))
    {
        e.Text = "Sign out of " + currentUserName;
    }

    if (ReferenceEquals(e.Item, decorativeLogoItem))
    {
        e.Cancel = true;
    }
}

logoItem.ShowToolTipWhenCollapsed = false;

// This can also enable tooltips while the sidebar is open.
sidebar.ShowToolTipsWhenExpanded = true;

public sealed class SidebarBrandHeader : UserControl, ISiticoneSidebarRailAware
{
    private readonly PictureBox _logo;
    private readonly Label _productName;

    public SidebarBrandHeader()
    {
        Height = 64;
        Dock = DockStyle.Top;

        _logo = new PictureBox();
        _logo.Size = new Size(28, 28);
        _logo.SizeMode = PictureBoxSizeMode.Zoom;

        _productName = new Label();
        _productName.Text = "Contoso Health";
        _productName.AutoSize = true;

        Controls.Add(_logo);
        Controls.Add(_productName);
    }

    public void ApplyRailState(bool railModeEnabled, bool collapsed, int availableWidth)
    {
        bool showRail = railModeEnabled && collapsed;
        _productName.Visible = !showRail;

        _logo.Left = showRail
            ? Math.Max(0, (availableWidth - _logo.Width) / 2)
            : 14;
    }
}

private void sidebar_RailModeChanged(object sender, SiticoneSidebarRailEventArgs e)
{
    railStatusLabel.Text = e.Collapsed
        ? "Icon rail active at " + e.AvailableWidth + " px"
        : "Full navigation active";
}

private void ConfigureDrawer()
{
    sidebar.BringToFrontOnExpand = true;
    sidebar.AutoCloseOnOutsideClick = true;
    sidebar.AutoCloseOnEscape = true;

    sidebar.EnableScrim = true;
    sidebar.ScrimColor = Color.Black;
    sidebar.ScrimOpacity = 38;
    sidebar.ScrimClosesSidebar = true;

    sidebar.CollapsedWidth = 0;
    sidebar.CollapseMode = SiticoneSidebarCollapseMode.Hide;
    sidebar.ToggleControl = menuButton;
}

private void ConfigureOutsideClickExceptions()
{
    sidebar.AddOutsideClickException(accountPopup);
    sidebar.AddOutsideClickException(topToolbar);
}

private void StopExcludingAccountPopup()
{
    sidebar.RemoveOutsideClickException(accountPopup);
}

private void ResetAllExceptions()
{
    sidebar.ClearOutsideClickExceptions();
}

private void sidebar_OutsideClicked(
    object sender,
    SiticoneSidebarOutsideClickEventArgs e)
{
    if (_mustFinishNavigationTask)
    {
        e.Cancel = true;
        statusLabel.Text = "Finish or cancel the current task before closing navigation.";
    }
}

private void sidebar_ScrimClicked(object sender, SiticoneSidebarScrimEventArgs e)
{
    if (e.Button != MouseButtons.Left)
    {
        e.Cancel = true;
    }
}

sidebar.AutoCloseOnOutsideClick = true;
sidebar.AutoCloseOnTitleBarClick = true;

Rectangle screenArea = sidebar.CalculateScrimBounds();

if (!screenArea.IsEmpty)
{
    debugLabel.Text = string.Format(
        "Overlay: {0}, {1}, {2} x {3}",
        screenArea.X,
        screenArea.Y,
        screenArea.Width,
        screenArea.Height);
}

sidebar.EnableIconRailMode = true;
sidebar.CollapsedWidth = 60;
sidebar.ExpandOnHover = true;
sidebar.HoverExpandDelay = 300;
sidebar.CollapseOnMouseLeave = true;

SiticoneRightSidebar inspector = new SiticoneRightSidebar();
inspector.Name = "detailsSidebar";
inspector.ExpandedWidth = 320;
inspector.CollapsedWidth = 0;
inspector.CollapseMode = SiticoneSidebarCollapseMode.Hide;
inspector.EnableScrim = true;
inspector.AutoCloseOnEscape = true;
inspector.BringToFrontOnExpand = true;

Controls.Add(inspector);

private void MoveSidebarToOppositeSide()
{
    sidebar.AutoDock = true;
    sidebar.SidebarSide = sidebar.SidebarSide == SiticoneSidebarSide.Left
        ? SiticoneSidebarSide.Right
        : SiticoneSidebarSide.Left;
}

private void ConfigureSidebarRegions()
{
    sidebar.HeaderHeight = 72;
    sidebar.FooterHeight = 64;
    sidebar.HeaderVisible = true;
    sidebar.FooterVisible = true;
    sidebar.ContentAutoScroll = true;
    sidebar.MoveExistingChildrenToContent = true;
    sidebar.EnableRegions = true;

    PictureBox logo = new PictureBox();
    logo.Image = Properties.Resources.CompanyLogo;
    logo.SizeMode = PictureBoxSizeMode.Zoom;
    logo.Dock = DockStyle.Fill;
    sidebar.HeaderPanel.Controls.Add(logo);

    // AddItem uses ItemHost, which is ContentPanel when regions are enabled.
    sidebar.AddItem("Dashboard", Properties.Resources.DashboardIcon);
    sidebar.AddItem("Patients", Properties.Resources.PatientsIcon);
    sidebar.AddItem("Appointments", Properties.Resources.CalendarIcon);

    Button accountButton = new Button();
    accountButton.Text = "My account";
    accountButton.Dock = DockStyle.Fill;
    sidebar.FooterPanel.Controls.Add(accountButton);
}

Label sectionTitle = new Label();
sectionTitle.Text = "WORKSPACE";
sectionTitle.Height = 32;
sectionTitle.Dock = DockStyle.Top;
sectionTitle.TextAlign = ContentAlignment.MiddleLeft;

sidebar.ItemHost.Controls.Add(sectionTitle);
sectionTitle.BringToFront();

// Set this before EnableRegions.
sidebar.MoveExistingChildrenToContent = false;
sidebar.EnableRegions = true;

// Add content explicitly to the intended region.
sidebar.ContentPanel.Controls.Add(customNavigationPanel);

private void SetCompactNavigation(bool compact)
{
    sidebar.HeaderVisible = !compact;
    sidebar.FooterVisible = !compact;
}

private void ApplyDarkNavigationTheme()
{
    sidebar.ApplyTheme(
        "Dark",
        Color.FromArgb(24, 32, 48),
        Color.FromArgb(241, 245, 249));

    foreach (SiticoneSidebarItem item in sidebar.Items)
    {
        item.ForeColor = sidebar.ForeColor;
        item.HoverBackColor = Color.FromArgb(35, 255, 255, 255);
        item.SelectedBackColor = Color.FromArgb(45, 52, 211, 153);
        item.SelectedForeColor = Color.FromArgb(110, 231, 183);
        item.IndicatorColor = Color.FromArgb(52, 211, 153);
    }
}

sidebar.EnableGradient = true;
sidebar.GradientStartColor = Color.FromArgb(15, 23, 42);
sidebar.GradientEndColor = Color.FromArgb(30, 41, 59);
sidebar.GradientAngle = 90f;

sidebar.EnableDropShadow = true;
sidebar.ShadowDepth = 15;
sidebar.ShadowBlur = 40;
sidebar.ShadowSpread = 15;
sidebar.ShadowVerticalOffset = 5;
sidebar.ShadowColor = Color.FromArgb(60, 100, 100, 111);
sidebar.ReserveShadowSpace = true;
sidebar.CacheShadow = true;

sidebar.RightBorderVisible = true;
sidebar.EdgeBorderThickness = 1;
sidebar.EdgeBorderColor = Color.FromArgb(71, 85, 105);

// Hide the border without losing its configured thickness or color.
sidebar.RightBorderVisible = false;

sidebar.CornerRadius = 14;

// Round only the inner/shadow edge: right on a left sidebar,
// and left on a right sidebar.
sidebar.RoundRightCornersOnly = true;

sidebar.ResetShadowColor();
sidebar.ResetRightBorderColor();
sidebar.ResetGradientStartColor();
sidebar.ResetGradientEndColor();
sidebar.ResetScrimColor();
sidebar.ResetResizeGripColor();

sidebar.EnableUserResize = true;
sidebar.MinExpandedWidth = 200;
sidebar.MaxExpandedWidth = 420;
sidebar.ResizeGripSize = 7;
sidebar.ShowResizeCursor = true;
sidebar.ResizeGripColor = Color.FromArgb(100, 148, 163, 184);

private void sidebar_UserResizing(object sender, SiticoneSidebarResizeEventArgs e)
{
    const int step = 20;
    int snapped = ((e.ProposedWidth + (step / 2)) / step) * step;

    e.ProposedWidth = Math.Max(
        e.MinimumWidth,
        Math.Min(e.MaximumWidth, snapped));
}

private void sidebar_UserResizeStarted(object sender, SiticoneSidebarResizeEventArgs e)
{
    if (!currentUserCanCustomizeLayout)
    {
        e.Cancel = true;
        statusLabel.Text = "Your layout is managed by an administrator.";
    }
}

private void MainForm_KeyDown(object sender, KeyEventArgs e)
{
    if (e.KeyCode == Keys.Escape && sidebar.IsUserResizing)
    {
        sidebar.CancelUserResize();
        e.Handled = true;
    }
}

Rectangle grip = sidebar.GetResizeGripBounds();
bool mouseIsOverGrip = grip.Contains(sidebar.PointToClient(Control.MousePosition));

private void ConfigurePersistence()
{
    sidebar.PersistenceKey = "MainNavigation";
    sidebar.PersistenceMode = SiticoneSidebarPersistenceMode.ApplicationDataFile;

    sidebar.PersistExpandedState = true;
    sidebar.PersistWidth = true;
    sidebar.PersistSelectedIndex = true;
    sidebar.AutoPersist = true;
    sidebar.EnablePersistence = true;
}

private void saveLayoutButton_Click(object sender, EventArgs e)
{
    bool saved = sidebar.SaveState();
    statusLabel.Text = saved ? "Layout saved" : "Layout could not be saved";
}

private void restoreLayoutButton_Click(object sender, EventArgs e)
{
    bool applied = sidebar.LoadState();
    statusLabel.Text = applied ? "Saved layout restored" : "No saved layout was applied";
}

private void resetLayoutButton_Click(object sender, EventArgs e)
{
    bool deleted = sidebar.ClearPersistedState();
    statusLabel.Text = deleted ? "Saved layout removed" : "No saved file was removed";
}

persistenceKeyLabel.Text = sidebar.EffectivePersistenceKey;

if (sidebar.PersistenceMode == SiticoneSidebarPersistenceMode.ApplicationDataFile)
{
    persistencePathLabel.Text = sidebar.PersistenceFilePath;
}

using Microsoft.Win32;

private const string SidebarRegistryPath = @"Software\Contoso\DesktopApp\Sidebars";

private void ConfigureCustomPersistence()
{
    sidebar.PersistenceKey = "MainNavigation";
    sidebar.PersistenceMode = SiticoneSidebarPersistenceMode.Custom;
    sidebar.PersistExpandedState = true;
    sidebar.PersistWidth = true;
    sidebar.PersistSelectedIndex = true;

    sidebar.StateSaving += Sidebar_StateSaving;
    sidebar.StateLoading += Sidebar_StateLoading;
    sidebar.EnablePersistence = true;
}

private void Sidebar_StateSaving(object sender, SiticoneSidebarPersistenceEventArgs e)
{
    try
    {
        using (RegistryKey key = Registry.CurrentUser.CreateSubKey(SidebarRegistryPath))
        {
            if (key == null)
            {
                e.Cancel = true;
                return;
            }

            key.SetValue(e.Key, e.State, RegistryValueKind.String);
        }
    }
    catch (Exception)
    {
        e.Cancel = true;
    }
}

private void Sidebar_StateLoading(object sender, SiticoneSidebarPersistenceEventArgs e)
{
    using (RegistryKey key = Registry.CurrentUser.OpenSubKey(SidebarRegistryPath))
    {
        object value = key == null ? null : key.GetValue(e.Key);
        e.State = Convert.ToString(value) ?? string.Empty;
    }
}

private void sidebar_StateSaved(
    object sender,
    SiticoneSidebarPersistenceCompletedEventArgs e)
{
    if (!e.Succeeded)
    {
        statusLabel.Text = e.Error == null
            ? "Sidebar state was not saved."
            : "Sidebar state was not saved: " + e.Error.Message;
    }
}

private void sidebar_StateLoaded(
    object sender,
    SiticoneSidebarPersistenceCompletedEventArgs e)
{
    if (!e.Succeeded && e.Error != null)
    {
        statusLabel.Text = "Sidebar state was not loaded: " + e.Error.Message;
    }
}

sidebar.EnableKeyboardNavigation = true;
sidebar.ToggleShortcut = Keys.Control | Keys.B;
sidebar.EnableArrowNavigation = true;
sidebar.ActivateItemOnEnter = true;

// Optional: Escape closes an expanded sidebar.
sidebar.AutoCloseOnEscape = true;

sidebar.EnableKeyboardNavigation = true;
sidebar.ToggleShortcut = Keys.None;
sidebar.EnableArrowNavigation = true;
sidebar.ActivateItemOnEnter = true;

private void sidebar_ShortcutActivated(object sender, SiticoneSidebarShortcutEventArgs e)
{
    TextBoxBase editor = ActiveControl as TextBoxBase;

    if (editor != null)
    {
        e.Cancel = true;
    }
}

private void sidebar_KeyNavigating(object sender, SiticoneSidebarNavigationEventArgs e)
{
    if (ReferenceEquals(e.ToItem, administrationItem) && !currentUserIsAdministrator)
    {
        e.Cancel = true;
        statusLabel.Text = "Administration access is required.";
    }
}

bool moved = sidebar.MoveFocusTo(
    SiticoneSidebarNavigationDirection.First,
    Keys.Home);

if (!moved)
{
    statusLabel.Text = "There is no visible, enabled navigation item to focus.";
}

private void ConfigureDpiSupport()
{
    sidebar.EnableDpiScaling = true;
    sidebar.DpiScaleChanged += Sidebar_DpiScaleChanged;
}

private void Sidebar_DpiScaleChanged(object sender, SiticoneSidebarDpiEventArgs e)
{
    dpiLabel.Text = string.Format(
        "{0:0} DPI to {1:0} DPI (x{2:0.00}); width {3}px",
        e.OldDpi,
        e.NewDpi,
        e.ScaleFactor,
        e.ExpandedWidth);
}

// Example: convert metrics from 96 DPI to 120 DPI.
float factor = 120f / 96f;
sidebar.RescaleForDpi(factor);

private void ConfigureShadowDiagnostics()
{
    sidebar.CacheShadow = true;
    sidebar.ShadowCacheRebuilt += delegate(object sender, SiticoneSidebarShadowCacheEventArgs e)
    {
        System.Diagnostics.Debug.WriteLine(string.Format(
            "Sidebar shadow: {0}x{1}, {2} layers, {3:0.00} ms",
            e.CacheSize.Width,
            e.CacheSize.Height,
            e.LayerCount,
            e.ElapsedMilliseconds));
    };
}

private void ForceShadowRebuildOnNextPaint()
{
    sidebar.InvalidateShadowCache();
    sidebar.Invalidate();
}

private void sidebar_BeforeCollapse(object sender, SiticoneSidebarCancelEventArgs e)
{
    if (_navigationContainsUnsavedWork)
    {
        e.Cancel = true;
        statusLabel.Text = "Save or discard your changes before closing navigation.";
    }
}

private void sidebar_AfterCollapse(object sender, SiticoneSidebarEventArgs e)
{
    switch (e.Reason)
    {
        case SiticoneSidebarTriggerReason.OutsideClick:
            statusLabel.Text = "Navigation closed after an outside click.";
            break;

        case SiticoneSidebarTriggerReason.EscapeKey:
            statusLabel.Text = "Navigation closed with Escape.";
            break;

        case SiticoneSidebarTriggerReason.Scrim:
            statusLabel.Text = "Navigation closed from the overlay.";
            break;

        default:
            statusLabel.Text = "Navigation closed.";
            break;
    }
}

private void sidebar_AnimationProgressChanged(
    object sender,
    SiticoneSidebarAnimationProgressEventArgs e)
{
    animationProgressBar.Value = Math.Max(
        animationProgressBar.Minimum,
        Math.Min(animationProgressBar.Maximum, (int)Math.Round(e.Progress * 100f)));

    widthLabel.Text = e.CurrentWidth + " px";
}

private void AttachSidebarDiagnostics()
{
    sidebar.AfterExpand += delegate(object sender, SiticoneSidebarEventArgs e)
    {
        Log("Expanded to " + e.Width + " px; reason: " + e.Reason);
    };

    sidebar.AfterCollapse += delegate(object sender, SiticoneSidebarEventArgs e)
    {
        Log("Collapsed to " + e.Width + " px; reason: " + e.Reason);
    };

    sidebar.ItemSelectionChanged += delegate(object sender, SiticoneSidebarSelectionChangedEventArgs e)
    {
        Log("Selected item " + e.SelectedIndex + ": " + e.SelectedText);
    };

    sidebar.UserResizeCompleted += delegate(object sender, SiticoneSidebarResizeCompletedEventArgs e)
    {
        Log("Resize completed at " + e.FinalWidth + " px; cancelled: " + e.Cancelled);
    };

    sidebar.SideChanged += delegate(object sender, SiticoneSidebarSideChangedEventArgs e)
    {
        Log("Sidebar moved from " + e.OldSide + " to " + e.NewSide);
    };
}

private void Log(string message)
{
    System.Diagnostics.Debug.WriteLine(message);
}

private void openDashboardToolStripMenuItem_Click(object sender, EventArgs e)
{
    dashboardItem.PerformActivate();
}

public sealed class RailAwareCaption : Label, ISiticoneSidebarRailAware
{
    public void ApplyRailState(bool railModeEnabled, bool collapsed, int availableWidth)
    {
        Visible = !(railModeEnabled && collapsed);
        MaximumSize = new Size(Math.Max(0, availableWidth), 0);
    }
}

SiticoneSidebarCancelEventArgs args = new SiticoneSidebarCancelEventArgs(
    SiticoneSidebarTransition.Collapsing,
    SiticoneSidebarTriggerReason.Code,
    260,
    60);

args.Cancel = true;

Assert.IsTrue(args.Cancel);
Assert.AreEqual(260, args.CurrentWidth);
Assert.AreEqual(60, args.TargetWidth);

private void ConfigureDesktopRail()
{
    sidebar.SidebarSide = SiticoneSidebarSide.Left;
    sidebar.ExpandedWidth = 264;
    sidebar.CollapsedWidth = 64;
    sidebar.CollapseMode = SiticoneSidebarCollapseMode.Width;
    sidebar.EnableIconRailMode = true;
    sidebar.EnableCollapsedToolTips = true;
    sidebar.ToggleControl = menuButton;

    sidebar.EnableAnimation = true;
    sidebar.AnimationDuration = 200;
    sidebar.AnimationEasing = SiticoneSidebarEasing.EaseInOut;

    sidebar.EnablePersistence = true;
    sidebar.PersistenceKey = "DesktopMainNavigation";
    sidebar.PersistExpandedState = true;
    sidebar.PersistWidth = false;
}

private void ConfigureModalDrawer()
{
    sidebar.ExpandedWidth = 300;
    sidebar.CollapsedWidth = 0;
    sidebar.CollapseMode = SiticoneSidebarCollapseMode.Hide;
    sidebar.BringToFrontOnExpand = true;

    sidebar.EnableScrim = true;
    sidebar.ScrimOpacity = 40;
    sidebar.ScrimClosesSidebar = true;
    sidebar.AutoCloseOnOutsideClick = true;
    sidebar.AutoCloseOnEscape = true;
    sidebar.ToggleControl = menuButton;

    sidebar.Collapse(false);
}

private void ConfigureFixedSidebar()
{
    sidebar.ExpandedWidth = 240;
    sidebar.EnableAnimation = false;
    sidebar.EnableIconRailMode = false;
    sidebar.AutoCloseOnOutsideClick = false;
    sidebar.AutoCloseOnEscape = false;
    sidebar.Expand(false);
}

private void ConfigureAdminNavigation()
{
    sidebar.EnableRegions = true;
    sidebar.HeaderHeight = 72;
    sidebar.FooterHeight = 64;

    sidebar.EnableUserResize = true;
    sidebar.MinExpandedWidth = 220;
    sidebar.MaxExpandedWidth = 440;

    sidebar.EnableKeyboardNavigation = true;
    sidebar.ToggleShortcut = Keys.Control | Keys.B;
    sidebar.AutoCloseOnEscape = true;

    sidebar.PersistenceKey = "AdminNavigation";
    sidebar.PersistExpandedState = true;
    sidebar.PersistWidth = true;
    sidebar.PersistSelectedIndex = true;
    sidebar.EnablePersistence = true;
}