Setting tool settings for a custom tool


 Product:MicroStation
 Version:08.09.04.51
 Environment:N\A
 Area:Configuration
 Subarea:Workspaces

Problem

Setting tool settings for a custom tool.
How do I set tool settings for a custom tool?

Solution

Key-in SET ITEM TOOLSETTINGS

Get the possible settings:

  1. Start desired tool.
  2. Open Key-in dialog (Utilities > Key-in), and make it is expanded completely so you can see the 4 separate windows
  3. Type SET ITEM TOOLSETTINGS but do not press the <(><<)>Enter> key.
  4. The fourth column displays the possible settings.
  5. Make a note of the setting that is desired to be changed.
  6. In the Customize dialog box (Workspace > Customize), click the Tools tab.
  7. Expand the User Tools section and expand the open DGN file.
  8. Expand the tool box containing the tool to which you are adding settings.
  9. Select the tool to which you are adding settings.
  10. Add Dialog Item Settings.
  11. In the Dialog Item Name field, replace ToolSettings.ItemName with the name of the first setting.
  12. Set the type as needed.
  13. Enter the value desired

Example:
Creating a custom tool for "Place LIne Constrained" and want to enable
the Length and set it to 10.0 units.

Command Data
Key-in: PLACE LINE CONSTRAINED

Item Settings
Dialog Item Name: ToolSettings.lengthtoggle
Type: Literal
Value: 1

Item Settings
Dialog Item Name: ToolSettings.length
Type: Distance
Value: 10.0

Notes:

It is possible to make a key-in and include the tools settings.
Using the above example:
Key-in: PLACE LINE CONSTRAINED;SET ITEM TOOLSETTINGS LENGTHTOGGLE=1;SET
ITEM TOOLSETTINGS LENGTH=10.000

For Type, use "literal" for toggles and drop down settings.
Toggles are 1 = On, 0 = Off.
Drop downs are 0 = first choice, 1 = second choice, 2 = third choice, and so on.

See also

Refer to the help on Custom tools

> Help > Contents > Setting Up Projects > Workspaces > Customizing the User Interface > Tools

Other language sources

 Original Author:Bentley Technical Support Group