1062
Appendix A: System Routines — Text Editing
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
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
Description:
Open a text edit record. Initialize fields of
teRec
.
Inputs:
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)
To Next Page
Loading...
Need help?
General
