1196
Appendix A: System Routines — Windows
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
WinStrXYWrap
Declaration:
short
WinStrXYWrap
( WINDOW *
w
, WIN_COORDS
x
, WIN_COORDS
y
,
char *
Str
, WORD
wwFlags
)
Category(ies):
Windows
Description:
Draw a word-wrapped string to a window at position
x, y
(pixel based). The
current pen location is updated to point to the end of where the string was
written. Words are wrapped on spaces and newlines. The height in pixels
of the text drawn is returned. The text is drawn to fit from the
x
coordinate
passed to the right edge of the window.
NOTE:
If the WWF_DRAW bit in
wwFlags
is not set then no drawing is done.
Inputs:
w
— WINDOW struct of a previously opened window.
x, y
— Window position to write to, the
x
coordinate also specifies
the left margin to wrap on.
Str
— Pointer to string to write.
wwFlags
— WWF_DRAW
Do actual draw (if not set then just the height of the text
drawn is returned).
WWF_WRAP_ON_COMMAS
Also wrap on commas.
Outputs:
Returns the height in pixels of the text drawn.
Assumptions:
The default attribute (A_NORMAL) can be changed with
WinAttr
.
The default font (F_6x8) can be changed with
WinFont
.
The supported values for character attributes are: A_NORMAL,
A_REVERSE, A_XOR, A_SHADED, and A_REPLACE. See
WinAttr
for a
detailed description of the character attributes.
Side Effects:
None
Availability:
On AMS 2.04 and higher.
TI
-
89 / TI
-
92 Plus
Differences:
None
See Also: WinAttr
,
WinChar, WinCharXY
,
WinFont
,
WinStr
Example:
See
WinCharXY
for the source to this routine since it is not available
before AMS 2.04.