Te_Pastetext - Texas Instruments TI-89 Developer's Manual

Appendix A: System Routines — Text Editing

TE_pasteText

Declaration: void TE_pasteText (TERecord * teRec , UCHAR * text , size_t size )
Category(ies): Text Editing
Description: Insert text into edit buffer at the cursor blink location or replace highlighted
text in the edit buffer.
The cursor is normally moved to the end of the newly inserted text. A
different cursor location may be indicated by an embedded character '\002'
(TE_SELECTION_MARKER) in the text where the cursor should be
located. Furthermore, two embedded selection marker characters delimit a
range of characters to highlight.
For example, inserting the text "ABC\002DEF" leaves the cursor between C
and D instead of after F. Inserting the text "ABCD\002EFGH\002IJKL"
leaves the characters EFGH highlighted, thus: ABCDEFGHIJKL.
If the TE_WRAP flag is not set in the text edit record teRec , carriage return
characters are converted into colons to show where lines are separated.
See TE_open for a description of the TE_WRAP flag.
teRec — Pointer to text edit record previously initialized with a call to
Inputs:
text
size
Outputs: The edit buffer in teRec is updated with inserted text.
Assumptions: The character array pointed to by text must not move during the paste
operation. If the text being inserted resides in the memory heap, you
should lock its handle before passing the address of the text array to
TE_pasteText. You can use Hlock to lock a handle and look up its
address in one operation.
Side Effects: Inserting text can cause a memory full error in which case the new text is
not inserted and the edit buffer remains unchanged.
The heap may be compressed.
Availability: All versions of the TI-89 / TI-92 Plus.
TI-89 / TI-92 Plus
None
Differences:
See Also: TE_open
TI-89 / TI-92 Plus Developer Guide
TE_open or TE_openFixed.
— Pointer to a character array of text to insert into edit buffer.
— Byte length of character array to insert into edit buffer.
(continued)
Not for Distribution
1067
Beta Version January 26, 2001