This example demonstrates how to customize the NOV schedule ribbon.

| Language: C# |
using Nevron.Nov;
using Nevron.Nov.Dom;
using Nevron.Nov.Graphics;
using Nevron.Nov.Layout;
using Nevron.Nov.Schedule;
using Nevron.Nov.Schedule.Commands;
using Nevron.Nov.Schedule.UI;
using Nevron.Nov.UI;
using Nevron.Nov.Windows.Forms;
using System;
using System.Windows.Forms;
namespace NovWinFormsProject
{
public partial class Form1 : Form
{
#region Constructors
public Form1()
{
InitializeComponent();
// Set form title
Text = "NOV WinForms - NRibbonCustomizationExample";
// Create the NOV example and its controls
NWidget exampleContent = CreateExampleContent();
NWidget exampleControls = CreateExampleControls();
if (exampleControls != null)
{
exampleControls.PreferredWidth = 300;
}
// Place the example and its controls in a pair box
NPairBox pairBox = new NPairBox(exampleContent, exampleControls);
pairBox.FillMode = ENStackFillMode.First;
pairBox.FitMode = ENStackFitMode.First;
pairBox.Margins = new NMargins(NDesign.HorizontalSpacing, NDesign.VerticalSpacing);
// Host the example in the form
NNovWidgetHost host = new NNovWidgetHost(pairBox);
host.Dock = DockStyle.Fill;
Controls.Add(host);
}
#endregion
#region Example
public NWidget CreateExampleContent()
{
// Create a simple schedule
m_ScheduleView = new NScheduleView();
m_ScheduleView.Document.PauseHistoryService();
try
{
InitSchedule(m_ScheduleView.Content);
}
finally
{
m_ScheduleView.Document.ResumeHistoryService();
}
// Add the custom command action to the schedule view's commander
m_ScheduleView.Commander.Add(new CustomCommandAction());
// Create and configure a ribbon UI builder
NScheduleRibbonBuilder ribbonBuilder = new NScheduleRibbonBuilder();
// Rename the "Home" ribbon tab page
NRibbonTabPageBuilder homeTabBuilder = ribbonBuilder.TabPageBuilders[NScheduleRibbonBuilder.TabPageHomeName];
homeTabBuilder.Name = "Start";
// Rename the "Font" ribbon group of the "Home" tab page
NRibbonGroupBuilder fontGroupBuilder = homeTabBuilder.RibbonGroupBuilders[NHomeTabPageBuilder.GroupViewName];
fontGroupBuilder.Name = "Look";
// Remove the "Editing" ribbon group from the "Home" tab page
homeTabBuilder.RibbonGroupBuilders.Remove(NHomeTabPageBuilder.GroupEditingName);
// Insert the custom ribbon group at the beginning of the home tab page
homeTabBuilder.RibbonGroupBuilders.Insert(0, new CustomRibbonGroupBuilder());
// Create the commanding UI
NCommandUIHolder scheduleViewWithRibbon = ribbonBuilder.CreateUI(m_ScheduleView);
// Remove the Open and Save commands
scheduleViewWithRibbon.RemoveCommands(NScheduleView.OpenCommand, NScheduleView.SaveCommand, NScheduleView.SaveAsCommand);
return scheduleViewWithRibbon;
}
public NWidget CreateExampleControls()
{
return null;
}
public string GetExampleDescription()
{
return @"
This example demonstrates how to customize the NOV schedule ribbon.
";
}
///
/// Gets the relevant documentation links for the example
///
///
public (string Name, string Url)[] GetDocumentationUrls()
{
return new[]
{
("Schedule Ribbon via Code", "https://www.nevron.com/docs/openvision/schedule-ribbon-via-code.html"),
("Schedule Commanding Overview", "https://www.nevron.com/docs/openvision/schedule-commanding-overview.html"),
};
}
#endregion
#region Implementation
private void InitSchedule(NSchedule schedule)
{
DateTime start = DateTime.Now;
// Create an appointment
NAppointment appointment = new NAppointment("Meeting", start, start.AddHours(2));
schedule.Appointments.Add(appointment);
schedule.ScrollToTime(start.TimeOfDay);
}
#endregion
#region Event Handlers
#endregion
#region Fields
private NScheduleView m_ScheduleView;
#endregion
#region Static Methods
#endregion
#region Constants
public static readonly NCommand CustomCommand = NCommand.Create(typeof(Nevron.Nov.Examples.Schedule.NRibbonCustomizationExample),
"CustomCommand", "Custom Command");
#endregion
#region Nested Types
public class CustomRibbonGroupBuilder : NRibbonGroupBuilder
{
public CustomRibbonGroupBuilder()
: base("Custom Group", Nevron.Nov.Graphics.NImage.FromBytes(Nevron.Nov.NConvert.FromBase64String("iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAABsElEQVR4AYWTQ7BjQRSGZz3cjM04Y9u2bdu2bdu29bx83jxzvI79z+munDiVW/Vd/Lf/g0aF0MvyeUJT4ipRTsDLb+ImoQ4zhJifEYjBp2jmfAJWAsmTYP/mN9m+SE08WfsVar7PZuPHcajfRI2M68NFEGn6+3wM6jZSovTRyMAgH9jcgDM5v0/E5+ODUbOBCgeX9oAnfiLccRNxf1c/qV3Z1Ed+B7SjFQHOsiAyplHmSjUUuLZZDoYMemKw1F4eHAjX96AAt7l3MIifIDOZP/k1D5kubuxDCcazxvwTAZyBoouyImUykDCJmMjISeTyA+EAbMbjvf1xaFlP7FrYHTvmS7B7UQ+cWNULj/f0o5bCA+Tyh8jSTKFGU4UGzZXBNCOtWm2FrCYgwB8R4DQL4ue2ud3QpLkGOp0uiGYUZM6YDkDipMAAN0WAOgQYN5XYv0crNGyqhoJMCpUGjZqp0am9HuaP42H9EtRCC94LN1m0EkiahDeHB2LNjC5YOaUzHu3uL6uzBZtfhe7G7KDV+M4rEHH2i0KPQlAlMXga60TW8U5sHuEkXEQBcYFoGDr+P5RkQoMvtntjAAAAAElFTkSuQmCC")))
{
}
protected override void AddRibbonGroupItems(NRibbonGroupItemCollection items)
{
// Add the "Add Appointment" command
items.Add(CreateRibbonButton(Nevron.Nov.Graphics.NImage.FromBytes(Nevron.Nov.NConvert.FromBase64String("PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4NCjwhRE9DVFlQRSBzdmcgUFVCTElDICItLy9XM0MvL0RURCBTVkcgMS4xLy9FTiIgImh0dHA6Ly93d3cudzMub3JnL0dyYXBoaWNzL1NWRy8xLjEvRFREL3N2ZzExLmR0ZCI+DQo8c3ZnIHZlcnNpb249IjEuMSIgaWQ9IkxheWVyXzEiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyIgeG1sbnM6eGxpbms9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkveGxpbmsiIHg9IjBweCIgeT0iMHB4IiB3aWR0aD0iMzJweCIgaGVpZ2h0PSIzMnB4IiB2aWV3Qm94PSIwIDAgMzIgMzIiIGVuYWJsZS1iYWNrZ3JvdW5kPSJuZXcgMCAwIDMyIDMyIiB4bWw6c3BhY2U9InByZXNlcnZlIj4NCgk8ZyBpZD0ibWFpbiIgdHJhbnNmb3JtPSJzY2FsZSgxLjMzMzMzMzMzMzMzMzMzMzMpIj4NCgkJPGcgaWQ9Imljb24iPg0KCQkJPHBhdGggZD0iTTEsMjFMMTEsMjFMMTEsMjAuNUw5LjUsMjAuNUw5LjUsMTQuNUwxNC41LDE0LjVMMTQuNSw5LjVMMjAuNSw5LjVMMjAuNSwxMUwyMSwxMUwyMSw1TDEsNXp6IiBpZD0iYiIgZmlsbD0iI0ZGRkZGRiIgb3BhY2l0eT0iMC40IiAvPg0KCQkJPHBhdGggZD0iTTcsMTFMNCwxMUw0LDE4TDcsMThMOS41LDE4TDkuNSwxN0w4LDE3TDgsMTVMOS41LDE1TDkuNSwxNC41TDE0LjUsMTQuNUwxNC41LDE0TDE0LDE0TDE0LDEyTDE0LjUsMTJMMTQuNSwxMUwxNCwxMUwxNCw5TDE3LDlMMTcsOS41TDE4LDkuNUwxOCw4TDE0LDhMMTAsOEw3LDh6TTEwLDlMMTAsMTFMOCwxMUw4LDl6TTEzLDlMMTMsMTFMMTEsMTFMMTEsOXpNNywxMkw3LDE0TDUsMTRMNSwxMnpNMTAsMTJMMTAsMTRMOCwxNEw4LDEyek0xMywxMkwxMywxNEwxMSwxNEwxMSwxMnpNNywxNUw3LDE3TDUsMTdMNSwxNXp6IiBmaWxsPSIjNkQ2RTcxIiAvPg0KCQkJPHBhdGggZD0iTTUsM0w3LDNMNywwTDUsMHpNMTUsM0wxNywzTDE3LDBMMTUsMHp6IiBmaWxsPSIjN0I3QjdCIiAvPg0KCQkJPHBhdGggZD0iTTAsNkwyMiw2TDIyLDFMMTgsMUwxOCw0TDE0LDRMMTQsMUw4LDFMOCw0TDQsNEw0LDFMMCwxenoiIGZpbGw9IiM5MDcwQjEiIC8+DQoJCQk8cGF0aCBkPSJNMCwyMkwxMSwyMkwxMSwyMC41TDkuNSwyMC41TDkuNSwyMEwyLDIwTDIsNkwwLDZ6TTIwLDkuNUwyMC41LDkuNUwyMC41LDExTDIyLDExTDIyLDZMMjAsNnp6IiBmaWxsPSIjN0I3QjdCIiAvPg0KCQkJPHBhdGggZD0iTTEwLDE0LjVMMTQsMTQuNUwxNCwxMUwxMCwxMXpNMTMsMTJMMTMsMTRMMTEsMTRMMTEsMTJ6eiIgZmlsbD0iI0NCNTI1RCIgLz4NCgkJCTxwYXRoIGQ9Ik0xMSwxNEwxMywxNEwxMywxMkwxMSwxMnp6IiBmaWxsPSIjQ0I1MjVEIiBvcGFjaXR5PSIwLjMiIC8+DQoJCTwvZz4NCgkJPGcgaWQ9Im92ZXJsYXkiPg0KCQkJPHBvbHlnb24gcG9pbnRzPSIxNiwyNCAxNiwxOSAxMSwxOSAxMSwxNiAxNiwxNiAxNiwxMSAxOSwxMSAxOSwxNiAyNCwxNiAyNCwxOSAxOSwxOSAxOSwyNCIgZmlsbD0iIzUyQjI1MCIgc3Ryb2tlLWxpbmVqb2luPSJtaXRlciIgLz4NCgkJPC9nPg0KCTwvZz4NCjwvc3ZnPg0K")),
Nevron.Nov.Graphics.NImage.FromBytes(Nevron.Nov.NConvert.FromBase64String("PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4NCjwhRE9DVFlQRSBzdmcgUFVCTElDICItLy9XM0MvL0RURCBTVkcgMS4xLy9FTiIgImh0dHA6Ly93d3cudzMub3JnL0dyYXBoaWNzL1NWRy8xLjEvRFREL3N2ZzExLmR0ZCI+DQo8c3ZnIHZlcnNpb249IjEuMSIgaWQ9IkxheWVyXzEiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyIgeG1sbnM6eGxpbms9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkveGxpbmsiIHg9IjBweCIgeT0iMHB4IiB3aWR0aD0iMzJweCIgaGVpZ2h0PSIzMnB4IiB2aWV3Qm94PSIwIDAgMzIgMzIiIGVuYWJsZS1iYWNrZ3JvdW5kPSJuZXcgMCAwIDMyIDMyIiB4bWw6c3BhY2U9InByZXNlcnZlIj4NCgk8ZyBpZD0ibWFpbiIgdHJhbnNmb3JtPSJzY2FsZSgxLjMzMzMzMzMzMzMzMzMzMzMpIj4NCgkJPGcgaWQ9Imljb24iPg0KCQkJPHBhdGggZD0iTTEsMjFMMTEsMjFMMTEsMjAuNUw5LjUsMjAuNUw5LjUsMTQuNUwxNC41LDE0LjVMMTQuNSw5LjVMMjAuNSw5LjVMMjAuNSwxMUwyMSwxMUwyMSw1TDEsNXp6IiBpZD0iYiIgZmlsbD0iI0ZGRkZGRiIgb3BhY2l0eT0iMC40IiAvPg0KCQkJPHBhdGggZD0iTTcsMTFMNCwxMUw0LDE4TDcsMThMOS41LDE4TDkuNSwxN0w4LDE3TDgsMTVMOS41LDE1TDkuNSwxNC41TDE0LjUsMTQuNUwxNC41LDE0TDE0LDE0TDE0LDEyTDE0LjUsMTJMMTQuNSwxMUwxNCwxMUwxNCw5TDE3LDlMMTcsOS41TDE4LDkuNUwxOCw4TDE0LDhMMTAsOEw3LDh6TTEwLDlMMTAsMTFMOCwxMUw4LDl6TTEzLDlMMTMsMTFMMTEsMTFMMTEsOXpNNywxMkw3LDE0TDUsMTRMNSwxMnpNMTAsMTJMMTAsMTRMOCwxNEw4LDEyek0xMywxMkwxMywxNEwxMSwxNEwxMSwxMnpNNywxNUw3LDE3TDUsMTdMNSwxNXp6IiBmaWxsPSIjNkQ2RTcxIiAvPg0KCQkJPHBhdGggZD0iTTUsM0w3LDNMNywwTDUsMHpNMTUsM0wxNywzTDE3LDBMMTUsMHp6IiBmaWxsPSIjN0I3QjdCIiAvPg0KCQkJPHBhdGggZD0iTTAsNkwyMiw2TDIyLDFMMTgsMUwxOCw0TDE0LDRMMTQsMUw4LDFMOCw0TDQsNEw0LDFMMCwxenoiIGZpbGw9IiM5MDcwQjEiIC8+DQoJCQk8cGF0aCBkPSJNMCwyMkwxMSwyMkwxMSwyMC41TDkuNSwyMC41TDkuNSwyMEwyLDIwTDIsNkwwLDZ6TTIwLDkuNUwyMC41LDkuNUwyMC41LDExTDIyLDExTDIyLDZMMjAsNnp6IiBmaWxsPSIjN0I3QjdCIiAvPg0KCQkJPHBhdGggZD0iTTEwLDE0LjVMMTQsMTQuNUwxNCwxMUwxMCwxMXpNMTMsMTJMMTMsMTRMMTEsMTRMMTEsMTJ6eiIgZmlsbD0iI0NCNTI1RCIgLz4NCgkJCTxwYXRoIGQ9Ik0xMSwxNEwxMywxNEwxMywxMkwxMSwxMnp6IiBmaWxsPSIjQ0I1MjVEIiBvcGFjaXR5PSIwLjMiIC8+DQoJCTwvZz4NCgkJPGcgaWQ9Im92ZXJsYXkiPg0KCQkJPHBvbHlnb24gcG9pbnRzPSIxNiwyNCAxNiwxOSAxMSwxOSAxMSwxNiAxNiwxNiAxNiwxMSAxOSwxMSAxOSwxNiAyNCwxNiAyNCwxOSAxOSwxOSAxOSwyNCIgZmlsbD0iIzUyQjI1MCIgc3Ryb2tlLWxpbmVqb2luPSJtaXRlciIgLz4NCgkJPC9nPg0KCTwvZz4NCjwvc3ZnPg0K")), NScheduleView.AddAppointmentCommand));
// Add the custom command
items.Add(CreateRibbonButton(Nevron.Nov.Graphics.NImage.FromBytes(Nevron.Nov.NConvert.FromBase64String("iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAADXklEQVR4AcWWA7A8RxDGY5YrxWf7HZ5t29jb2LbNv+24HNs531WlFNsuKzx/6d7shbs7t49b9TvOTH/T0/PNHGbm+e01qYa4mXiW+ID4QeV94mniBsJ+2Eo/odelLTQwTBANvSbdvezANNDVBJbJBUsN/jGBFeKtlAPH3fKJ1CFGYIX5OepyHCkUoBc86pSQcDuEgeLUJuZy6IoQBf9cqyMPGDg4ht1X9QJefRHwyXj4lj68uG0ECY/D1HJwpd+o1SHE769KyCm0IKvAgqc2DiOmkYmoS8IbB8eRkW9Bel4lfnhyFuHXUyxM+E85iv/Qm/0LW0dQVGZFpcWO8xZaeKb/a8eZueWcDpRX2lBaYcMDN/chbrBk/xJASvcarekDN/Upg1qsdkz0NQB+WTP958y1KCJZxIaLuwD9ZeDM3vXPtYcenO7H7h5CSbkNlSTglIlm3QxcdVo7Kiw2lJHYvVf3GtWBQjJ4u1EjXscfn5pFBq1rQakVe6/RHpiFcn3kFVmVWnn7wUlEnMKtaWMBGwWNaHYydl3Vg9nhBkReX9RvR8LOmmnGTWd1Aj5FpIgbWIArhYY8a83Ua9WCulVT4RkW8C2BdeI9FvDzOgr4QSiADYZrQEmtXyWggV/Fp0JLFnWmJuA7o+CePWO4TG6DNNaEcfKAvo5adLfWoLWxWqGtqRrdbTXK7+O9DZDHm3CR1Iq7LupC8OC4SMQHLMBjVFBnTrewC7IJKVhtf2L7B8nfkm3YjAqpz9xwo6hwn2MBW4wqf8cVPYqxVFVVmYLd8I4LDd2QuZkFdOuaEKXvy0dnkF1gMS0gt8iCdx4WmlGt0Iq5wM5baOUsmJo91wyCJwutWD2MHPcaHBpKIbU21fDAwuB8FtTV2KnfIkL6xzH/t/Xv4zhw6vGi8yDiXIQ02sRerxSZ3W5PBlU+82/5JVZMDjbi11cXheeA1oXkbqMOPBsEHPAfGMdZsy2ooGzkkhgWVE7LcwbtFtfuMSAoG85c5Wq9K9n3BITG5JNZDM+U4c/8G/2X0hnwie6dEL6TjzFjpSEVE31i4mu5Rz5plXw/xld+jZC6mfh+BYN/nlJgcWGah2/bSwr+zy0adjruMxuYvGUv37YPW8lHte0thEc9RX9W+ZZwqde7djNj/gH1UgAxN3/AxQAAAABJRU5ErkJggg==")),
Nevron.Nov.Graphics.NImage.FromBytes(Nevron.Nov.NConvert.FromBase64String("iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAABsElEQVR4AYWTQ7BjQRSGZz3cjM04Y9u2bdu2bdu29bx83jxzvI79z+munDiVW/Vd/Lf/g0aF0MvyeUJT4ipRTsDLb+ImoQ4zhJifEYjBp2jmfAJWAsmTYP/mN9m+SE08WfsVar7PZuPHcajfRI2M68NFEGn6+3wM6jZSovTRyMAgH9jcgDM5v0/E5+ODUbOBCgeX9oAnfiLccRNxf1c/qV3Z1Ed+B7SjFQHOsiAyplHmSjUUuLZZDoYMemKw1F4eHAjX96AAt7l3MIifIDOZP/k1D5kubuxDCcazxvwTAZyBoouyImUykDCJmMjISeTyA+EAbMbjvf1xaFlP7FrYHTvmS7B7UQ+cWNULj/f0o5bCA+Tyh8jSTKFGU4UGzZXBNCOtWm2FrCYgwB8R4DQL4ue2ud3QpLkGOp0uiGYUZM6YDkDipMAAN0WAOgQYN5XYv0crNGyqhoJMCpUGjZqp0am9HuaP42H9EtRCC94LN1m0EkiahDeHB2LNjC5YOaUzHu3uL6uzBZtfhe7G7KDV+M4rEHH2i0KPQlAlMXga60TW8U5sHuEkXEQBcYFoGDr+P5RkQoMvtntjAAAAAElFTkSuQmCC")), CustomCommand));
}
}
public class CustomCommandAction : NScheduleCommandAction
{
#region Constructors
///
/// Default constructor.
///
public CustomCommandAction()
{
}
///
/// Static constructor.
///
static CustomCommandAction()
{
CustomCommandActionSchema = NSchema.Create(typeof(CustomCommandAction), NScheduleCommandAction.NScheduleCommandActionSchema);
}
#endregion
#region Public Overrides
///
/// Gets the command associated with this command action.
///
///
public override NCommand GetCommand()
{
return CustomCommand;
}
///
/// Executes the command action.
///
///
///
public override void Execute(NNode target, object parameter)
{
NScheduleView scheduleView = GetView(target);
NMessageBox.Show("Schedule Custom Command executed!", "Custom Command", ENMessageBoxButtons.OK,
ENMessageBoxIcon.Information);
}
#endregion
#region Schema
///
/// Schema associated with CustomCommandAction.
///
public static readonly NSchema CustomCommandActionSchema;
#endregion
}
#endregion
}
}