932
Appendix A: System Routines — Operating System
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
handleRclKey
Declaration:
void
handleRclKey
(BOOL
ReplaceCRs
)
Category(ies):
Operating System, Keyboard, Variables
Description:
Manages the dialog box which appears when
2
£
is pressed.
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
the contents of the variable have been converted to
text. The variable itself is not changed.
If FALSE, carriage returns remain unchanged.
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: /* User pressed [RCL] */
if (! (te->flags & TE_READ_ONLY)) /* Is my text field writeable? */
handleRclKey(FALSE); /* Yes, allow variable recall */
break; /* No, ignore [RCL] key */