![]() |
![]() |
![]() |
![]() |
![]() |
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:
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:
- As simple text (without endpoint and link information) into applications that normally support cut/copy of text, such as terminal windows and other text editors.
- As text with endpoint and link information when pasting into one of the Text Editor windows, which means that endpoints and links are preserved.
- As a Paste As operation in all the Editors (including the Text Editor itself), provided that the copied text contained no endpoints or exactly matched an endpoint. See Pasting a Text Fragment for more information.
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:
- Clicking OK applies the options as defined in the dialog to the current window only.
- Clicking All Windows applies the options as defined in the dialog to all windows opened by the Text Editor.
Editor Options
This menu choice issues a dialog where the behavior of the Text Editor can be customized.
The options are controlled by toggle buttons. They are:
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:Statesa Start stateb Generate| STATESSIGNALS | a b|--------- | *T | *Show nextstate matrix
For each transition, the possible nextstates are listed. `-' means no signal.
Nextstate matrix for process Demon:Statesa Start stateb Generate| STATESSIGNALS | a b|--------- | bT | bShow 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:Statesa Start stateb Generate| STATESSIGNALS | a b|--------- | -T | 11 = BumpShow 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 callsStatesa Start stateb Generate| STATESSIGNALS | 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:
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:
- Show Organizer
- Link > Create
- Link > Create Endpoint
- Link > Traverse
- Link > Link Manager
- Link > Clear
- Link > Clear Endpoint
- (The Link commands are described in Link Commands in the Tools Menus.)
- Go To Line
- Search
- Go To Source
- Show Transition
- Show Nextstate
- Show Output
- Show Call
- Show State
- Show Signal
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.
- Goto line number
- Goto line
- Moves the cursor to the specified line and closes the dialog. This button will be dimmed if the Goto line number text field does not contain a valid line number. If you have entered a line number that is larger than the number of lines in the document, the cursor is moved to the end of the document.
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.
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 |
![]() |
![]() |
![]() |
![]() |