Winstrxywrap - Texas Instruments TI-89 Developer's Manual

1196

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
x, y
Str
wwFlags — WWF_DRAW
Outputs: Returns the height in pixels of the text drawn.
The default attribute (A_NORMAL) can be changed with WinAttr.
Assumptions:
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.
TI-89 / TI-92 Plus Developer Guide
Appendix A: System Routines — Windows
— WINDOW struct of a previously opened window.
— Window position to write to, the x coordinate also specifies
the left margin to wrap on.
— Pointer to string to write.
Do actual draw (if not set then just the height of the text
drawn is returned).
WWF_WRAP_ON_COMMAS
Also wrap on commas.
Not for Distribution Beta Version January 26, 2001