Handlerclkey - Texas Instruments TI-89 Developer's Manual

932

handleRclKey

Declaration: void handleRclKey (BOOL ReplaceCRs )
Category(ies): Operating System, Keyboard, Variables
Manages the dialog box which appears when 2 £ is pressed.
Description:
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.
Inputs: ReplaceCRs — If TRUE, carriage returns are converted to colons after
Outputs: None
Assumptions: The current application receives a CM_PASTE_HANDLE command. It is
the responsibility of the application to make sure the handle contents are
pasted to a text field or to call the default event handler for this message if
the app has no active text field.
Nothing is pasted if the user pressed N to cancel the 2 £ dialog.
Side Effects: May cause heap compression. May throw errors.
Availability: All versions of the TI-89 / TI-92 Plus.
TI-89 / TI-92 Plus
Differences: None
See Also: Not applicable.
Example:
case CM_RCL:
if (! (te->flags & TE_READ_ONLY))
handleRclKey(FALSE);
break;
TI-89 / TI-92 Plus Developer Guide
Appendix A: System Routines — Operating System
the contents of the variable have been converted to
text. The variable itself is not changed.
If FALSE, carriage returns remain unchanged.
/* User pressed [RCL] */
/* Is my text field writeable? */
/* Yes, allow variable recall */
/* No, ignore [RCL] key */
Not for Distribution Beta Version January 26, 2001