XCAD.NET
XCAD.NET
Framework for .NET (C# and VB.NET) to create modern application for CAD systems (SOLIDWORKS, SOLIDWORKS Document Manager, Autodesk Inventor, etc.)
Get technical support Connect to xCAD community on Discord server Explore code and application examples xCAD.NET Templates for Visual Studio and VS Code Access source code

Hosting SOLIDWORKS commands in menu, toolbar and context menu using xCAD


Defined commands can be hosted in different locations of SOLIDWORKS commands area: command group, which includes menu, toolbar and command tab box (ribbon) as well as in the context menu

Command Group

In order to add command group it is required to call the AddCommandGroup method and pass the enumeration type as a generic parameter.

It is required to provide the void handler function with a parameter of enumerator which will be called by framework when command is clicked.

this.CommandManager.AddCommandGroup<CommandsA_e>().CommandClick += OnCommandsAButtonClick;
this.CommandManager.AddCommandGroup<CommandsB_e>().CommandClick += OnCommandsBButtonClick;
this.CommandManager.AddCommandGroup<CommandsC_e>().CommandClick += OnCommandsCButtonClick;
private void OnCommandsAButtonClick(CommandsA_e cmd)
{
    //handle the button click
}

private void OnCommandsBButtonClick(CommandsB_e cmd)
{
    //handle the button click
}

private void OnCommandsCButtonClick(CommandsC_e cmd)
{
    //handle the button click
}

Commands displayed in the SOLIDWORKS menu
Commands displayed in the SOLIDWORKS menu

By default command will be added to menu and toolbar. This behavior can be changed by assigning the hasMenu boolean parameter of the CommandItemInfoAttribute attribute.

Toolbar

Commands displayed in the SOLIDWORKS toolbar
Commands displayed in the SOLIDWORKS toolbar

By default command will be added to menu and toolbar. This behavior can be changed by assigning the hasToolbar boolean parameter of the CommandItemInfoAttribute attribute.

Command Tab Box

Commands added to command tab box
Commands added to command tab box

Command item can be added to tab box by setting the showInCmdTabBox parameter of CommandItemInfoAttribute to true for the specific command defined in the enumeration.

textStyle parameter allows to specify the alignment of the hint text relative to the icon.

Text display styles in command tab box
Text display styles in command tab box

  • Icon only (without text) (NoText)
  • Text below icon (TextBelow)
  • Text to the right to icon, aligned horizontally (TextHorizontal)

using Xarial.XCad.UI.Commands.Attributes;
using Xarial.XCad.UI.Commands.Enums;

public enum CommandsC_e
{
    [CommandItemInfo(true, true, WorkspaceTypes_e.Assembly,
        true, RibbonTabTextDisplay_e.NoText)]
    CommandC1,

    [CommandItemInfo(true, true, WorkspaceTypes_e.AllDocuments,
        true, RibbonTabTextDisplay_e.TextBelow)]
    CommandC2,

    [CommandItemInfo(true, true, WorkspaceTypes_e.AllDocuments,
        true, RibbonTabTextDisplay_e.TextHorizontal)]
    CommandC3,
}

Context Menu

Commands displayed in the context menu
Commands displayed in the context menu

In order to add context menu it is required to call the AddContextMenu method and pass the enumeration as a template parameter.

It is required to provide the void handler function with a parameter of enumeration which will be called by framework when command is clicked.

It is optionally required to specify the selection type of where this menu should be displayed.

this.CommandManager.AddContextMenu<CommandsD_e>().CommandClick += OnCommandsDContextMenuClick;
this.CommandManager.AddContextMenu<CommandsE_e>().CommandClick+= OnCommandsEContextMenuClick;
private void OnCommandsDContextMenuClick(CommandsD_e cmd)
{
    //handle the context menu click
}

private void OnCommandsEContextMenuClick(CommandsE_e cmd)
{
    //handle the context menu click
}


Powered by Docify