Global Macros (Panel Edit)
Purpose:
Opens a dialog to modify the editor's global macros.
Each editor can have up to 100 macros which can be accessed from any control. It is recommended that any operation that is to be repeated multiple times should be stored as a global macro and called by any control that requires it. If modification of the macro is ever required, it will only have to be modified once instead of multiple times.
Directions:
To edit the Global Macros:
| 1. | Choose Editor/Panel Edit to place the Editor in Panel Edit mode |
| 2. | Right click and choose Global Macros from the popup menu |
The Global Macros Dialog
To edit a particular macro, click on the macro number on the left hand side. The macro will appear in the editing area on the right hand side.
Each Editor supports 256 global macros which can be called by any other macro in the editor and any global macro can call any other global macro. This allows you to perform extremely complex operations within an editor and still maintain good organization.
Following are a list of important facts to remember about global macros:
| • | On macro entry, the scope of temporary variables W, X, Y, and Z is the macro. The variables are set identically to the calling macro on entry but their values are lost on leaving the macro. |
| • | A macro can return a value to the calling macro by using the command "RET var" command . The returned value appears to the calling macro in the X variable. If the called macro does not return a value, X should be considered invalid |
| • | For the calling macro, the values of variables W, Y, and Z are identical before and after the call to another macro |
| • | The 4096 global "V" variables (V0 ... V4095) have a scope of the entire editor. Change one of these variables in any macro and that change will be seen in all macros |
| • | any macro can call any other macro |
| • | no macro should call itself or call another macro which calls itself |
| • | there is no limit to the number of times a macro can call another macro |
Warning! Be careful of recursion errors. If macro 10 calls macro 15 and macro 15 calls macro 10, you will crash Midi Quest because it will go into an infinite loop!! This is a programming language and you can cause crashes just as if you were writing code in C++, 'C', Java, Pascal, Basic, or any other language.
Key Equivalent:
Macintosh: Alt+Ctrl+M
Windows: Ctrl+M
note: key equivalents will only work when the editor view has focus. If the panel editor has been used then the focus has been shifted and key equivalents will not work. Click the mouse in the editor view to reset the focus and enable key equivalents.
Available in:
Midi Quest Pro |
|
Midi Quest |
|
Midi Quest Essentials |
|
Midi Quest one |
|
See the Macro Language for a complete description of all of the macro commands.
See Also: Macro Language