Setwinclip - Texas Instruments TI-89 Developer's Manual

1150

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
Outputs:
sr
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;
WinStrXY( &w, 0,0,"This is\nClipped\nAs you can see" );
GKeyIn( NULL, 0 );
WinClose(&w);
}
TI-89 / TI-92 Plus Developer Guide
left coordinates of window, not screen.
— The new clipping region of the window (screen based coordinates).
/* clip region is SCREEN based, so to restore original clip
use the value saved before the call to SetWinClip. */
Not for Distribution
Appendix A: System Routines — Windows
Beta Version January 26, 2001