Texas Instruments TI89 Developer Guide - Page 1104

1062 Appendix A: System Routines - Text Editing TE_open Declaration: Category(ies): Description: Inputs: BOOL TE_open (TERecord * teRec, WINDOW * w, WIN_RECT * editRect, HANDLE hText, USHORT cursor, USHORT promptlen, TE_FLAGS flags) Text Editing Open a text edit record. Initialize fields of teRec. w - Window containing edit field. editRect - Rectangle defining the window-relative extents of the edit field or NULL to use entire client rectangle of window w for the edit region. hText - Handle to the text to be edited. The text must be terminated with a zero (0x00) byte. If hText is H_NULL, TE_open will allocate a new handle and initialize it with no text. cursor - Offset from the beginning of the text to the position to display the edit cursor. Position 0 is to the left of the first character. If the contents of the text edit buffer are too long to display entirely in the edit region, the text is scrolled to make sure the cursor is visible. Set cursor to TE_FAR_RIGHT to place the edit cursor after the last character in the edit buffer. promptlen - Indicates how many characters at the beginning of the text make up a prompt. The user cannot change the text of the prompt characters nor move the edit cursor into the prompt. flags - Each bit specifies optional features of the text editor. 0x0001 TE_WRAP Set this flag to 1 for multiline edit regions. Set to 0 for single line edit regions. Text wraps around end of line to the beginning of the next line in multiline edit regions. The program editor is an example of a multiline edit region. The Home screen author line is an example of a single line edit region. (continued) TI-89 / TI-92 Plus Developer Guide Not for Distribution Beta Version January 26, 2001