Te_Open - Texas Instruments TI-89 Developer's Manual

1062

TE_open

Declaration: BOOL TE_open (TERecord * teRec , WINDOW * w ,
WIN_RECT * editRect , HANDLE hText , USHORT cursor ,
USHORT promptlen , TE_FLAGS flags )
Category(ies): Text Editing
Open a text edit record. Initialize fields of teRec .
Description:
w
Inputs:
editRect
hText
cursor
promptlen — Indicates how many characters at the beginning of the
flags
TI-89 / TI-92 Plus Developer Guide
Appendix A: System Routines — Text Editing
— Window containing edit field.
— Rectangle defining the window-relative extents of the edit
field or NULL to use entire client rectangle of window w for
the edit region.
— 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.
— 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.
text make up a prompt. The user cannot change the text
of the prompt characters nor move the edit cursor into the
prompt.
— 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)
Not for Distribution Beta Version January 26, 2001