Te_Shrinkwrap - Texas Instruments TI-89 Developer's Manual

1072

TE_shrinkWrap

Declaration: HANDLE TE_shrinkWrap (TERecord * teRec )
Category(ies): Text Editing
Description: Returns handle to edit buffer. This routine turns off the cursor and frees
any slack space in the edit buffer. Unlike TE_close, this routine does not
release edit buffer memory.
During normal edit processing, the text editor keeps some slack space in
the edit buffer. This allows new text to be inserted quickly without annoying
pauses while the edit buffer is expanded to accommodate another
character. TE_shrinkWrap removes the slack space before returning the
edit buffer to you.
teRec — Pointer to text edit record previously initialized with a call to
Inputs:
Outputs: Returns a handle to the edit buffer. A null byte marks the end of the text in
the edit buffer.
Assumptions: This routine does not free edit buffer memory. You must either free the edit
buffer handle or call TE_close to do it when you are finished with the text.
Side Effects: Cursor blink is turned off.
All versions of the TI-89 / TI-92 Plus.
Availability:
TI-89 / TI-92 Plus
Differences: None
See Also: TE_open, TE_openFixed, TE_reopen, TE_reopenPlain
Example:
hBuf = TE_shrinkWrap(&teRec);
.
. /* process contents of edit buffer */
.
if (bSelectAll)
TE_reopen(&teRec, TRUE);
else
TE_reopenPlain(&teRec, TRUE);
TI-89 / TI-92 Plus Developer Guide
Appendix A: System Routines — Text Editing
TE_open or TE_openFixed.
/* get handle to edit buffer */
/* select all text */
/* start cursor/select where TE_shrinkWrap left it */
Not for Distribution Beta Version January 26, 2001