Texas Instruments TI-89 - Setwinclip

1150
Appendix A: System Routines — Windows
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
SetWinClip
Declaration:
void
SetWinClip
(WINDOW *
w
, SCR_RECT *
sr
)
Category(ies):
Windows
Description:
Set the clip region of a window from a Client based SCR_RECT.
Inputs:
w
— WINDOW struct of a previously opened window.
sr
— Client based coordinates of new clipping region. So (0, 0) is upper
left coordinates of window, not screen.
Outputs:
sr
— The new clipping region of the window (screen based coordinates).
Assumptions:
None
Side Effects:
None
Availability:
On AMS 2.00 and higher.
TI
-
89 / TI
-
92 Plus
Differences:
None
See Also: MakeScrRect, WinOpen
Example:
WINDOW w;
SCR_RECT clip1, oldClip;
if (WinOpen(&w, MakeWinRect(10,10,90,50), WF_TTY )) {
WinActivate( &w );
oldClip = w.Clip;
SetWinClip( &w, MakeScrRect(2, 4,50,24,&clip1) );
WinStrXY( &w, 0,0,"This is\nClipped\nAs you can see" );
GKeyIn( NULL, 0 );
w.Clip = oldClip; /* clip region is SCREEN based, so to restore original clip
use the value saved before the call to SetWinClip. */
WinStrXY( &w, 0,0,"This is\nClipped\nAs you can see" );
GKeyIn( NULL, 0 );
WinClose(&w);
}