Commanding Overview

In This Topic

NOV Chart for .NET uses the NOV platform commanding model that let you to easily build powerful commanding user interfaces around a chart view. NOV Chart View provides predefined builders for the following command UIs:

All chart commands are defined as static read-only fields in the NChartView class and you can freely reuse them whenever necessary to create your commanding UI. All icons used by the predefined chart ribbon and toolbars are also publicly available. They are exposed by the Nevron.Nov.Chart.NResources static class.

Custom Command Actions

If you want to provide additional functionality to your users, you should create your own custom commands and command actions, which inherit from the NChartCommandAction class. The following example demonstrates how to create a custom command action that shows a message box when executed. This command action is used in the rest of the topics in this chapter for a custom command added to the commanding UI of the chart.

You start by defining a custom command, which you will later use in custom builders. For example, add the following line to a custom type "MyCustomType" in your project:

Define a custom command	Copy Code
public static readonly NCommand CustomCommand = NCommand.Create(typeof(MyCustomType), "CustomCommand", "Custom Command");

After defining a custom command, create a custom command action for it:

Create a custom command action	Copy Code
public class CustomCommandAction : NChartCommandAction { public CustomCommandAction() { } static CustomCommandAction() { CustomCommandActionSchema = NSchema.Create(typeof(CustomCommandAction), NChartCommandActionSchema); } public override NCommand GetCommand() { return MyCustomType.CustomCommand; } public override void Execute(NNode target, object parameter) { NChartView chartView = GetChartView(target); NMessageBox.Show("Chart Custom Command executed!", "Custom Command", ENMessageBoxButtons.OK, ENMessageBoxIcon.Information); } public static readonly NSchema CustomCommandActionSchema; }

Create a custom command action

Copy Code

public class CustomCommandAction : NChartCommandAction
{
    public CustomCommandAction()
    {
    }

    static CustomCommandAction()
    {
        CustomCommandActionSchema = NSchema.Create(typeof(CustomCommandAction), NChartCommandActionSchema);
    }

    public override NCommand GetCommand()
    {
        return MyCustomType.CustomCommand;
    }

    public override void Execute(NNode target, object parameter)
    {
        NChartView chartView = GetChartView(target);
        NMessageBox.Show("Chart Custom Command executed!", "Custom Command", ENMessageBoxButtons.OK, ENMessageBoxIcon.Information);
    }

    public static readonly NSchema CustomCommandActionSchema;
}

Finally add the custom command action to the Commander of the chart view:

Add a custom command action	Copy Code
chartView.Commander.Add(new CustomCommandAction());

For more information about commanding and command builders, check out the topics in the "See Also" section below.

UI

Commanding

Command Builders