hm_registerkeyproc

Syntax

hm_registerkeyproc key file command

HyperMesh Tcl Query

Registers a script or command to a keyboard shortcut.

key: The key to register. This utilizes standard Tcl keysyms. There are three shortcut combinations that can be used, Ctrl-<key>, Shift-<key> and Ctrl-Shift-<key>. Note that when Shift is used in a combination, the key must be upper case.
file: The full path and file name of a Tcl script to register. If specified, the script is sourced when executing the shortcut. If not needed, must be set as {}.
command: The name of a command or procedure to execute. If specified, the command or procedure is run when executing the shortcut. If file is defined, the script is sourced before running the command. If not needed, must be set as {}.

To register hm_callhelp to the F1 key:

hm_registerkeyproc F1 {} "hm_callhelp"

To register the color panel to the Shift-F1 key:

hm_registerkeyproc Shift-F1 {} "hm_pushpanel {color}"

To register the script C:\temp\my_script.tcl to the r key:

hm_registerkeyproc r {C:/temp/my_script.tcl} {}

To register the script C:\temp\my_script.tcl and the procedure ::my_proc::main to the R key:

hm_registerkeyproc Shift-R {C:/temp/my_script.tcl} {::my_proc::main}

Incorrect usage results in a Tcl error. To detect errors, you can use the catch command:

if { [ catch {command_name...} ] } {
   # Handle error
}

13.0.110