add_button
add_button
{ -name s_name -command s_cmdText | -separator }
[ -toolbar s_name ]
[ -index i_position ]
[ -icon_label s_label [ -font s_fontName ] [ -size i_size ][ -icon s_index ] ]
| -icon_file s_fileName ]
[ -force_width i_pixel -force_height i_pixel ]
Description
Adds a button or a vertical separator to a toolbar.
Arguments
|
-command s_cmdText
|
Specifies the Tcl commands to invoke when you click the button. The string must be enclosed in quotes. Multiple commands can be included, separated by the semicolon (;) character.
|
|
-font s_fontName
|
Specifies the font type to use for the label.
|
|
-force_height i_height
|
Sizes the height, in pixels, for an icon that is given by -icon_file. If this argument is not given, the icon is sized to standard dimensions.
|
|
-force_width i_width
|
Sizes the width, in pixels, for an icon that is given by -icon_file. If this argument is not given, the icon is sized to standard dimensions.
|
|
-icon i_index
|
Specifies the index for the icon to use or, if -icon_label is given, the color scheme to use for the icon.
|
|
-icon_file s_fileName
|
Specifies the file that contains the icon to display for the button.
|
|
-icon_label s_label
|
Draws the icon as a rectangular button containing the label. For multi-line labels, use "\n". For example, "line1\nline2".
|
|
-index i_position
|
Specifies the position in the toolbar to place the button or separator. By default, the button or separator is added after the last button/separator. A value of 0 is the first position in the toolbar.
|
|
-name s_name
|
Specifies the name to assign to the button. This name is displayed when you move the cursor over the button in the toolbar.
|
|
-separator
|
Adds a vertical line separator to the toolbar. By default, the separator is added after the last button/separator but can be placed using -index.
|
|
-size i_size
|
Specifies the point size for a label given by -icon_label.
|
|
-toolbar s_name
|
Specifies the name of the toolbar to add the button to. The Space-based Router and Chip Optimizer built-in toolbars are named: Standard, View, Edit, Panels, Advanced Editing, View Context Quick Navigator, Annotate, and User-defined. If you specify a toolbar other than one of the built-ins, the toolbar will be created. If you do not include this argument, the button is added to the User-defined toolbar.
|
Examples
The following command adds an icon button labeled TDSP to the User-defined toolbar. When you click the TDSP button, the tdsp design will be opened.
add_button -name load_tdsp -command "read_db -lib tdsp_library -cell tdsp -view layout" -icon_label TDSP
The following command adds a blue icon button to the Bold toolbar. When the button is clicked, highlight sets are created to use with remaster_via.
add_button -name add_highlights -command "add_highlight -color red -name NEW_VIAS_PUSHED; add_highlight -color blue -name NEW_VIAS; add_highlight -color purple -name UNFIXED_VIAS" -icon 2 -toolbar Bold
Related Topics
Window Commands
Return to top
