# User Guide

## Interacting with the Graphical User Interface

### BEA Guardian Main Window

The BEA Guardian Graphical User Interface consists of the following main components:

- Main Title Bar - the uppermost region of the BEA Guardian Main Window. The Main Title Bar contains the BEA Guardian icon, the title, "BEA Guardian", and icons to minimize, maximize, restore, and close the window. You can double-click the Main Title Bar to maximize the window, and double-click it again to restore the window to its original size.
Figure 1-14 Guardian Main Title Bar

You can right-click the Main Title Bar to open a pop-up menu with choices to Restore, Move, Size, Minimize, Maximize, and Close the BEA Guardian Main Window. Selecting Move or Size activates the arrow keys to move or resize the window to the location or size you want. Pressing an arrow key also makes the window move or resize in response to mouse pointer movement. Left-click to resume normal arrow key and mouse pointer operation. You can also move or resize the BEA Guardian Main Window with the mouse by dragging the title bar or window borders.

Figure 1-15 Guardian Main Title Bar Pop-up Menu

- Main Menu - the menu headings below the Main Title Bar. You can open menus, navigate submenus, and select menu options with your mouse or keyboard. To use the keyboard, press the Alt key and type the menu selection key to open menus and select menu options. The menu selection key is the letter underlined in the menu after you press the Alt key.
Figure 1-16 Guardian Main Menu

Certain menu options also have keyboard shortcuts. With a keyboard shortcut, you only need to press a key sequence to select a menu option. To see the complete list of keyboard shortcuts, press "Ctrl+Shift+L".

- Main Toolbar - the buttons with icons and text below the main menu. When the mouse pointer is over a toolbar button, a tool tip window pops up under the mouse pointer that says what the button does.
Figure 1-17 Guardian Main Toolbar

- Navigation Pane - the left hand region of the BEA Guardian window. The Navigation Pane contains these BEA Guardian views:
Figure 1-18 Guardian Navigation Pane

- Bundle Explorer
- Domain Explorer
- Shortcut Explorer
- Signature Explorer

You can have multiple views open at once, but only one of each kind. If you try to open one that's already open, it will be brought to the forefront of the Navigation Pane and made active.

- Document Pane - the central region of the BEA Guardian window. The Document Pane is the location where these BEA Guardian views and editors open:
Figure 1-19 Guardian Document Pane

- Active Domain Table
- Bundle Details
- Domain Inventory
- Evaluation Summary
- Shortcut Table
- Signature Details

You can have multiple views and editors open at once in the Document Pane. If you try to open one that's already open, it will be brought to the forefront of the Document Pane and made active. But you can create copies of an already open editor by selecting New Editor from the editor's System Menu.

### View and Editor Title Bars

Each view and editor has its own title bar that contains its name, an identity icon, and icons to close, minimize, maximize, and restore.

Figure 1-20 Guardian View and Editor Title Bar

You can double-click the title bar to maximize a view or editor, and double-click it again to restore the view or editor to its original size. You can also right-click the title bar to access the System Menu.

You can group multiple views or multiple editors together on a title bar as a tab group. Tab groups can be moved together as a unit, using either the System Menu's Move menu option or drop cursors. Only the title bar of the currently active view or editor is visible in a tab group.

Figure 1-21 Guardian View and Editor Tab Groups

If you have more views or editors open than can fit on a title bar, a Show List icon appears to the right of the title bar's tabs. The icon includes a number that indicates how many more views or editors are open than can fit on the title bar. Clicking the icon displays a list of all the title bar's views or editors. Selecting one brings it to the forefront of the Navigation Pane or Document Pane and makes it active. The ones listed in bold are the ones that cannot fit on the title bar. The ones not listed in bold are the ones that are already shown on the title bar.

Figure 1-22 Guardian View and Editor Title Bar Show List

### View and Editor Icons

Each view and editor has a set of icons in its title bar.

#### Icons Common to Both Views and Editors

These are the icons that both views and editors have in their title bar:

Icon | Name | Description
| Close | Closes a view or editor.
| Minimize | Shrinks a view or editor down to just its title bar and changes the Minimize icon into a Restore icon.
| Maximize | Expands a view or editor to the largest possible size and changes the Maximize icon into a Restore icon.
| Restore | Restores a minimized or maximized view or editor to its original size and location.
| Show List | Lists all the open views or editors on a title bar when there are too many to fit. The number indicates how many don't fit.

#### Icons Common to Navigation Pane Views Only

These are the additional icons that the Domain Explorer, Bundle Explorer, and Signature Explorer have in their title bars:

Icon | Name | Description
| Expand all items | Opens every folder and node in the Bundle Explorer or Domain Explorer.
| Collapse all items | Closes every folder and node in the Bundle Explorer or Domain Explorer so that only the top level folder is visible.
| Menu | Opens a menu with operations specific to the Bundle Explorer, Signature Explorer, and Domain Explorer for sorting and filtering signatures and domain information.
| Link with Editor | Synchronizes the editors open in the Document Pane with the Evaluation Summary and Domain Inventory entries in the Domain Explorer. When you bring an editor to the forefront of the Document Pane, the corresponding entry in the Domain Explorer is highlighted. And when you highlight an Evaluation Summary or Domain Inventory entry in the Domain Explorer, the corresponding editor in the Document Pane is brought to the forefront.

### View and Editor System Menus

Each view and editor has a System Menu, which you can access by right-clicking its title bar.

#### System Menu Options Common to Both Views and Editors

These are the System menu options that both views and editors have:

Name | Description
Restore | Restores a minimized or maximized view or editor to its original size and location.
Move | Makes the mouse pointer active in moving views or editors to different locations. Move > View, moves just one view or editor. Move > Tab Group, moves all the views or editors sharing a title bar together. Left-click to resume normal mouse operation.
Size | Makes the arrow keys active in resizing a view or editor. Select a direction (Left, Right, Top, Bottom) in which to grow or shrink. Left-click to resume normal arrow key operation.
Minimize | Shrinks a view or editor down to just its title bar and changes the Minimize icon into a Restore icon.
Maximize | Expands a view or editor to the largest possible size and changes the Maximize icon into a Restore icon.
Close | Closes a view or editor.

#### System Menu Options Common to Navigation Pane Views Only

These are the additional System menu options that only Navigation Pane views have:

Name | Description
Detached | Separate a view from the Navigation Pane so you can move it anywhere on your screen. To reattach the view, de-select the Detached menu option's check mark.

#### System Menu Options Common to Document Pane Views and Editors Only

These are the additional System menu options that only Document Pane views and editors have:

Name | Description
Close Others | Closes all the other views and editors currently open in the Document Pane, leaving the currently active view or editor open.
Close All | Closes all the views and editors currently open in the Document Pane.
New Editor | Creates a copy of the currently active view or editor in the Document Pane.

### View and Editor Drop Cursors

You can move views and editors by dragging their title bars to different locations. The views in the Navigation Pane can move almost anywhere, including outside the BEA Guardian window. But the editors can only move within the existing Document Pane.

As you drag a view or editor title bar, the mouse pointer changes into a drop cursor that indicates where the view or editor will appear when you release it. The drop cursor can change into any of these shapes:

Drop Cursor | Location Dragged Item Appears
| Above what's under the drop cursor.
| Below what's under the drop cursor.
| To the right of what's under the drop cursor.
| To the left of what's under the drop cursor.
| As a tab in the title bar of what's under the drop cursor.
| Outside the BEA Guardian window. To return it, de-select Detached from the System Menu.
| Stays where it was, because the location is not valid.

Please note that where in the title bar you click determines what gets dragged. If you click the tab of a view or editor it will only move that view or editor, not the whole tab group. To grab the whole tab group, you have to click to the right of the tabs in the title bar, or use Move > Tab Group from the System Menu.

### Dialog Boxes

#### Common Dialog Box Buttons and Icons

BEA Guardian uses dialog boxes to get information from you that's needed to perform certain operations. The Domain Properties, Signature Filters, Filter Domain Explorer, and Preferences dialog boxes have an OK button to accept the information you've provided and a Cancel button to exit the dialog box without performing any operations. They also have a close icon in their title bars to exit without performing any operations.

Figure 1-23 Guardian Domain Properties Dialog Box

#### Preferences Page Title Bar

The Preferences page title bar has icons to maximize and restore the Preferences page. You can also double-click the Preferences page title bar to maximize it, and double-click it again to restore it to its original size.

You can right-click the Preferences page title bar to open a pop-up menu with choices to Restore, Move, Size, Maximize, or Close the Preferences page. Selecting Move or Size activates the arrow keys to move or resize it to the location or size you want. Pressing an arrow key also makes it move or resize in response to mouse pointer movement. Left-click to resume normal arrow key and mouse pointer operation. You can also move or resize the Preferences page with the mouse by dragging the title bar or window borders.

Figure 1-24 Guardian Preferences Title Bar

#### Select Workspace Dialog Box Title Bar

You can right-click the Select Workspace title bar title bar to open a pop-up menu with choices to Move, Size, or Close the Select Workspace dialog box. Selecting Move or Size activates the arrow keys to move or resize it to the location or size you want. Pressing an arrow key also makes it move or resize in response to mouse pointer movement. Left-click to resume normal arrow key and mouse pointer operation. You can also move or resize the Select Workspace dialog box with the mouse by dragging the title bar or window borders.

Figure 1-25 Guardian Select Workspace Title Bar

#### Wizard Title Bar

You can right-click a Wizard's title bar to open a pop-up menu with choices to Move, Size, or Close the Wizard. Selecting Move or Size activates the arrow keys to move or resize it to the location or size you want. Pressing an arrow key also makes it move or resize in response to mouse pointer movement. Left-click to resume normal arrow key and mouse pointer operation. You can also move or resize a Wizard with the mouse by dragging the title bar or window borders.

Figure 1-26 Guardian Wizard Title Bar

#### Other Dialog Box Title Bars

You can right-click the Domain Properties, Signature Filters, and Filter Domain Explorer title bars to open a pop-up menu with choices to Move or Close the dialog box. Selecting Move activates the arrow keys to move it to the location you want. Pressing an arrow key also makes it move in response to mouse pointer movement. Left-click to resume normal arrow key and mouse pointer operation. You can also move these dialog boxes with the mouse by dragging the title bar.

Figure 1-27 Guardian Domain Properties Dialog Box Title Bar

#### Related Reference

- Navigation Pane
- Bundle Explorer
- Domain Explorer
- Shortcut Explorer
- Signature Explorer
- Document Pane
- Active Domain Table
- Bundle Details
- Domain Inventory
- Evaluation Summary
- Shortcut Table
- Signature Details
- Wizards
- Domain Properties
- Signature Filters
- Preferences
- Main Menu
- Main Toolbar
- Keyboard Shortcuts

#### Related Getting Started

- Starting the Graphical User Interface