Topic       : The ATARI Compendium
Author      : Scott Sanders / JAY Software
Version     : 1.25 (20/6/2003)
Subject     : Documentation
Nodes       : 1117
Index Size  : 32614
HCP-Version : 6
Compiled on : Atari
@charset    : UTF-8
@lang       : en
@default    : 
@help       : %About
@options    : +g -i -t4 +y +z
@width      : 100
View Ref-FileGetNextRect()
XCONTROL Utility Functions
GetFirstRect()                                                     XCONTROL

Syntax

GRECT *(*xcpb->GetFirstRect)( prect )
GRECT *prect;

Function      GetFirstRect() returns the first member of the Control
              Panel's rectangle list intersected by prect.

Parameters    prect points to a GRECT containing the extent of the dirtied
              area.

Binding       rdraw = (*xcpb->GetFirstRect)( prect );

Return Value  GetFirstRect() will return a pointer to a GRECT containing
              the first intersecting rectangle to redraw or NULL if none
              of the CPX's rectangles intersect the dirtied area.

Comments      Xform_do() handles resource object redraws in Form CPX's.
              Other objects requiring a redraw in Form CPX's and all
              objects in Event CPX's must be redrawn with using these
              functions when a redraw message is generated.

See Also      GetNextRect()

Group         XCONTROL Utility Functions