CUSTOMIZE command

Opens the Customize dialog box.

BricsCAD Lite; BricsCAD Pro; BricsCAD Mechanical; BricsCAD BIM

Icon:

Alias: CUI

Description

Opens the Customize dialog box.

The Customize dialog box allows you to customize the user interface of BricsCAD.

  1. File
  2. Main customization file
  3. Tab options
  4. Menu Group
  5. Manage your customizations

File

Shows a menu to select customization files or import workspaces.

Load main CUI file...
Opens the Select main CUI file dialog box to select a customization file. See the CUILOAD command.
Save main CUI file as...

Opens the Save main CUI file as dialog box to save the current main CUI file.

Note: You can save the main CUI file under a different name to copy the adapted main CUI file.
Load Partial CUI file...

Opens the Choose a Customization File dialog box to open a partial CUI file.

Note: See chapter Loading a partial CUI file in Loading and unloading CUI files for a detailed explanation about the partial CUI files.
Create new partial CUI file...
Opens the Create a Customization File dialog box to create an empty CUI file.
Import workspace(s)…
Opens the Choose a Customization File dialog box to load one or more workspaces from another CUI file.

Main customization file

Specifies the CUI file that defines customization of the menu, toolbar, and other elements of the user interface.

Note: Aliases and shell commands are defined in a PGP file.
Browse
Opens the Select main CUI file dialog box to load a different main CUI file.
Note: There are three standard CUI files available by default:
  • Modern
  • Classic-ribbon
  • Classic-toolbars
Search
Searches the Available Tools list for command names.

Tab options

Menus

Adds, edits, moves and deletes menu items.

When right clicking a menu, menu item or submenu in the Menus tab, a context menu opens. See the paragraph Options Within the Context Menu for further explanation.

Note: If you select Append item or Insert item from the context menu, the Add menu item dialog box displays.
Menu Group/Menu/Menu Item/Submenu
Displays the options of the selected menu, submenu or menu item.
Title
Specifies the name that is displayed by the menu, menu item or submenu.
Note: You can prefix a letter with ‘&’ to create an Alt-key shortcut. For example: &Line.
ID
Unique identifier for each Menu item. (The ID is assigned by BricsCAD).
Alias
Defines the aliases of the menu. The browse icon opens the Edit Aliases dialog box where you can edit, create or delete aliases.
Diesel
Specifies the Diesel code to be employed by the menu item or submenu.
Tool ID
Identifies the menu item or sub menu to other elements in the CUI file. (The Tool ID is assigned by BricsCAD).
Help
Specifies the help string displayed on the status bar.
Command
Specifies the command(s) or macros.
Image
Specifies the image to display for the menu item or submenu. The browse icon opens the Tool Image dialog box. There are five options to select an image.
Toolbars

Adds, moves and deletes toolbar items.

When right clicking a toolbar, tool, control, flyout or separator in the Toolbars tab, a context menu opens. See the paragraph Options Within the Context Menu for further explanation.

Note: If you select Append tool or Insert tool from the context menu, the Add tool dialog box displays. For options description, see the Add Menu Item dialog box.
Menu Group/Toolbar/Toolbar Button
Displays the options of the selected toolbar, toolbar button, toolbar control or toolbar flyout.
Title
Specifies the name that is displayed by the tooltip.
ID
Unique identifier for each toolbar item. (The ID is assigned by BricsCAD).
Alias
Defines the aliases of the selected item. The browse icon opens the Edit Aliases dialog box where you can edit, create or delete aliases.
Position
Specifies the position of the selected toolbar. You can choose between Floating, Top, Left, Bottom, Right.
Default Display
Determines whether the selected item will be added to the workspace.
Rows
Specifies the number of rows for an undocked toolbar.
Xval Yval

Specifies the distance in pixels measured from the top left corner of the screen to the toolbar. It applies to undocked toolbars.

The values are taken from the X,Y options of the toolbar as they are set in the Workspace tab.

Diesel
Specifies the Diesel code to be employed by the selected item.
Tool ID
Identifies the toolbar item to other elements in the CUI file. (The Tool ID is assigned by BricsCAD).
Help
Specifies the help string displayed on the toolbar.
Command
Specifies the command(s) or macros.
Image
Specifies the image to display for the toolbar button. The browse icon opens the Tool Image dialog box. There are five options to select an image.
Ribbon

Manages the ribbons and/or adds panels to a ribbon tab.

When right clicking a ribbon tab or panel in the Ribbon tab, a context menu opens. See the paragraph Options Within the Context Menu for further explanation.

Note: If you select Add launcher, Insert toggle button or Insert command button from the context menu, the Add ribbon dialog launcher, Add ribbon toggle button or Add ribbon command button dialog boxes display:
  • Select available tool: assigns an existing command to the new item. If this option is selected, the other options are grayed out, except for Available tools.
  • Create new tool: assigns a new command/macro to the new item. If this option is selected, Available tools is grayed out.
  • Toolbox: specifies the toolbox to which to add the new command. You can choose a toolbox in the drop down list.
  • Title: specifies the name of the new tool.
  • Help: specifies the help string displayed on the status bar.
  • Command: specifies the command(s) or macros.
  • Image: specifies the image to display for the new tool. The browse icon opens the Tool Image dialog box. There are five options to select an image
  • Available tools: selects an existing tool.
Menu Group/Ribbon Tab/Ribbon Panel Reference
Displays the options of the selected Ribbon Tab or Ribbon Panel Reference.
ID
Identifies the item in the CUI file. (The ID is assigned by BricsCAD).
Collapse
Allows you to choose if the panel will collapse automatically or if it will never collapse.
Label
Specifies the name that is displayed by the selected Ribbon Tab or Ribbon Panel Reference.
Title
Specifies the name of the selected Ribbon Tab or Ribbon Panel Reference.
Key Tip
Note: Ribbon keytips are not yet implemented in BricsCAD.
Menu Group/Ribbon Panel/Split Button/Ribbon Row Panel/Command Button/Toggle Button
Displays the options of the selected Ribbon Panel, Split Button, Ribbon Row Panel, Command Button or Toggle Button.
ID
Identifies the item in the CUI file. The ID is assigned by BricsCAD.
Label
Specifies the name that is displayed by the selected Ribbon item.
Title
Specifies the name of the selected Ribbon Panel.
Button Style
Specifies the display mode for the selected button. You can choose between Small with text, Small without text, Large with text (vertical), Large with text (horizontal) and Large without text.
Note: The icon size for the small options is 16×16 pixels, while for the large options is 32×32 pixels.
Behavior
Determines how the topmost button behaves when you click on it. You can choose between Drop down, Drop down with recent, Split, Split with recent, Split with recent (static text). The options determine whether the button displays the default command (the first one in the list of buttons), or the most recently used one.
Note: Split buttons let you click the upper half to execute the most-recently-used command, or lower half to display the drop-list (flyout).
List Style
Note: This option is not yet implemented in BricsCAD.
Grouping
Note: This option is not yet implemented in BricsCAD.
Image
Specifies the image to display for the selected Ribbon item.
Resize Style
Note: This option is not yet implemented in BricsCAD.
Resize Priority
Note: This option is not yet implemented in BricsCAD.
Justify Top
Note: This option is not yet implemented in BricsCAD.
Tool ID
Identifies the ribbon item to other elements in the CUI file. (The Tool ID is assigned by BricsCAD).
Help
Specifies the help string displayed on the Ribbon.
Command
Specifies the command(s) or macros.
Keyboard

Assigns different keyboard shortcuts to different commands.

When right clicking a keyboard shortcut in the Keyboard tab, a context menu opens. See the paragraph Options Within the Context Menu for further explanation.

Note: If you select Append shortcut or Insert shortcut from the context menu, the Add keyboard shortcut dialog box displays.
  • Select available tool: assigns an existing command to the new keyboard shortcut. If this option is selected, the other options are grayed out, except for Available tools.
  • Create new tool: assigns a new command/macro to the shortcut. If this option is selected, Available tools is grayed out.
  • Toolbox: specifies the toolbox to which to add the new command. You can choose a toolbox in the drop-down list.
  • Title: specifies the name of the new tool.
  • Help: specifies the help string displayed on the status bar.
  • Command: specifies the command(s) or macros.
  • Image: specifies the image to display for the new tool. The browse icon opens the Tool Image dialog box. There are five options to select an image.
  • Available tools: selects an existing tool.
Menu Group/Keyboard Shortcut
Displays the options of the selected keyboard shortcut.
Key
Specifies the used keyboard shortcut.
Tool ID
Identifies the keyboard item to other elements in the CUI file. The Tool ID is assigned by BricsCAD.
Help
Specifies the help string displayed on the status bar, even though help strings are not displayed by keyboard shortcuts.
Command
Specifies the command(s) to associate with the keyboard shortcut.
Image
Specifies the image to associate with the command, even though images are not used with keyboard shortcuts.
Mouse

Modifies the different actions that are connected to the mouse buttons.

When right clicking a button or button group in the Mouse tab, a context menu opens. See the paragraph Options Within the Context Menu for further explanation.

Note: If you select Append button or Insert button from the context menu, the Add button item dialog box displays.
Alias
Defines the aliases of the selected item. The browse icon opens the Edit Aliases dialog box where you can edit, create or delete aliases.
Button
Specifies the used mouse button.
Tool ID
Identifies the button item to other elements in the CUI file. The Tool ID is assigned by BricsCAD.
Title
Specifies the name that is displayed by the button item.
Help
Specifies the help string displayed on the status bar.
Command
Specifies the command(s) or macros.
Image
Specifies the image to display for the button item. The browse icon opens the Tool Image dialog box. There are five options to select an image.
Tablet

Customizes the tablet options.

When right clicking a button or button group in the Tablet tab, a context menu opens. See the paragraph Options Within the Context Menu for further explanation.

Note: When you choose Append button or Insert button from the context menu, the Add button item dialog box displays.
Menu Group/Button Group
Displays the options of the selected button group.
Alias
Defines the aliases of the selected item. The browse icon opens the Edit Aliases dialog box where you can edit, create or delete aliases.
Quad

Adds commands to the quad tab or move commands to other tabs.

When right clicking a quad tab or quad button in the Quad tab, a context menu opens. See the paragraph Options Within the Context Menu for further explanation.

Note: If you select Append quad button or Insert from the context menu, the Add quad button dialog box displays.
  • Select available tool: assigns an existing command to the new quad button. If this option is selected, the other options are grayed out, except for Available tools.
  • Create new tool: assigns a new command/macro to the new quad button. If this option is selected, Available tools is greyed out.
  • Toolbox: specifies the toolbox to which to add the new command. You can choose a toolbox in the drop-down list.

  • Title: specifies the name of the new tool.
  • Help: specifies the help string displayed on the status bar.
  • Command: specifies the command(s) or macros.
  • Image: specifies the image to display for the new tool. The browse icon opens the Tool Image dialog box. There are five options to select an image.
  • Available tools: selects an existing tool.
ID
Identifies the Quad item in the CUI file. The ID is assigned by BricsCAD.
Title
Specifies the name that is displayed by the Quad button.
Help
Specifies the help string displayed on the Quad.
Command
Specifies the command(s) or macros related to the Quad button.
Image
Specifies the image to display for the Quad button. The browse icon opens the Tool Image dialog box. There are five options to select an image.
Entity Filter
Specifies which items will be displayed in the Quad, depending on the type of the entity.
Properties

Edits which properties are shown for different kinds of entities.

Note: These properties will only be shown when the ROLLOVERTIPS system variable is ON.
Rollover
Specifies which properties should be displayed.
Workspaces

Controls which menu tabs are visible in different workspaces.

When right clicking an item in the Workspace tab, a context menu opens. See the paragraph Options Within the Context Menu for further explanation.

Name
Shows the name of the workspace displayed in the workspace list in the status bar and by the Workspace toolbar (reported by the WSCURRENT system variable).
Display
Determines if the workspace name is displayed by the status bar and toolbar drop lists.
Description
Help-like description displayed in the status bar.
ID
Identifies the workspace item in the CUI file. The ID is assigned by BricsCAD.
Menu Bar
Toggles the display state of the menu bar. See also MENUBAR (EXCEPT OS X) system variable.
Scrollbars
Toggles the display of scroll bars. See also the WNDLSCRL system variable.
Default
Toggles whether this workspace is the default one when BricsCAD starts.
  • Yes: shows this workspace when BricsCAD starts.
  • No: does not show this workspace.
Stack Type
Determines how panels are displayed. See also the STACKPANELTYPE system variable.
Panel Button Size
Specifies the initial size of buttons on panels.
Quad Button Size
Specifies the initial size of buttons on Quad.
Ribbon Tool Size
Specifies the initial size of buttons on Ribbon.
Tool Button Size
Specifies the initial size of buttons on tools.
Note:
  • Small: displays 16×16 icons.
  • Large: displays 24×24 icons.
  • Extra large: displays 32×32 icons.
Ribbon Panel Margin
Specifies the size of blank space at ribbon panel edges, measured in pixels. See also the RIBBONPANELMARGIN system variable.
Toolbar Margin
Specifies margin above and below each toolbar, measured in pixels. See also the TOOLBARMARGIN system variable.
Tool Icon Padding
Specifies margin between icons on each toolbar, measured in pixels.
Delete Tool
Specifies what to do with tool entities following the SUBTRACT command. See also the DELETETOOL system variable.
DMAUDIT Detail Level
Specifies messages to display. See also the DMAUDITLEVEL system variable.
DMPUSHPULL Subtract
Specifies whether to enable subtract mode in the DMPUSHPULL command. See also the DMPUSHPULLSUBTRACT system variable.
Extrude Inside
Determines how to modify the parent entity when it intersects with the extruded/revolved entity when the Auto option of the EXTRUDE and REVOLVE command is selected. See also the EXTRUDEINSIDE system variable.
Extrude Outside
Determines how to modify the parent entity when it touches the extruded/revolved entity when the Auto option of the EXTRUDE and REVOLVE command is selected. See also the EXTRUDEOUTSIDE system variable.
Generate Associative Attributes
Specifies whether associative attributes are generated for 3D entities. See also the GENERATEASSOCATTRS system variable.
Generate Associative Drawings
Specifies associativity between the 3D model and generated views (VIEWBASE) and calculated drawings (BIMSECTIONUPDATE). See also the GENERATEASSOCVIEWS system variable.
Intersected Entities
Determines how to modify entities that intersect with the extruded/revolved entity when the Auto option of the EXTRUDE or REVOLVE command is selected. See also the INTERSECTEDENTITIES system variable.
Report Panel Mode
Specifies the mode of report panel. Applicable only for commands which support it. See also the REPORTPANELMODE system variable.
Selection Modes
Specifies the subentities to highlight during entity selection. See also the SELECTIONMODES system variable.
Sheet Set Manager Auto Open
Toggles whether the Sheet Sets panel is opened automatically when a drawing from a sheet set is opened.
Structure Tree Config
Names the CST structure tree configuration file to use.
Unite Surfaces
Determines whether adjacent extruded/revolved surfaces are united or not. See also the UNITESURFACES system variable.
Components Config
Names the CCF components configuration file to use.
Menu Group
Allows you to choose from the available menu groups.
Title
Shows the name of the menu displayed on the menu bar.
Diesel
Executes Diesel code when you select the menu.
Command Aliases

Customize aliases and add them to different commands.

When right clicking an item in the Command Aliases tab, a context menu opens. See the paragraph Options Within the Context Menu for further explanation.

Note: If you select Add alias or Edit alias from the context menu, the Add alias or Edit alias dialog box displays where you can add or edit an alias.
Alias

Specifies the name of the alias, a command abbreviation.

Note: The list of Aliases and commands will be ordered alphabetically according to the aliases when you click on Alias.
Command

Specifies the command to which the alias is assigned.

Note: The list of Aliases and commands will be ordered alphabetically according to the commands when you click Command.
Add
Adds an alias.
Edit
Edits the selected alias.
Delete
Deletes the selected alias.
Commands
Lists all the available commands to add an alias to.
Shell Commands

Create and edit shell commands. Shell commands run programs external to BricsCAD.

When right clicking an item in the Shell Commands tab, a context menu opens. See the paragraph Options Within the Context Menu for further explanation.

Note: If you select Add shell command or Edit shell command from the context menu, the Add shell command or Edit shell command dialog box displays where you can add or edit a shell command.
Alias
Specifies the name of the shell command; this is the command you enter at the ' : ' prompt.
Shell Command

Specifies the operating system command to execute, or program to run.

To run a program, use the Start prefix, as in Start Notepad.exe.

Prompt
Specifies the prompt to display in the Command line, for example: Enter file to edit:.
Flags

Determines how the shell command operates:

  • Don’t wait: BricsCAD immediately returns to the command prompt without waiting for the application to finish.
  • Minimized: the application runs minimized.
  • Hidden: the application does not appear on the screen.
  • Quotes: the shell command uses quotations when the command string uses spaces, such as C:\cad programs\file name.exe.
Add
Adds a shell command through a dialog box.
Edit
Edits the shell command through a dialog box.
Delete
Deletes the selected shell command. Gives a warning where you can confirm you to delete the selected item.
Options Within the Context Menu
The following options appear when you right click on an item:
Append…
Adds the mentioned item below the last item.
Insert…
Adds the mentioned item above the selected item.
Add…
Adds the mentioned item in alphabetical order.
Delete…
Deletes the menu, submenu, item or separator selected item. Gives a warning where you can confirm you to delete the selected item.

Manage your customizations

Displays the Manage Customizations dialog box to confirm and reverse changes made to the user interface.