Reference Guide
Reference Guide
Reference Guide

BASIC Editor

Used to edit or debug a macro. Opens when Edit… is clicked in the Macro dialog box.

BASIC Macro Editor

  

Key-in: MACRO DEBUG <<macro> <name>

File menu > New…

Discards the current macro file being edited and clears the text editing area. The new (empty) buffer will be untitled. Use “Save As” before debugging the new macro.

File menu > Open…

Displays the Open Basic Source file dialog box to select a new macro file for editing. If a new macro file is already selected, the macro file currently being edited is discarded and the new macro file is loaded into the editing area.

File menu > Save

Saves the text updates to the macro file on disk.

File menu > Save As…

Allows the user to save the current text editing area contents to a new macro filename. The Save Source To dialog box displays so that the user may choose the new macro filename.

File menu > Exit

Causes the Macro Editor to be unloaded. If the contents of the text editing area have been modified but not yet saved, the user is warned and given an opportunity to save the updates to the macro file at this time.

Edit menu > Undo

Undo negates the last modification to the text by the user. After you undo an operation, the preceding operation cannot be undone. You can undo a series of operations by repeatedly choosing this option.

Edit menu > Redo

This is effective after an undo command has been executed. It negates the undo, changing the text to its original format before the undo took place.

Edit menu > Find…

Opens the Find Text dialog box. Type in the text to find. To make the search case-sensitive, enable the Match Case toggle button. Then, start the search by clicking the OK button. MicroStation highlights the first match moving forward from the cursor position.

Edit menu > Find Next

Searches for the next occurrence of the text you entered in the Find Text dialog box.

Edit menu > Cut

Copies the currently selected text in the text area to the clipboard, deleting the text from the text editor window afterwards.

Edit menu > Copy

Copies the currently selected text in the editing area to the clipboard. The existing text editing area contents remain intact.

Edit menu > Paste

Copies text from the clipboard into the editing area at the location of the cursor.

Edit menu > Variables

Opens the Variables window.

Edit menu > Custom Dialog > Edit…

Opens the Builder dialog box, which is used to create and modify custom dialog boxes. All custom dialogs created will be saved as resources in the compiled version of the macro (the .BA file).

Edit menu > Custom Dialog > Insert…

Displays a list of custom dialogs defined for the current macro. Selecting an entry in the list enters a line of source code in the macro at the current cursor position:

Edit menu > Program Entry Point

Allows the programmer to designate BASIC functions to be called for use in the plotting process. The BASIC functions defined by program entry points provide customization for the final plot when standard pen tables are not sufficient.

Run menu > Execute

Compiles the current macro and runs it from the beginning. If the debugger is active when Execute is chosen, the debugger is stopped before the compilation starts.

Run menu > Break

Causes a breakpoint to be toggled (set or reset) at the current line position in the text editing area indicated by the cursor position.

Run menu > Step Into

Causes the debugger to execute the currently highlighted line in the macro. If the currently highlighted line is a subprocedure call, the debugger traces execution “down and into” the subprocedure then stops and highlights the first executable line in the subprocedure.

Run menu > Step Over

Causes the debugger to execute the currently highlighted line in the macro. If the currently highlighted line is a subprocedure call, the debugger runs all statements in the subprocedure before stopping and highlighting the first executable line after the subprocedure call.

Run menu > Go

Causes the debugger to continue executing the macro from the current statement forward until completion or until a breakpoint is encountered. If a breakpoint is encountered, the debugger suspends the macro and highlights the current line.

Run menu > Stop Debug

Causes the debugger to abort the current debugging session for the macro. Breakpoint information remains intact.