Thom Little Associates, Ltd.

tlaMDE - Operation
API Macro Development Environment
CodeWright® - Dynamic Link Library - Purchase - 2005.01.01 17:15

tlaMDE operates on one or more API macros in the current buffer.

tlaMDE has six sub-functions: compile, delete, execute, fetch, help, and save. Three of them (delete, execute, and fetch) allow you to provide additional information by responding to a message prompt.

Compile

Update the date/time stamp in the macro(s) (if present)

Save the macro(s) to the appropriate macro repository (cwright.mac or cwvsnet.mac).

Compile the macro(s) from the appropriate macro repository.

If there are compile errors ...

Massage the error information so it meaningfully matches the current buffer.
Display error information in the Output window
- CodeWright - Output window Build pane. Note that the API Error Filter (_Apiarist) is totally supported.
- CodeWright for .NET - Output window, ClipView pane, Clipboard.

Report the return value from the "compile" operation. If macros other than those in the current buffer had compile errors, report that information.

Delete

Delete the macro(s) from the appropriate macro repository (cwright.mac or cwvsnet.mac).

Report the return value from the "delete" operation.

Delete with Prompt

Prompt for the macro name to delete.

Delete the macro from the appropriate macro repository (cwright.mac or cwvsnet.mac).

Report the return value from the "delete" operation.

Execute

Update the date/time stamp in the macro(s) (if present)

Save the macro(s) to the appropriate macro repository (cwright.mac or cwvsnet.mac).

Compile the macro(s) from the appropriate macro repository.

If there are compile errors ...

Massage the error information so it meaningfully matches the current buffer.
Display error information in the Output window
- CodeWright - Output window Build pane. Note that the API Error Filter (_Apiarist) is totally supported.
- CodeWright for .NET - Output window, ClipView pane, Clipboard.

Execute the macro(s) from the appropriate macro repository.

One macro in buffer - execute that macro.
Multiple macros i buffer - execute first macro in buffer.

Report the return value from the "execute" operation.

Execute with Prompt

Update the date/time stamp in the macro(s) (if present)

Save the macro(s) to the appropriate macro repository (cwright.mac or cwvsnet.mac).

Compile the macro(s) from the appropriate macro repository.

If there are compile errors ...

Massage the error information so it meaningfully matches the current buffer.
Display error information in the Output window
- CodeWright - Output window Build pane. Note that the API Error Filter (_Apiarist) is totally supported.
- CodeWright for .NET - Output window, ClipView pane, Clipboard.

Prompt for the macro name (and optional parameters) to execute.

Execute the named macro using the optional parameters if provided.

Report the return value from the "execute" operation.

Fetch

Fetch the macro(s) from the appropriate macro repository (cwright.mac or cwvsnet.mac) based on an input list (see example below).

Append each fertched macro to the end of the current buffer using the same order as the input list.

Flag the input list entry for any macro that could not be fetched.

Report the return value from the "delete" operation.

Fetch with Prompt

Prompt for the macro name to fetch.

Fetch the macro(s) from the appropriate macro repository (cwright.mac or cwvsnet.mac).

Insert the fertched macro at the current cursosrt location in the current buffer.

Report the return value from the "delete" operation.

Help

List the most recent version of this document detailing the operation of tlaMDE.

Report the return value from the "help" operation.

Save

Update the date/time stamp in the macro(s) (if present)

Save the macro(s) to the appropriate macro repository (cwright.mac or cwvsnet.mac).

Report the return value from the "save" operation.

Input Parameters

Parm A	Parm B	Meaning
"c"		Save and compile macro(s) in current buffer to/from appropriate macro repository.
"compile"
"d"		Delete macro(s) in current buffer from appropriate macro repository.
"delete"
"d"	"prompt"	Delete macro from appropriate macro repository. Prompt for macro name to delete.
"delete"	"prompt"
"e"		Save, compile, and execute macro(s) in current buffer to/from appropriate macro repository. Execute first macro in buffer without prompting.
"execute"
"e"	"prompt"	Save, compile, and execute macro(s) in current buffer to/from appropriate macro repository. Prompt after compile for macro name to execute and optional parameters to pass to it.
"execute"	"prompt"
"f"		Fetch macro(s) from appropriate macro repository. Select macros from a request list of headers starting at line one fo current buffer. Append selected macros to the end of the current buffer in the same order as the request list.
"fetch"
"f"	"prompt"	Fetch macro from appropriate macro repository. Prompt for macro name to fetch. Insert macro at current cursor location of current buffer.
"fetch"	"prompt"
"h"		List the most current version of this page documenting the operation of tlaMDE.
"help"
"s"		Save macro(s) in current buffer to appropriate macro repository.
"save"

Example Function Calls

tlaMDE( "save" ) or tlaMDE s tlaMDE( "compile" ) or tlaMDE c tlaMDE( "execute" ) or tlaMDE e tlaMDE( "execute, "prompt" ) or tlaMDE e prompt tlaMDE( "delete" ) or tlaMDE d tlaMDE( "delete", "prompt" ) or tlaMDE d prompt tlaMDE( "fetch" ) or tlaMDE f tlaMDE( "fetch", "prompt" ) or tlaMDE f prompt tlaMDE( "help", "prompt" ) or tlaMDE h

Purchase

The tlaMDE DLL, that operates in both CodeWright and CodeWright for .NET, can be purchased by selecting the Buy button on this page. When the new window opens, follow the ordering instructions.

Input Parameters

Example Function Calls

Menu

Purchase