Liren Large Software Subsidy 13/13.iso/p/p036/15.ddi/CONFIGUR.TXT

Text File | 1992-07-01 | 54.0 KB | 1,861 lines

Configurability Tools


Configurability Tools are used to customize MicroStation's
graphical user interface. These tools are designed to be used by
MicroStation users who do not have any programming knowledge.

* Face Lifter is used to customize dialog boxes and settings
  boxes.

* Menu Manager is used to customize the pull-down menus in the
  Command Window.

* Palette Manager is used to customize tool palettes.

To use the configurability tools, start MicroStation and load the
MDL CFGTOOLS application.

To load CFGTOOLS:

* In the MDL settings box, select CFGTOOLS and click the Load
  button.

  or

  Key in MDL LOAD CFGTOOLS.

Upon loading, CFGTOOLS closes all view windows and inserts the
ConfigTools sub-menu in the Applications menu. (CFGTOOLS creates
the Applications menu if it does not yet exist.) The ConfigTools
sub-menu has items for loading Face Lifter, Menu Manager, and
Palette Manager.

Note:
  These tools are implemented as MDL applications - see "Files"
  below.


Files

The Configurability Tools software consists of the following
files:

        File             Description
        ----------------------------
        "cfgtools.ma"    MDL CFGTOOLS application

        "facelift.ma"    MDL FACELIFT application (Face Lifter)

        "menubld.ma"     MDL MENUBLD application (Menu Manager)

        "palbld.ma"      MDL PALBLD application (Palette Manager)

        "palload.ma"     MDL PALLOAD application

These files are installed in MicroStation's "mdlapps" directory.



Customizing Dialog Boxes with Face Lifter


Face Lifter lets you customize a dialog box (or settings box) by:

* Changing its name.

* Changing its size.

* Changing the identifying label of any of its controls (check
  buttons, option menus, text fields, etc.).

* Changing the location of any of its controls.

* Changing the size of any of its controls.

* Enabling or disabling any of its controls.

* Preventing the display of any of its controls.


Here is the general procedure for customizing dialog boxes:

1.Load Face Lifter.

2.Select and open a dialog box.

3.Make the desired alterations using the window that contains a
  copy of the open dialog box, along with other Face Lifter
  windows.

4.Test the dialog box.

5.Save the dialog box.

6.Repeat steps 2-5 for each additional dialog box you want to
  customize.

7.Make the dialog boxes changes available in MicroStation.

For detailed procedures, see the following sections.


Loading Face Lifter

To load Face Lifter:

* From the Applications menu's ConfigTools sub-menu, choose Face
  Lifter.

  or

  Key in MDL LOAD FACELIFT.

  Upon loading, Face Lifter opens the Face Lifter settings box
  and the Open Dialog Box Resource dialog box.


Selecting a dialog box

To select and open a dialog box for customization:

1.Select the dialog box by name in the Open Dialog Box Resource
  dialog box.

2.Click the OK button.

  A window containing a facsimile of the selected dialog box
  opens; windows of this type are referred to as facsimile
  windows. The name of the dialog box appears for editing in the
  Dialog Box Title field of the Face Lifter settings box.

Tip:
  It is possible to open multiple dialog boxes but only one is
  selected for customization. This dialog box is indicated by
  handles in its facsimile window. To select a different dialog
  box, click in its facsimile window. The Dialog menu in the Face
  Lifter settings box is used to close and open facsimile windows
  for open dialog boxes.

Note:
  The specifications for a dialog box are stored as a resource in a
  resource file. The filename at the top of the Dialog Information
  section of the Face Lifter settings box identifies the resource
  file in which the resource for the selected dialog box (the
  dialog box resource) is stored. MicroStation's resource file,
  "ustation.rsc," contains all of MicroStation's resources - dialog
  box resources plus key-in definitions, error messages, and
  prompts. Because the resource file does not contain executable
  code, the task of localizing MicroStation - that is, creating a
  non-English-language version - is simply a matter of translating
  the resource file.

Face Lifter prevents you from making unwanted changes to
MicroStation's resource file by placing customized dialog box
resources in a separate resource file, "ustation.fac." For more
information, see "Making dialog box changes effective in
MicroStation" below.


Changing a dialog box's name

To change the name of the selected dialog box:

* Key in the new name in the Dialog Box Title field of the Face
  Lifter settings box.

  Face Lifter displays the new name in the title bar of the
  facsimile window.


Changing a dialog box's size

To change the size of the selected dialog box:

* Drag in the resize border of the facsimile window.

  or

  In the Width and Height fields in the Dialog Information area
  of the Face Lifter settings box, key in the desired width and
  height (in dialog coordinate units).

  Face Lifter resizes the facsimile window accordingly.


Selecting an item in a dialog box

Dialog boxes contain controls such as text fields, check buttons,
and option menus. MDL programmers refer to these controls as
items.

Face Lifter uses MDL programming terminology to denote item
types. The following table shows important differences between
this terminology and MicroStation user terminology:

    MDL Term          MicroStation Term
    -----------------------------------
    Toggle Button     check button
    Option Button     option menu
    Push Button       button


To select an item for customization:

1.Select the dialog box that contains the item (if the dialog
  box is not already selected).

2.Click the desired item.

OR

1.Open the Dialog Box Item List settings box (if it is not
  already open) by choosing List from the Item menu in the Face
  Lifter settings box.

2.Select the desired item in the Dialog Box Item List settings
  box.

  Face Lifter highlights the item and displays a handle that
  enables you to dynamically change the item's size. Item
  information, such as the item's type, size, and location, is
  displayed in the Item Information section of the Face Lifter
  settings box.

Note:
  Some dialog box items overlap. For example, a group box item that
  delineates a section of a dialog box will have one or more items
  within it. To make an item in a group box visible for selection,
  <Ctrl>-click in the area in which the item is located. Then you
  can select the item by clicking it. An easier way to select an
  item in a group box may be to use the Dialog Box Item List
  settings box.

To select multiple items (for move and align operations):

* Drag a selection rectangle around the item. The Item Selection
  setting in the Item Settings box controls whether the
  selection includes items inside, outside, or overlapping the
  rectangle.

To add a single item to an existing group of selected items:

* Shift-click the item.

To select all items:

* From the Edit menu in the Face Lifter settings box, choose
  Select All.


Changing an item's label

Each item has a label that identifies the item in the dialog box.
To change the label of the selected item:

* In the Item Label field of the Face Lifter settings box, key
  in the new label.

  Face Lifter displays the new name in the facsimile window.


Changing an item's location

To change the location of the selected item:

* Drag the item in the facsimile window.

  or

  In the X Origin and Y Origin fields in the Face Lifter
  settings box, key in the coordinates (relative to the upper
  left corner of the dialog box) to which to move the item.

  Face Lifter displays the item at the specified location in the
  facsimile window.


Changing an item's size

To change the size of the selected item:

* Drag the item's size handle in the facsimile window.

  or

  In the Width and Height fields in the Item Information area of
  the Face Lifter settings box, key in the desired width and
  height (in dialog coordinate units).

  Face Lifter resizes the item accordingly in the facsimile
  window.


Controlling user access to an item

MicroStation temporarily disables various dialog box items on a
situational basis. The Enabled and Hidden check buttons in the
Item Information section of the Face Lifter settings box let you
control user access to dialog box items.

To disable the selected item in MicroStation:

* Turn off Enabled.

To disable the selected item and prevent the item from being
displayed:

* Turn on Hidden.


Testing a dialog box

The facsimile window can be used to test the operation of the
open dialog box.

1.In the Face Lifter settings box, turn on Simulate.

  Face Lifter makes the dialog box items available for testing
  in the facsimile window.

2.Use the mouse (or other supported pointing device) and
  keyboard to test the operation of the dialog box.

3.When done, turn off Simulate in the Face Lifter settings box.


Saving a dialog box

To save a dialog box:

* From the File menu in the Face Lifter settings box, choose
  Save.


Making dialog box changes effective in MicroStation

To make changes to saved MicroStation dialog boxes effective in
MicroStation:

* Load the MDL application PALLOAD.

  - In the MDL settings box, select PALLOAD and click the Load
  button.

  or

  - Key in MDL LOAD PALLOAD.

Tip:
  Make PALLOAD a DGNAPP (one that is loaded whenever a design file
  is opened) by adding it to the definition of the MS_DGNAPPS
  environment variable. Then all you will need to do to make
  MicroStation dialog box changes effective in MicroStation is exit
  Face Lifter.

Note:
  When PALLOAD is loaded, Face Lifter will not save changes to
  MicroStation dialog boxes. To enable saving, you must click the
  OK button in the alert box that notifies you that Face Lifter is
  operating in read-only mode and then restart MicroStation. This
  prevents PALLOAD from loading modified dialog boxes. To reenable
  PALLOAD, delete "ustation.lck" from the directory that contains
  "userpref.rsc."

To make changes to saved dialog boxes of an MDL application
effective in MicroStation:

1.Choose Exit from the File menu in the Face Lifter settings box
  to unload Face Lifter.

2.Exit MicroStation.

3.Replace the application (for example, "analyze.ma") with the
  copy created by Face Lifter (for example, "analyze.fac").

  For example, on the PC, enter the following at the DOS prompt:

  C:\USTATION> copy analyze.ma analyze.xma

  C:\USTATION> copy analyze.fac analyze.ma

4. Restart MicroStation.


Facsimile window display settings

The Display Switches section of the Face Lifter settings box lets
you control how items are displayed in the facsimile window.

* Hidden - If on, only hidden items (items with the attribute of
  Hidden) are displayed. (Otherwise, hidden items can only be
  selected using the Dialog Box Item List settings box.)

* Simulate - If on, the dialog box is displayed and operates as
  it would under normal MicroStation conditions.

* Show ID - If on, each item is displayed with its corresponding
  resource ID.

* Grid - If on, a grid is displayed. For information about
  specifying and using the grid, see "Item menu/Settings" below.

These settings are off by default.


Face Lifter pull-down menus

File menu/Open File╔  Ctrl+O

Choosing Open File from the File menu in the Face Lifter settings
box opens the Open Resource File, which lets you open a resource
file that contains dialog boxes you may wish to modify. Face
Lifter creates and opens a copy of the selected file with the
same name and the extension ".fac."

File menu/Open Dialog╔  Ctrl+D

Choosing Open Dialog from the File menu in the Face Lifter
settings box opens the Open Dialog Box Resource dialog box, which
is used to select and open a dialog box for customization.

File menu/Close Dialog  Ctrl+W

Choosing Close Dialog from the File menu in the Face Lifter
settings box closes the selected dialog box. If the selected
dialog box was modified but not saved, Face Lifter displays an
alert box that lets you save and close the dialog box, close the
dialog box without saving, or cancel the close request.

File menu/Save  Ctrl+S

Choosing Save from the File menu in the Face Lifter settings box
saves the selected dialog box.

File menu/Exit  Ctrl+Q

Choosing Exit from the File menu in the Face Lifter settings box
unloads Face Lifter. If any open dialog boxes were modified but
not saved, Face Lifter displays an alert box for each such dialog
box in sequence. The alert box lets you save the dialog box or
close it without saving.

Edit menu/Align >

The Align sub-menu of the Edit menu in the Face Lifter settings
box is used to align items. The sub-menu is dimmed if fewer than
two items are selected.

* Choosing Left aligns the selected items to be left-justified
  to the first selected item.

* Choosing Right aligns the selected items to be right-justified
  to the first selected item.

* Choosing Top aligns the selected items to be top-justified to
  the first selected item.

* Choosing Bottom aligns the selected items to be bottom-
  justified to the first selected item.

* Choosing Equivalent Vertical aligns the selected items to be
  equally spaced vertically.

* Choosing Equivalent Horizontal aligns the selected items to be
  equally spaced horizontally.

Edit menu/Select All  Ctrl+A

Choosing Select All from the Edit menu in the Face Lifter
settings box selects all items in the selected dialog box. This
is useful, for example, if you enlarge the dialog box and want to
move all the items back to the center.

Item menu/List

Choosing List from the Item menu in the Face Lifter settings box
opens the Dialog Box Item List settings box, which can be used to
select items for customization.

This settings box contains a list box with a row of data for each
item in the selected dialog box. An asterisk (*) denotes each
modified item. The columns are as follows:

* X - horizontal distance, in dialog coordinate units, of the
  item from the upper left corner of the dialog box.

* Y - vertical distance, in dialog coordinate units, of the item
  from the upper left corner of the dialog box.

* Width - width, in dialog coordinate units, of the item.

* Height - height, in dialog coordinate units, of the item.

* Type - item type.

* Rsc Id - resource ID of the item.

* EH - E indicates the item is enabled; H indicates the item is
  hidden.

* Arg - information in the argument field of the dialog box item
  resource list (meaningful to MDL programmers).

Item menu/Settings

Choosing Settings from the Item menu in the Face Lifter settings
box opens the Item Settings box, which lets you restrict the ways
in which dialog box items can be manipulated and arranged.

The check buttons in the Locks section restrict the ways in which
the selected item can be moved, resized, and spaced. These
settings are off by default.

* Size Horizontal - if on, prevents the width of the selected
  item from being changed.

* Size Vertical - if on, prevents the height of the selected
  item from being changed.

* Move Horizontal - if on, prevents the selected item from being
  moved horizontally.

* Move Vertical - if on, prevents the selected item from being
  moved vertically.

* Grid - if on, locks manipulations of the selected item to the
  grid in the facsimile window.

The items in the Grid Settings section control the spacing and
alignment of the grid in the facsimile window.

* X/Y Spacing - sets the horizontal/vertical spacing, in dialog
  coordinate units, between grid points. By default, X Spacing
  is 6, and Y Spacing is 12.

* Grid Alignment - defines which part of the selected item is to
  be aligned to the grid. Item Rectangle, the default, causes
  the interior solid lined rectangle (when selected) to be
  aligned with the grid. Item Bounding Box causes the exterior
  dashed line rectangle (when selected) to be aligned with the
  grid.

The Item Selection Mode option menu affects which items are
selected when a selection rectangle is dragged in a facsimile
window.

* If the mode is set to Inside (the default), only items inside
  the selection rectangle are selected.

* If the mode is set to Outside, only items outside the
  selection rectangle are selected.

* If the mode is set to Overlapping, only items inside or
  overlapping the selection rectangle are selected.



Customizing Pull-down Menus with Menu Manager


Menu Manager lets you customize the pull-down menus in the
Command Window. A set of customized menus is called a menubar.
You can create multiple menubars with Menu Manager and designate
any as the start-up menubar (the menubar that you want loaded
into the Command Window).

Here is the general procedure for customizing the pull-down
menus:

1.Load Menu Manager.

2.Open the standard Command Window menubar.

3.Make the desired modifications to the menubar using the Menu
  Manager settings box.

4.Test the menubar.

5.Name and save the modified menubar.

6.Designate the new menubar as the start-up menubar.

7.Load the menubar in the Command Window.

For detailed procedures, see the following sections.


Loading Menu Manager

To load Menu Manager:

* From the Applications menu's ConfigTools sub-menu, choose Menu
  Manager.

  or

  Key in MDL LOAD MENUBLD.

  Upon loading, Menu Manager opens the Menu Manager settings
  box.


Opening the standard Command Window menubar

To open a copy of the standard Command Window menubar for
customization:

* From the File menu in the Menu Manager settings box, choose
  New MenuBar.

  A copy of the standard menubar is opened and named "Untitled."
  The Menus list box shows the names of the menus (File, Edit,
  Element, etc.). The File menu is selected. The other list box
  shows the items in the selected menu. For each item, the item
  name or label is shown, along with the key-in that starts when
  the item is chosen, if any, and the keyboard accelerator, if
  any.


Modifying a menu name

To modify the name of a menu:

1.Double-click the name in the Menus list box.

  or

  Select the name in the Menus list box and choose Modify from
  the Edit menu.

  The Modify Menu dialog box opens.

2.Type the new name in the Label field and press <Return> (or
  click the OK button).


Modifying a menu item

To modify a menu item:

1.Double-click the item in the items list box.

  or

  Select the item in the items list box and choose Modify from
  the Edit menu.

  The Modify Menu Item dialog box opens.

2.Use the controls in the Modify Menu Item dialog box to make
  the desired modifications.

  - To modify the name, type the new name in the Label field.

  - To enable or disable the item in the menu, turn Enabled on
  or off.

  - To modify the key-in that starts when the item is chosen,
  type the new name in the Key-in field.

  - To attach a sub-menu to the item, turn on SubMenu Attached.
  To detach a sub-menu from the item, turn off SubMenu Attached.

  - To assign or modify the keyboard accelerator, turn on
  Control, Alt, or Shift to indicate the modifier key(s) and
  type the accelerator key in the Accelerator field.

  When done, press <Return> (or click the OK button).


Notes

* Any label that dynamically changes - for example, Undo, Redo -
  is always set by MicroStation. The name of such an item can be
  changed, but the label may not reflect the change when the
  menubar is loaded in the Command Window.

* MicroStation controls the enabled state of some menu items -
  for example, Group, Ungroup. The setting for such an item can
  be changed, but the item may not reflect the change when the
  menubar is loaded in the Command Window.

* The Key-in field accepts multiple key-ins separated by semi-
  colons (;). This lets you build key-in macros that can be
  started from pull-down menus - for example,
  co=red;wt=2;lv=elec;place line.

* The Key-in field accepts menu action strings. For information
  about menu action strings, see "Menus" in the MicroStation
  Customization Guide.

* Do not assign <Alt-letter> as a keyboard accelerator. This
  type of accelerator is designated for future use in
  MicroStation.


Inserting a menu

To insert a new menu in the menubar:

1.In the Menus list box, select the existing menu before which
  you want to insert the new menu.

2.From the Edit menu in the Menu Manager settings box, choose
  Insert.

  The Insert Menu dialog box opens.

3.Type the menu name in the Label field and press <Return> (or
  click the OK button).

Note:
  The Help menu, by Motif convention, is right-justified on the
  menubar. Thus, if you insert a menu before the dot in the Menus
  list box (which indicates the end of the menubar), the menu is
  inserted as the rightmost menu in the left-justified cluster of
  menus.


Inserting a menu item

To insert a new menu item:

1.In the items list box, select the existing menu item before
  which you want to insert the new item. (If you want to add the
  item as the last item in the menu, select the dot after the
  current last item.)

2.From the Edit menu in the Menu Manager settings box, choose
  Insert.

  The Insert Menu Item dialog box opens.

3.Use the controls in the Insert Menu Item dialog box.

  - Type the item name in the Label field.

  - To enable or disable the item in the menu, turn Enabled on
  or off.

  - Type the key-in that you want to start when the item is
  chosen in the Key-in field.

  - To attach a sub-menu to the item, turn on SubMenu Attached.

  - (Optional) To assign a keyboard accelerator, turn on
  Control, Alt, or Shift to indicate the modifier key(s) and
  type the accelerator key in the Accelerator field.

  When done, press <Return> (or click the OK button).

Tip:
  To logically subdivide menu items in the same menu, use separator
  bars. A separator bar is a horizontal line across a menu. The
  standard File menu in the Command Window has five separator bars;
  the topmost is between the Reference and Close items.

  Separator bars are themselves menu items. In the Menu Manager
  settings box, a separator bar appears as a dashed line. To insert
  a separator bar, follow the above procedure, but for step 3,
  simply type a hyphen (-) in the Label field and then press
  <Return> (or click the OK button).

Note:
  For more information about specifying menu items, refer to the
  notes under "Modifying a menu item," above.


Moving a menu

To move the location of a menu on the menubar:

1.In the Menus list box, select the menu you want to move.

2.From the Edit menu in the Menu Manager settings box, choose
  Cut.

3.In the Menus list box, select the menu before which you want
  to move the cut menu.

4.From the Edit menu in the Menu Manager settings box, choose
  Paste Menu.

Note:
  The Help menu, by Motif convention, is right-justified on the
  menubar. Thus, if you insert a menu before the dot in the Menus
  list box (which indicates the end of the menubar), the menu is
  inserted as the rightmost menu in the left-justified cluster of
  menus.


Moving a menu item

To move a menu item to a different location in the same menu or
to a different menu:

1.In the items list box, select the menu item you want to move.

2.From the Edit menu in the Menu Manager settings box, choose
  Cut.

3.In the items list box, select the menu item before which you
  want to move the cut menu item. (If you are moving the menu
  item to a different menu, first select the menu in the Menus
  list box.)

4.From the Edit menu in the Menu Manager settings box, choose
  Paste Menu Item.

Note:
  Some standard MicroStation menu items should not be moved to
  other menus as they may no longer exhibit their unique behavior.
  For example, if Undo is moved from the Edit menu, it will no
  longer display the action that is eligible for negation (for
  example, Undo place line). It will also always be enabled or
  disabled, as specified in the Modify Menu Item dialog box,
  regardless of the state of the undo buffer.

If you do move standard MicroStation menu items to other menus,
be sure to thoroughly test the resulting custom menubar before
loading it in the Command Window (see "Testing a menubar" below).


Deleting a menu

To delete a menu from the menubar:

1.In the Menus list box, select the menu you want to delete.

2.From the Edit menu in the Menu Manager settings box, choose
  Delete (or press <Del>).


Deleting a menu item

To delete a menu item:

1.In the items list box, select the item you want to delete.

2.From the Edit menu in the Menu Manager settings box, choose
  Delete (or press <Del>).

Note:
  If the menu item is a label for the name of an attached sub-menu,
  deleting the item also deletes the attached sub-menu.


Navigating hierarchical menus

The Menu Manager settings box has controls for navigating
hierarchical menus (such as those in the standard menubar).

To access the items in a sub-menu (that is, to move down in the
menu hierarchy):

* Double-click the > control at the right end of the list box
  item for the sub-menu.

  or

  Select the list box item for the sub-menu and press <Return>.

  or

  Select the list box item for the sub-menu and choose Show
  SubMenu from the Edit menu in the settings box.

To move up in the menu hierarchy (from a sub-menu to the menu to
which the sub-menu is attached):

* Open the unlabeled option menu (above the items list box), and
  choose the "parent" menu.


Testing a menubar

Menu Manager has a testing mode in which you can test the
operation of the open custom menubar.

1.In the Options menu in the Menu Manager settings box, turn on
  Test MenuBar.

  Menu Manager builds a test version of the custom menubar in
  the Command Window.

2.Use the mouse (or other supported pointing device) and
  keyboard to test the operation of the menubar.

3.When done, turn off Test MenuBar in the Options menu to
  deactivate testing mode.

Note:
  After you test a menubar, the Command Window menu bar will have
  lost its Applications menu, if one was present. If you want to
  restore the Applications menu, you will need to unload and reload
  the affected applications.


Saving a menubar

Before you can load a custom menubar for use in MicroStation, you
must save it.

To name and save a new custom menubar (one temporarily named
"Untitled"):

1.From the File menu in the Menu Manager settings box, choose
  Save As.

  The Save MenuBar As dialog box opens. The names of existing
  custom menubars are displayed in the list box.

2.Key in a name for the menubar in the Save Current MenuBar As
  field.

3.Click the Save button.

To save a newly modified custom menubar (one already named):

* From the File menu in the Menu Manager settings box, choose
  Save.

To save a custom menubar with a different name:

1.From the File menu in the Menu Manager settings box, choose
  Save As.

  The Save MenuBar As dialog box opens.

2.Key in the new name in the Save Current MenuBar As field.

3.Click the Save button.

  The renamed menubar remains open for modification. The
  previously saved version of the menubar (with the old name)
  still exists.


Loading a menubar in the Command Window

To make a saved custom menubar usable:

1.From the File menu in the Menu Manager settings box, choose
  Configure.

  The Configure MenuBars dialog box opens.

2.Select the menubar by name in the list box.

3.Click the Startup button.

  An asterisk (*) is displayed in the list box entry for the
  menubar to indicate its designation as the startup menubar.

4.When done using the dialog box, click its OK button.

5.Load PALLOAD.

  - In the MDL settings box, select PALLOAD and click the Load
  button.

  or

  - Key in MDL LOAD PALLOAD.

  PALLOAD loads the custom menubar in the Command Window.

Tip:
  Make PALLOAD a DGNAPP (one that is loaded whenever a design file
  is opened) by adding it to the definition of the MS_DGNAPPS
  environment variable. Then all you will need to do to make a
  custom menubar available in MicroStation is designate the menubar
  as the startup menubar and exit Menu Manager.


Selecting an existing menubar

To select and open an existing menubar for customization:

1.From the File menu in the Menu Manager settings box, choose
  Open MenuBar.

  The Open MenuBar dialog box opens.

2.Select the menubar in the MenuBar Name list box.

3.Click the OK button.

  The selected menubar is created and opened as a custom
  menubar. Its menus are displayed in the Menus list box in the
  Menu Manager settings box, and the first menu is automatically
  selected. The items in the selected menu are displayed in the
  items list box.


Renaming a custom menubar

To rename a custom menubar:

1.From the File menu in the Menu Manager settings box, choose
  Configure.

  The Configure MenuBars dialog box opens.

2.Select the menubar by name in the list box.

3.Click the Rename button.

  The Rename MenuBar dialog box opens.

4.Type the new menubar name in the MenuBar field and press
  <Return> (or click the OK button).

5.When done using the dialog box, click its OK button.


Deleting a custom menubar

To delete a custom menubar:

1.From the File menu in the Menu Manager settings box, choose
  Configure.

  The Configure MenuBars dialog box opens.

2.Select the menubar by name in the list box.

3.Click the Delete button.

4.When done using the dialog box, click its OK button.


Menu Manager pull-down menus

File menu/New MenuBar  Ctrl+N

Choosing New MenuBar from the File menu in the Menu Manager
settings box creates and opens a copy of the standard menubar,
named "Untitled."

File menu/Open MenuBar╔  Ctrl+O

Choosing Open MenuBar from the File menu in the Menu Manager
settings box opens the Open MenuBar dialog box, which is used to
select and open a menubar for modification.

File menu/Save  Ctrl+S

Saves the open menubar.

File menu/Save As╔

Choosing Save As from the File menu in the Menu Manager settings
box opens the Save MenuBar As dialog box, which lets you save the
open menubar with a different name.

File menu/Configure╔

Choosing Configure from the File menu in the Menu Manager
settings box opens the Configure Menus dialog box, which lets you
rename and delete custom menubars and designate a start-up
menubar.

File menu/Exit  Ctrl+Q

Choosing Exit from the File menu in the Menu Manager settings box
unloads Menu Manager. If the open menubar was modified but not
saved, Menu Manager displays an alert box that lets you save the
menubar or close it without saving.

Edit menu/Cut  Shift+Del  Ctrl+X

Choosing Cut from the Edit menu in the Menu Manager settings box
removes the selected menu or menu item and inserts it in a buffer
for subsequent pasting.

Edit menu/Copy  Ctrl+Ins  Ctrl+C

Choosing Copy from the Edit menu in the Menu Manager settings box
copies the selected menu or menu item to a buffer for subsequent
pasting.

Edit menu/Paste  Shift+Ins  Ctrl+V

Choosing Paste Menu or Paste Menu Item from the Edit menu in the
Menu Manager settings box copies the menu or menu item from the
buffer into the open menubar before the selected menu or menu
item.

Edit menu/Delete  Del

Choosing Delete from the Edit menu in the Menu Manager settings
box deletes the selected menu or menu item.

Edit menu/Modify╔

Choosing Modify from the Edit menu in the Menu Manager settings
box opens a dialog box which lets you modify the selected menu
name or menu item.

Edit menu/Insert╔  Ctrl+I

Choosing Insert from the Edit menu in the Menu Manager settings
box opens a dialog box which lets you insert a menu or menu item
before the selected menu or menu item.

Edit menu/Show SubMenu

Choosing Show SubMenu from the Edit menu in the Menu Manager
settings box lets you access the items in the selected sub-menu.

Options menu/Test MenuBar

Turning on Test MenuBar in the Options menu puts Menu Manager
into a mode that lets you test the operation of the open menubar.
To deactivate test mode, turn off Test Menu.


Keyboard shortcuts

The following table lists keyboard shortcuts for working with
menubars in Menu Manager:

   <Tab>          Activate other list box.

   <Return>       Access sub-menu items (or if no sub-menu, activate
                  other list box)

   <Up Arrow>     Select previous list box entry.

   <Down Arrow>   Select next list box entry.

   <Left Arrow>   Select previous list box entry.

   <Right Arrow>  Select next list box entry.

   <Home>         Select first list box entry.

   <End>          Select last list box entry.

   <Backspace>    Delete previous menu (item).

   <Del>          Delete selected menu (item).

   <spacebar>     Open Modify Menu (Item) dialog box.



Customizing Tool Palettes with Palette Manager


Palette Manager lets you customize tool palettes. You can create
custom palettes from a blank template or by starting with any of
MicroStation's standard palettes and

* Changing its name.

* Changing its size.

* Adding, deleting, or changing its tools.

* Changing the arrangement of its tools.

Here is the general procedure for customizing palettes:

1.Load Palette Manager.

2.Create a palette.

  or

  Select and open an existing palette.

3.Make the desired modifications to the palette.

4.Test the palette.

5.Save the palette.

6.Repeat steps 2-5 for each additional palette you want to
  create or modify.

7.Configure the palettes so they can be opened, automatically or
  manually, when loaded in MicroStation.

8.Load the palettes in MicroStation.

For detailed procedures, see the following sections.


Loading Palette Manager

To load Palette Manager:

* From the Applications menu's ConfigTools sub-menu, choose
  Palette Manager.

  or

  Key in MDL LOAD PALBLD.

  Upon loading, Palette Manager opens the Palette Manager
  settings box.


Creating a custom palette

To create and open a custom palette:

* From the File menu in the Palette Manager settings box, choose
  New Palette.

  A new custom palette opens; its name is "Untitled." The new
  palette has 10 blank tool slots; its dimensions are 2 ┤ 5 (2
  rows with 5 columns each). The tools are identified by number
  and listed in the Palette Manager settings box. For example,
  (1,2) indicates the second tool in the first row.


Selecting an existing palette

To select and open an existing palette for customization:

1.From the File menu in the Palette Manager settings box, choose
  Open Palette.

  The Open Palette dialog box opens.

2.From the Palette Source option menu, choose Custom (to select
  a custom palette) or MicroStation (to select a MicroStation
  palette).

3.Select the palette in the list box. (The list box is labeled
  Custom Palettes or MicroStation Palettes depending on the item
  chosen in the Palette Source option menu.)

4.Click the OK button.

  If the selected palette is a custom palette, the palette is
  opened. If the selected palette is a MicroStation palette, a
  copy of the selected palette is created and opened as a custom
  palette.

  Key-ins that activate the tools, if any, in the palette are
  displayed next to the corresponding tool numbers in the
  Palette Manager settings box.

Note:
  Palette Manager cannot be used to customize palettes from which
  sub-palettes can be opened and torn off, such as the Main palette
  and the Fence palette. (MDL programmers refer to these palettes
  as frames.)


Resizing a palette

To resize a palette:

* Drag in its resize border.

Note:
  If, through resizing, you decrease the number of rows or columns
  in a palette, the tools remain in the deleted slots although they
  cannot be seen. The tools are no longer listed in the Palette
  Manager settings box. To clear a tool, you must choose Clear from
  the Edit menu.


Selecting a tool in the open custom palette

The selected tool can be moved, replaced, or deleted.

To select a tool:

* Click the tool.

  or

  Use the keyboard arrow keys.

  The selected tool is highlighted.

The Overwrite setting, which is set in the Options menu in the
Palette Manager settings box, determines whether the selected
tool can be directly overwritten (replaced) or just moved to the
right. Overwrite is on by default.


Inserting a tool

To insert a tool (that is, replace a "blank tool"):

1.Use the Palettes menu in the Command Window to open the
  palette that contains the tool you want to insert (if that
  palette is not already open).

2.Select the tool.

To insert a tool in a slot in which a tool already exists:

1.Turn off Overwrite in the Options menu in the Palette Manager
  settings box (if Overwrite is not already off).

2.Use the Palettes menu in the Command Window to open the
  palette that contains the tool you want to insert (if that
  palette is not already open).

3.Select the tool you want to insert.

To replace a tool with another tool:

1.Turn on Overwrite in the Options menu in the Palette Manager
  settings box (if Overwrite is not already on).

2.Use the Palettes menu in the Command Window to open the
  palette that contains the tool you want to insert (if that
  palette is not already open).

3.Select the tool you want to insert.

Tip:
  In addition to selecting the tool you want to insert from its
  MicroStation palette, you can select it with a Command Window key-
  in or using the Key-in Browser settings box. Palette Manager
  "tracks" your actions as you use MicroStation, somewhat like a
  recording session, so you can more easily build a palette that
  consists of tools you use. To turn off this tracking feature,
  choose Pause Tracking from the Options menu in the Palette
  Manager settings box; to resume tracking, choose Resume Tracking.

Note:
  Palette Manager checks for duplicate tools; it will not let you
  add a duplicate instance of a tool if the tool is already visible
  in the palette.


Moving a tool

To move a tool:

* Drag the tool to the desired slot.

  If Overwrite is on, the tool in the destination slot is
  replaced. If Overwrite is off, the tool and the ones to its
  right move to the right.

OR

1.Select the tool.

2.From the Edit menu in the Palette Manager settings box, choose
  Cut.

3.Select the destination slot.

4.From the Edit menu in the Palette Manager settings box, choose
  Paste.

  If Overwrite is on, the tool in the destination slot is
  replaced. If Overwrite is off, the tool and the ones to its
  right move to the right.


Deleting a tool

To delete the selected tool without moving any other tools:

* From the Edit menu in the Palette Manager settings box, choose
  Clear.

or

* Drag the tool off the palette.

or

* Press the <spacebar>.

To delete the selected tool and move the tools to its right to
the left:

* From the Edit menu in the Palette Manager settings box, choose
  Delete.

or

* Press <Del>.

To delete the tool to the left of the selected tool and move the
selected tool and those to its right to the left:

* Press <Backspace>.

Note:
  You cannot create palettes with blank tools in the middle.


Modifying a tool

You can modify a tool by:

* Modifying the tool's icon (its graphical label). An icon is
  composed of dots called pixels. Each icon has a small version
  (23x23 pixels) and a large version (31x31 pixels).

* Changing the key-in that can be used to select the tool.

To modify a tool:

1.Double-click the tool.

  or

  Double-click the list box entry for the tool in the Palette
  Manager settings box.

  or

  Select the tool and choose Modify from the Edit menu in the
  Palette Manager settings box.

  The Modify Tool dialog box opens. The drawing area contains a
  magnified representation of the icon. A pixel grid is
  displayed as a drawing aid. The key-in that can be used to
  select the tool is shown in an unlabeled field below the
  drawing area.

2.Use the controls in the dialog box to modify the tool.

  To modify the tool icon, use the graphic tools found in the
  palette to the left of the drawing area (see "Modify Tool
  dialog box tool palette" below). If the small version of the
  icon is in the drawing area and you want to modify the large
  version, or vice-versa, click the corresponding button, on
  which the icon is displayed at its actual size, to the left of
  the drawing area. To modify both the small and large versions
  at the same time, turn on Draw Both Icons in the Options menu.

  To modify the key-in that can be used to select the tool, type
  the new key-in in the unlabeled field. A multiple key-in macro
  can be specified: The key-ins must be separated by semi-colons
  (;), and the first key-in must be preceded by the back quote
  character (`) - for example, `co=red;wt=2;lv=elec;place line.
  A menu action string can also be specified. For information
  about menu action strings, see "Menus" in the MicroStation
  Customization Guide.

3.When done, click the OK button.

Tip:
  If you make a mistake while modifying the tool and want to start
  over, click the Reset button in the Modify Tool dialog box.

Modify Tool dialog box tool palette

The tools in the palette are similar to those in many bitmap
editing ("paint") applications.

  Selection tool - used to select a contiguous section of the
  icon to move.

  Eraser tool - used to delete parts of the icon.

  Line tool - used to draw straight lines.

  Pencil tool - used to draw free-form lines and shapes and
                to change the color of individual pixels.

  Rectangle tool - used to draw hollow rectangles.

  Filled Rectangle tool - used to draw filled rectangles.

  Circle tool - used to draw hollow circles.

  Filled Circle tool - used to draw filled circles.

The procedure is the same for using any drawing tool:

1.Select the color you want to draw by clicking one of the
  colored buttons above the palette. The color of the left-hand
  button is chosen in the Options menu's Icon Color sub-menu.
  The right-hand button is always the icon background color
  (grey).

2.Select the tool in the palette.

3.Position the pointer where you want to begin drawing.

4.Drag the pointer in any direction (while holding down the Data
  button). This extends a line or shape, depending on the tool
  you have selected.

5.Release the Data button when the object is displayed with the
  size and shape you desire.

To move a contiguous section of the icon:

1.Select the Selection tool in the palette.

2.Drag a selection rectangle around the section you want to
  move.

3.Position the pointer in the selection rectangle.

4.Drag the section to its destination.

Modify Tool dialog box pull-down menus

The Edit menu has a single item, Clear All. Choosing this item
clears (applies the background color to) all the pixels in the
drawing area.

The Options menu has the following items:

* Icon Color - sub-menu from which the icon color is chosen.

* Edit Small Icon (Ctrl+S) - if on, the small version of the
  icon is in the drawing area. If off, the large version is
  there. Edit Small Icon is on by default if Tool Size is set to
  Small in the Preferences dialog box. The pair of buttons by
  the upper left corner of the drawing area can also be used to
  select the version of the icon.

* Use Foreground Color (Ctrl+F) - if on, the color chosen from
  the Icon Color sub-menu is selected as the drawing color. If
  off, the icon background color (grey) is selected as the
  drawing color. Use Foreground Color is on by default. The pair
  of colored buttons above the palette can also be used to
  select between the foreground and background colors.

* Display Grid (Ctrl+G) - if on, a pixel grid is displayed in
  the drawing area. Display Grid is on by default.

* Draw Both Icons (Ctrl+B) - if on, modifications to the version
  of the icon in the drawing area are reflected in both the
  large and small versions. You may want to adjust this setting
  as you modify differently shaped portions of the icon.


Testing a palette

Palette Manager has a testing mode in which you can test the
operation of the open custom palette.

1.In the Options menu in the Palette Manager settings box, turn
  on Test Palette.

  Palette Manager displays a test version of the custom palette.

2.Use the mouse (or other supported pointing device) to test the
  operation of the palette.

3.When done, turn off Test Palette in the Options menu to
  deactivate testing mode.


Saving a palette

Before you can load a custom palette for use in MicroStation, you
must save it.

To name and save a new custom palette (one temporarily named
"Untitled" or "Copy of <MicroStation palette>"):

1.From the File menu in the Palette Manager settings box, choose
  Save or Save As.

  The Save Palette As dialog box opens. The names of existing
  custom palettes are displayed in the list box.

2.Key in a name for the palette in the Save Current Palette As
  field.

3.Click the Save button.

To save a newly modified custom palette (one already named):

* From the File menu in the Palette Manager settings box, choose
  Save.

To save a custom palette with a different name:

1.From the File menu in the Palette Manager settings box, choose
  Save As.

  The Save Palette As dialog box opens.

2.Key in the new name in the Save Current Palette As field.

3.Click the Save button.

  The renamed palette remains open for modification. The
  previously saved version of the palette (with the old name)
  still exists.


Configuring a custom palette

Each custom palette can be individually configured to:

* open automatically when a design file is opened.

* have a menu item that opens the palette in a special User sub-
  menu of the Palettes menu in the Command Window.

If you do not set at least one of these configuration options for
a custom palette, you will not be able to use the palette because
you will not be able to open it.

To configure a custom palette so that it opens automatically when
a design file is opened:

1.From the File menu in the Palette Manager settings box, choose
  Configure.

  The Configure Palettes dialog box opens.

2.Select the palette by name in the list box.

3.Turn on Auto Open Palette During Startup.

  "A" is displayed in the list box entry for the selected
  palette.

4.When done using the dialog box, click its OK button.

To configure a custom palette so a menu item for opening the
palette will be inserted in the User sub-menu of the Command
Window's Palettes menu:

1.From the File menu in the Palette Manager settings box, choose
  Configure.

  The Configure Palettes dialog box opens.

2.Select the palette by name in the list box.

3.Turn on Install Palette in Palettes Pulldown Menu.

  "M" is displayed in the list box entry for the selected
  palette.

4.When done using the dialog box, click its OK button.

Note:
  The supplied MDL application PALLOAD inserts the User sub-menu
  into the Palettes menu; for more information, see "Loading
  palettes in MicroStation," below.


Renaming a custom palette

To rename a custom palette:

1.From the File menu in the Palette Manager settings box, choose
  Configure.

  The Configure Palettes dialog box opens.

2.Select the palette by name in the list box.

3.Click the Rename button.

  The Rename Palette dialog box opens.

4.Type the new palette name in the Palette field and press
  <Return> (or click the OK button).

5.When done using the dialog box, click its OK button.


Deleting a custom palette

To delete a custom palette:

1.From the File menu in the Palette Manager settings box, choose
  Configure.

  The Configure Palettes dialog box opens.

2.Select the palette by name in the list box.

3.Click the Delete button.

4.When done using the dialog box, click its OK button.


Loading palettes in MicroStation

To make saved custom palettes usable:

* Load PALLOAD.

  - In the MDL settings box, select PALLOAD and click the Load
  button.

  or

  - Key in MDL LOAD PALLOAD.

  PALLOAD inserts a sub-menu named User into the Palettes menu
  in the Command Window. The User sub-menu has an item for each
  custom palette so configured. To open a custom palette, choose
  the corresponding item from the User sub-menu.

Tip:
  Make PALLOAD a DGNAPP (one that is loaded whenever a design file
  is opened) by adding it to the definition of the MS_DGNAPPS
  environment variable. Then all you will need to do to make saved
  custom palettes available in MicroStation is exit Palette
  Manager.


Palette Manager pull-down menus

File menu/New Palette  Ctrl+N

Choosing New Palette from the File menu in the Palette Manager
settings box creates and opens a 2 x 5 custom palette named
"Untitled."

File menu/Open Palette╔  Ctrl+O

Choosing Open Palette from the File menu in the Palette Manager
settings box opens the Open Palette dialog box, which is used to
select and open a palette for modification.

File menu/Save  Ctrl+S

Saves the open palette.

File menu/Save As╔

Choosing Save As from the File menu in the Palette Manager
settings box opens the Save Palette As dialog box, which lets you
save the open palette with a different name.

File menu/Configure╔

Choosing Configure from the File menu in the Palette Manager
settings box opens the Configure Palettes dialog box, which lets
you rename and delete custom palettes and configure palettes for
use in MicroStation.

If the Auto Open Palette During Startup check button is on for
the selected palette, the palette will automatically open when a
design file is opened.

If the Install Palette in Palettes Pulldown Menu check button is
on for the selected palette, a menu item for opening the palette
will be added to the Palettes menu's User sub-menu.

File menu/Exit  Ctrl+Q

Choosing Exit from the File menu in the Palette Manager settings
box unloads Palette Manager. If the open custom palette was
modified but not saved, Palette Manager displays an alert box
that lets you save the palette or close it without saving.

Edit menu/Cut  Shift+Del  Ctrl+X

Choosing Cut from the Edit menu in the Palette Manager settings
box clears the selected tool and inserts it in a buffer for
subsequent pasting.

Edit menu/Copy  Ctrl+Ins  Ctrl+C

Choosing Copy from the Edit menu in the Palette Manager settings
box copies the selected tool to a buffer for subsequent pasting.

Edit menu/Paste  Shift+Ins  Ctrl+V

Choosing Paste from the Edit menu in the Palette Manager settings
box copies the tool from the buffer into the open custom palette.
If Overwrite is on, the tool in the destination slot is replaced.
If Overwrite is off, the tool and the ones to its right move to
the right.

Edit menu/Clear

Choosing Clear from the Edit menu in the Palette Manager settings
box clears the selected tool.

Edit menu/Delete

Choosing Delete from the Edit menu in the Palette Manager
settings box deletes the selected tool. All tools to the right of
the deleted tool move to the left.

Edit menu/Clear All

Choosing Clear All from the Edit menu in the Palette Manager
settings box clears all tools from the open palette.

Edit menu/Modify╔

Choosing Modify from the Edit menu in the Palette Manager
settings box opens the Modify Tool dialog box, which is used to
modify the key-in that can be used to select the selected tool in
MicroStation.

Options menu/Test Palette

Turning on Test Palette in the Options menu puts Palette Manager
into a mode that lets you test the operation of the palette. To
deactivate testing mode, turn off Test Palette.

Options menu/Pause (Resume) Tracking

Choosing Pause Tracking from the Options menu lets you activate
MicroStation tools without adding them to the open custom
palette.

Choosing Resume Tracking from the Options menu causes each
selected MicroStation tool to be added to the open custom
palette.

Options menu/Disable Commands

Turning Disable Commands on in the Options menu prevents you from
activating MicroStation tools as you customize palettes.

Options menu/Overwrite

Turning on Overwrite in the Options menu lets you replace tools.
If Overwrite is off and a tool is selected for insertion, the
selected tool and the ones to its right move to the right.


Keyboard shortcuts

The following table lists keyboard shortcuts for working with
palettes in Palette Manager:

  <Return>       Open Modify Tool dialog box.

  <Up Arrow>     Select tool one row above.

  <Down Arrow>   Select tool one row below.

  <Left Arrow>   Select tool in next column to left.

  <Right Arrow>  Select tool in next column to right.

  <Home>         Select tool at left-hand end of row.

  <End>          Select tool at right-hand end of row.

  <Ctrl-Home>    Select tool (1,1).

  <Ctrl-End>     Select tool (m,n) (last row, last column).

  <Backspace>    Delete tool in next column to left.

  <Del>          Delete selected tool.

  <Insert>       Turn off/on Overwrite in Options menu.

  <spacebar>     Clear selected tool.