API Tcl/Tk Commands

For background information about the commands described on this page, refer to the information about the Tcl/Tk interface in the corresponding section of the API reference.

On this page, API commands of the Tcl category are described. This category covers all commands to use the uDraw(Graph) Tcl/Tk interface. The commands of this category are enclosed by keyword "tcl(...)". Click here to get an overview of all API commands.

tcl(eval(string))

Sends a Tcl/Tk script "string" to the uDraw(Graph) Tcl/Tk interface and waits for the result (i.e. return value) of this script which can be found in the "string" of the API answer tcl_answer that is sent back to the application as soon as the script has finished. uDraw(Graph) is blocked as long as the Tcl script is executed.

Note 1: This command returns the answer tcl_answer instead of the usual answer ok!

Note 2: The Tcl/Tk script in "string" must not contain return or newline characters and all double quotes inside the string have to be escaped (i.e. \").

tcl(eval_file(filename))

Same as API command tcl(eval(...)) above, but here the Tcl/Tk script is read from the specified file rather than taken from the parameter. So the whole script does not need to be transferred by the API. Use this command for large scripts or if you cannot fulfill the API restriction for strings in the Tcl script (i.e. no return/newline characters and no unescaped double quotes).

Note 1: This command returns the answer tcl_answer instead of the usual answer ok!

Note 2: Windows^® users please use "/" (slash) instead of "\" (backslash) as a directory separator.