handleRclKey Function (ROM Call 0x14F)

events.h

void handleRclKey (short CRstatus);

Displays the standard "Recall Variable" dialog.

handleRclKey is the default handler for the 'RCL' key (called from EV_defaultHandler when processing a CM_RECALL message). A pop-up dialog box is displayed requesting the name of a variable. The contents of the variable are converted to text and pasted to the current application as a CM_HSTRING message. Nothing is pasted if the user pressed 'ESC' to cancel the dialog.

CRstatus is a boolean parameter. If it is TRUE, carriage returns are converted to colons after the contents of the variable have been converted to text. The variable itself is not changed. If it is FALSE, carriage returns remain unchanged.

Note: This function may cause heap compression and may throw errors.


Uses: EV_sendEvent, HeapAlloc, HeapFreeIndir, HeapGetLock, HeapLock, HeapUnlock, Dialog, ER_catch, ER_success, ER_throwVar, display_statements, HToESI, Parse1DExpr, TokenizeSymName, top_estack, memset, strchr, strlen, NeedStack, DerefSym, GetFuncPrgmBodyPtr, VarRecall
Used by: EV_defaultHandler


See also: handleVarLinkKey