Configuring macro buttons in Toolbar+ add-in for SOLIDWORKS
Adding Macro Buttons And Toolbars
Macro buttons can be configured by clicking on 'Configure Custom Toolbars...' command in Toolbar+ menu in SOLIDWORKS
Configuration dialog is displayed and existing toolbar and buttons can be modified as well as new can be added.
Click on green plus (+) button to add new toolbar or macro button.
Configure the parameters as shown below:
Configuring Macro Buttons In Toolbar
- Path to toolbar file. This setting is stored locally to the user. UNC path is supported if required to configure a shared toolbar
- Add new toolbar
- Add new macro button in toolbar
- Title of the macro button. It displayed as a bold header in the tooltip when mouse hovers a button in SOLIDWORKS toolbar
- Description of the macro button. It displayed as a sub-header in the tooltip and in the SOLIDWORKS task bar in the bottom right corner when mouse hovers a button in SOLIDWORKS toolbar
- Path to icon of the macro button. Raster image files - optimal size is between 16x16 and 120x120 in PNG format, however image will be automatically scaled and aligned which allows support for any size (including different width and height). Transparency is supported. Scalable Vector Graphics images in SVG (recommended option). Provides the best quality for icons as it will be scaled without quality loss depending on the resolution of the screen and button sizes.
- Full path to macro to run
- Macro entry point. This is the subroutine which should be run first when executing the macro. This is a parameterless subroutine (usually named main). Toolbar+ will try to automatically find the best suitable subroutine
- Macro custom arguments. See arguments article for more information
- Triggers. Macro trigger options. Follow triggers article for more information
- Command scope. Identifies the scope (part, assembly, drawing, no documents) where macro can be run. Macro will be disabled in the not selected environments
- Command location. Identifies where command should be added (menu, toolbar, tab box). This option is only available for Button and Toggle Button triggers
- Toggle Button State Code group - options for handling the state of toggle button if Toggle Button trigger is specified. Follow Toggles article for more information.
- Unload After Run. If option is checked macro will be automatically unloaded after run. This option is useful when macro is shared across different users. In this case macro wil lbe released immediately enabling the possibility to replace the macro with new version. This option cannot be used if macro displays User Form as in this case it will be immediately unloaded and form will be closed. Untick this option if macro uses User Form or any other popup Window.
It is possible to use relative path for icon and macro path options. Use ..\ to indicate the relative path to the toolbar.setts file. This is in particular useful when toolbar settings are moved across the computers or setup in the shared environment
- Toolbar title to be displayed in the SOLIDWORKS toolbars manager
- Toolbar tooltip
- Toolbar icon
- Preview of toolbar icon (default icon)
Select macro buttons and toolbars to load and edit the parameters. Use context menu or commands box to reorganize the commands as shown below.
- Move selected macro button to the left or move toolbar up
- Move selected macro button to the right or move toolbar down
- Add new macro button left to the selected macro button or add new toolbar above the selected toolbar
- Add new macro button right to the selected macro button or add new toolbar below the selected toolbar
- Remove selected macro button or toolbar
- Save changes and close dialog
- Close dialog without saving changes
If toolbar configuration changed the following message is displayed and SOLIDWORKS needs to be restarted for settings to take effect (unless toolbar is read-only in multi-user environment).
Toolbar+ attempting to preserve the IDs of the buttons to keep the customization. However SOLIDWORKS might need to clear the IDs after toolbar has been changed. When toolbar is changed and new commands are added or removed it might be required to restart SOLIDWORKS twice after the toolbar change to correctly display the commands within the toolbar.
Accessing Macro Buttons
Toolbars are available in the SOLIDWORKS toolbars list:
and in the SOLIDWORKS menu.
If command is added to Tab Box (ribbon) all the toolbars will be added under the Toolbar+ command tab box. Individual toolbars will be separated.
Toolbars can be reorganized and placed into the SOLIDWORKS command manager area. Visit Customization page for additional customization options for the toolbars and commands.