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-FileGetFirstRect()
XCONTROL Utility Functions
GetNextRect()                                                      XCONTROL

Syntax

GRECT *(*xcpb->GetNextRect)( VOID )

Function      GetNextRect() returns subsequent rectangles needing to be
              redrawn after first calling GetFirstRect().

Binding       rdraw = (*xcpb->GetNextRect)();

Return Value  GetNextRect() returns a pointer to a GRECT structure
              containing a subsequent rectangle needing to be redrawn.

Comments      When a redraw message is received, it should be handled as
              illustrated below (the example given is for an Event CPX but
              it may be applied to the WM_REDRAW message handling section
              of a Form CPX as well):

              VOID
              cpx_draw( clip )
              GRECT *clip;
              {
               GRECT *rdraw;

               rdraw = (*xcpb->GetFirstRect)( clip );

               while( rdraw )
               {
                /* User redraw function */
                my_redraw( rdraw );
                rdraw = (*xcpb->GetNextRect)();
               }
              }

See Also      GetFirstRect()

Group         XCONTROL Utility Functions