Welcome
Collapse Getting StartedGetting Started
Overview
Expand Types of SolidWorks API ApplicationsTypes of SolidWorks API Applications
Expand SolidWorks API Object Model and Class HierarchySolidWorks API Object Model and Class Hierarchy
Collapse Programming with the SolidWorks APIProgramming with the SolidWorks API
Add-in Toolbars
API Dependent on SolidWorks Being Visible
Attributes Imported from ACIS SAT Files
Bitmasks
Block Definitions and Block Instances
Bodies in Body Folders
BOOL and VARIANT_BOOL
Bounding Box and Note Text
COM vs. Dispatch
CommandManager and CommandGroups
Components, Configurations, and Suppression States
Compound Note
ComVisibleAttribute in VSTA macros
Controls, Visual Basic 6.0, and Windows XP
Expand Double Arrays and Integer PairsDouble Arrays and Integer Pairs
Drawing Views and Model Entities
Early and Late Binding
Expand EventsEvents
Features of Components
Helper Functions
Hole Wizard Features and Objects
IDispatch Object Arrays as Input in .NET
Implementation Guidelines
Import and Export File Options
In-process Methods
Instantiate ActiveX Controls as Tabs
Interface Pointers
Keystrokes and Accelerator Keys
Library Features and Objects
Lightweight Components
Line Attributes for View::GetPolyLinesAndCurves
Line Weights
Expand Macro FeaturesMacro Features
Manipulators
Mass Properties
Expand Multibody PartsMultibody Parts
Option Explicit Statement
Partition Rollback and API Handles
Persistent Reference IDs
Presentation Transforms
Expand PropertyManager PagesPropertyManager Pages
.NET Interop Assemblies
Quick Tips and Bubble ToolTips
Return Values
Expand SafeArraysSafeArrays
Selection Criteria
Selection Lists
Selections that Define Features
Setup Project to Distribute SolidWorks Add-in
Smart Pointers
SolidWorks Objects
SQLite
Suspend Automatic Rebuilds
swdisp.cpp and swdisp.h Files
System Options and Document Properties
Tessellation and Edges
Tracking IDs
Expand Type LibrariesType Libraries
Units
Unmanaged C++ and C++/CLI Code
VBA and SolidWorks x64
Examples and Projects
Expand SolidWorks API HelpSolidWorks API Help
Expand FeatureWorks API HelpFeatureWorks API Help
Expand SolidWorks Document Manager API HelpSolidWorks Document Manager API Help
Expand eDrawings API HelpeDrawings API Help
Expand SolidWorks Routing API HelpSolidWorks Routing API Help
Expand SolidWorks Simulation API HelpSolidWorks Simulation API Help
Expand SolidWorks Utilities API HelpSolidWorks Utilities API Help
Expand SolidWorks Workgroup PDM API HelpSolidWorks Workgroup PDM API Help
Expand PhotoWorks API HelpPhotoWorks API Help
Expand SolidWorks Toolbox Browser API HelpSolidWorks Toolbox Browser API Help
Hide Table of Contents

CommandManager and CommandGroups

You can create native SolidWorks toolbars and menus using the ICommandManager and ICommandGroup interfaces.
 

NOTE: You can only create one CommandManager in an add-in application; however, multiple CommandGroups can exist in an add-in application. See SolidWorks Help for details about the CommandManager.

The CommandManager-style toolbars and menus let you:

  • Add toolbars to the SolidWorks CommandManager.

  • Drag your toolbar buttons to and from other API and native SolidWorks toolbars using the Tools, Customize dialog or ISldWorks::DragToolbarButton.

  • Create flyout toolbars and submenus.

Toolbar and menu setup are binded so that name, button, callback function, enable function, and add-in ID need only be specified once.

You cannot create a ICommandGroup with a toolbar, start SolidWorks, use the toolbar, close SolidWorks, add items to or remove items from the toolbar, and start SolidWorks. Therefore, during development, you must use the ID returned by ICommandGroup::ToolbarId to find the toolbar in the registry and remove the toolbar definition from the registry:

HKEY_CURRENT_USER\Software\SolidWorks\SolidWorks <version>\User Interface\Custom API Toolbars\<index>

HKEY_CURRENT_USER\Software\SolidWorks\SolidWorks <version>\User Interface\Toolbars

HKEY_CURRENT_USER\Software\SolidWorks\SolidWorks <version>\User Interface\Toolbars\PartTool

HKEY_CURRENT_USER\Software\SolidWorks\SolidWorks <version>\User Interface\Toolbars\AssemblyTool

HKEY_CURRENT_USER\Software\SolidWorks\SolidWorks <version>\User Interface\Toolbars\DrawingTool

You can then add and remove items from the toolbar.

For distribution purposes, assign the ICommandGroup a different user ID and do not activate the ICommandGroup using the former user ID. This is the ID of ICommandManager::CreateCommandGroup. You must keep track of the toolbar user IDs in use in each version of your add-in. The user ID and the GUID of the CoClass implementing ISwAddin are a unique pair.

To add commands:

  1. Create the ICommandManager using ISldWorks::GetCommandManager.

    NOTE:
    You might want to declare this object as a class variable in your add-in so that it can be accessed from anywhere later.

  2. Create one or more top-level CommandGroups using ICommandManager::CreateCommandGroup or ICommandManager::AddContextMenu.

  3. Add bitmap files of the images of buttons to the CommandGroups using ICommandGroup::LargeIconList, ICommandGroup::SmallIconList, ICommandGroup::LargeMainIcon, and ICommandGroup::SmallMainIcon.

    NOTE:
    You only add the bitmap files to the top-level group. These files provide the images of the buttons for all of the CommandGroups.

  4. Add commands to the CommandGroups using ICommandGroup::AddCommandItem2.

  5. Enable or disable toolbars or menus for specific CommandGroups using ICommandGroup::HasToolbar and ICommandGroup::HasMenu.

  6. Create context-sensitive menus using ICommandGroup::SelectType and ICommandGroup::CustomNames, if the selected object is a custom feature such as an attribute.

  7. Activate the top-level ICommandGroup using ICommandGroup::Activate.

To remove commands:

Use ICommandManager::RemoveCommandGroup for all CommandGroups created with ICommandManager::CreateCommandGroup and ICommandManager::AddContextMenu.

 



Provide feedback on this topic

SOLIDWORKS welcomes your feedback concerning the presentation, accuracy, and thoroughness of the documentation. Use the form below to send your comments and suggestions about this topic directly to our documentation team. The documentation team cannot answer technical support questions. Click here for information about technical support.

* Required

 
*Email:  
Subject:   Feedback on Help Topics
Page:   CommandManager and CommandGroups
*Comment:  
*   I acknowledge I have read and I hereby accept the privacy policy under which my Personal Data will be used by Dassault Systèmes

Print Topic

Select the scope of content to print:



x

We have detected you are using a browser version older than Internet Explorer 7. For optimized display, we suggest upgrading your browser to Internet Explorer 7 or newer.

 Never show this message again
x

Web Help Content Version: API Help (English only) 2010 SP05

To disable Web help from within SOLIDWORKS and use local help instead, click Help > Use SOLIDWORKS Web Help.

To report problems encountered with the Web help interface and search, contact your local support representative. To provide feedback on individual help topics, use the “Feedback on this topic” link on the individual topic page.