IBM
Contents Index Previous Next



Menu Bar


The menu bar provides commands available in menus and menu choices for editing diagrams and pages of diagrams. Most the functionality that the Text Editor offers is contained within the commands from the menu bar. The Text Editor's menu bar provides the following menus:

File Menu

The File menu contains the following menu choices:

The menu choices are described in File Menu, except Print which is described in The Print Dialogs in the SDL Suite and in the Organizer.

Edit Menu

The Edit menu provides the following choices, which may or may not be dimmed depending upon whether or not some text is selected:

Undo

This command restores the last text editing operation. The following operations can be undone:

Note:

Undo does not restore endpoints or links, even though typing, insertions and deletions can destroy both endpoints and links

For more information on the operation of the Undo command, see Undoing Text Modifications.

Cut

Cut removes the selected portion of text from the text window and saves it in the clipboard buffer just as if a Copy has been made. Cut is only available if a portion of text has been selected. Cut is not available for state overview files (*.ins), because they are not editable.

Also see Deleting an Object.

Copy

Copy makes a copy of the selected portion of text in the clipboard buffer. The content of the text window is not affected. Copy is only valid if a portion of text has been selected.

When copying text to the clipboard buffer it becomes possible to paste into three different contexts:

Paste

Paste inserts the content of the clipboard buffer into the text window. The text in the clipboard buffer will be appended immediately following the cursor position, or replacing the selected text. Paste is only available if a portion of text has been cut or copied into clipboard buffer. Paste is not available for state overview files.

Also see Pasting an Object.

Paste As

Pastes the currently copied object (from the OM or Text Editor) as a text in the text window. The object is transformed and a link is optionally created between the copied object and the pasted text.

The Paste As dialog is opened. See The Paste As Command for more information. Paste As is not available for state overview files (*.ins), because these files are not editable.

Clear

Clear removes the selected portion of text from the text window. The content of the clipboard buffer is not affected. Clear is only available if a portion of text has been selected. Clear is not available for state overview files (*.ins), because these files are not editable.

Also see Deleting an Object.

Select All

Select All selects all of the text contained in the text window.

View Menu

The View menu provides rescaling functions and access to various options that affect the behavior of the Text Editor. The following menu choices are available:

Window Options

This menu choice issues a dialog where the presence of the tool and status bars can be set:

Figure 122 : The Window Options dialog

Editor Options

This menu choice issues a dialog where the behavior of the Text Editor can be customized.

Figure 123 : The Editor Options dialog

The options are controlled by toggle buttons. They are:

Note:

Regardless of the setting of this option, link endpoints are never shown when printed.

The default value for this option is controlled by the TE*ShowLinks preference.

State Matrix > Filter Processes

This menu choice is only available for state overview files (*.ins).

This menu choice brings up a dialog that decides the group of processes that should be visible as state matrices. As default, all processes in the SDL system are visible. The dialog allows you to show selected processes, hide selected processes or show all processes.

State Matrix > Matrix Options

This menu choice is only available for state overview files (*.ins).

This menu choice brings up a dialog with options for state matrices. The available options are listed below.

Sort states

The states in the state matrices will be sorted in alphabetical order.

Sort signals

The signals in the state matrices will be sorted in alphabetical order.

Show page reference matrix

The page references refer to the printed page where the transition in question starts, i.e. where the SDL input symbol is placed. `-' means no signal.

Page references are normally not visible, they are replaced with `*'. The only chance you have to see page references instead of `*' is to print the SDL process together with the state overview file (*.ins) from the Organizer.

Page reference matrix for process Demon:

States
a Start state
b Generate

        |  STATES
SIGNALS |  a    b
        |--------
-       |  *     
T       |       *
Show nextstate matrix

For each transition, the possible nextstates are listed. `-' means no signal.

Nextstate matrix for process Demon:

States
a Start state
b Generate

        |  STATES
SIGNALS |  a    b
        |--------
-       |  b     
T       |       b
Show signal sending matrix

For each transition, signals that might be sent from SDL output symbols during the transition are listed. `-' means no signal or no output.

Signal sending matrix for Process Demon:

States
a Start state
b Generate

        |  STATES
SIGNALS |  a    b
        |--------
-       |  -     
T       |       1

1 = Bump
Show procedure call matrix

For each transition, procedures that might be called during the transition are listed. `-' means no signal or no procedure call.

Process Demon: procedure calls

States
a Start state
b Generate

        |  STATES
SIGNALS |  a    b
        |--------
-       |  -
T       |       -

Diagrams Menu

The Diagrams menu records all diagrams and pages that are opened by the Text Editor. The available menu choices are:

Back

Select this menu choice to browse back to the document that was previously displayed in the window.

Forward

Select this menu choice to browse forward to the document that was displayed in the window before you selected Back.

<Diagram Name>

The last edited page always goes to the top of the list, and subsequently moves the other diagrams and pages down a position. A maximum of 9 open pages can be shown. A tenth one will be put at the top of the list, but any subsequent opening of a diagram or page will only show the last 9 that have been opened. Another option - List All (at the bottom of the list) - is available to list all the open diagrams in the Text Editor.

Each item in the menu provides information about the diagram name, possibly followed by the file it is stored on (the file information is missing if the diagram has never been saved). A diagram that is preceded by an asterisk (`*') denotes that it has been modified during the Text Editor session.

List All

This menu choice becomes available when a maximum of 9 open pages has been surpassed. When List All is selected, it provides a dialog containing all diagrams and pages that are currently open in the Text Editor:

Figure 124 : The List All dialog

Window Menu

The Window menu contains the following menu choices:

Close Window

This option closes the open window, but, not necessarily the diagram. If more than one editor window is opened, only the current window is closed and not the diagram. If the last open editor window is closed, the Text Editor will act as if Exit has been chosen, possibly in conjunction with a save of information (see Close Diagram).

Entity Dictionary

Opens the Entity Dictionary window. See The Entity Dictionary for more information.

When working with the Entity Dictionary in the Text Editor, note that the Link > Create command will not automatically create an endpoint on the current selection as is the case in the graphical Editors.

Tools Menu

The Tools menu contains the following menu choices:

Go To Line

This menu choice moves the cursor to a line specified by the user. When selected, a dialog will appear querying the user where to move.

Figure 125 : The Go To Line dialog

Search

This menu choice opens a dialog where you may search through the document for a text string and replace it with some other piece of text.

Figure 126 : The Search dialog

Dialog Fields and Options

The Search dialog contains the following fields and options. Values from the previous invocation is used for settings when the dialog is used again.

Dialog Buttons

When the dialog is first opened, all buttons except Close are disabled. Buttons will be enabled when appropriate, for instance the Search/Restart Search button will be enabled when a string is entered in the Search for text field.

When the dialog opens, searches always start at the top of the document.

Go To Source

This command takes the currently selected text fragment and attempts to interpret it as an SDT Reference and display it in the appropriate editor. The selection must include the selected reference exactly. This command corresponds to Go To Source in the Organizer.

The syntax of the graphical references used in the Text Editor is described in SDT References.

Show Transition

This operation is only available for state overview files (*.ins), and only when the text cursor is placed close to a transition in a state matrix.

An SDL Editor window is popped up with the SDL input symbol corresponding to the start of the transition currently in focus in the Text Editor.

Show Nextstate

This operation is only available for state overview files (*.ins), and only when the text cursor is placed close to a transition in a state matrix.

Show Nextstate is a sub menu. The menu choices in the sub menu have the names of the states found in all nextstate symbols that ends the transition currently in focus in the Text Editor. When a nextstate name is selected, an SDL Editor window pops up, showing the nextstate symbol.

Show Output

This operation is only available for state overview files (*.ins), and only when the text cursor is placed close to a transition in a state matrix.

Show Output is a sub menu. The menu choices in the sub menu have the names of all signals that might be sent from an SDL output symbol during the transition currently in focus in the Text Editor. When a signal is selected, an SDL Editor window pops up, showing the output symbol with the signal sending.

Show Call

This operation is only available for state overview files (*.ins), and only when the text cursor is placed close to a transition in a state matrix.

Show Call is a sub menu. The menu choices in the sub menu have the names of all procedures that might be called during the transition currently in focus in the Text Editor. When a procedure call is selected, an SDL Editor window pops up, showing the procedure call symbol.

Show State

This operation is only available for state overview files (*.ins), and only when the text cursor is placed close to a state or transition in a state matrix.

Show State is a sub menu. The menu choices in the sub menu represents all the places where SDL state symbols can be found for the state currently in focus in the Text Editor. If a transition is currently in focus in the Text Editor, the Show State operation operates on the start state for the transition. When a menu choice is selected, an SDL Editor window pops up, showing the corresponding state symbol.

Show Signal

This operation is only available for state overview files (*.ins), and only when the text cursor is placed close to a signal or transition in a state matrix.

When this operation is invoked, an SDL Editor window is popped up with the signal declaration corresponding to the signal in focus in the Text Editor. If a transition is in focus in the Text Editor, the operation operates on the signal that triggers the transition.


http://www.ibm.com/rational
Contents Index Previous Next