Texas Instruments TI89 Developer Guide - Page 1109

Appendix A: System Routines - Text Editing 1067 TE_pasteText Declaration: void TE_pasteText (TERecord * teRec, UCHAR * text, size_t size) Category(ies): Description: Inputs: Text Editing 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 TE_open or TE_openFixed. text - Pointer to a character array of text to insert into edit buffer. size - Byte length of character array to insert into edit buffer. 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 Differences: None See Also: TE_open (continued) TI-89 / TI-92 Plus Developer Guide Not for Distribution Beta Version January 26, 2001