Texas Instruments TI-89 - Te_Indicatereadonly

1060
Appendix A: System Routines — Text Editing
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
TE_indicateReadOnly
Declaration:
void
TE_indicateReadOnly
(TERecord *
teRec
)
Category(ies):
Text Editing
Description:
If text edit record
teRec
was opened with the TE_READ_ONLY flag set,
turns on the read-only indicator (padlock symbol) in the status line and
disables menu commands “Cut,” “Paste,” “Delete,” and “Clear All” if they
are defined in the application’s registered menu.
Inputs:
teRec
— The state record of a text edit field.
Outputs:
None
Assumptions:
The application should call this routine after it opens a read-only text edit
field or if it is focused on a text edit field when it is activated (receives
CM_ACTIVATE message).
The application should call
ST_readOnly
(ST_READONLY_OFF) to turn off
the status line read-only indicator when it is deactivated (receives
CM_DEACTIVATE message).
Side Effects:
None
Availability:
All versions of the TI
-
89 / TI
-
92 Plus.
TI
-
89 / TI
-
92 Plus
Differences:
None
See Also: TE_open, ST_readOnly
Example:
TE_open(&teRec, &window, NULL, hText, 0, 0, TE_READ_ONLY | TE_WRAP);
/* open read-only text */
TE_indicateReadOnly(&teRec); /* turn on padlock and dim edit menus */