Main Page | Modules | Alphabetical List | Data Structures | Directories | File List | Data Fields | Globals | Related Pages

Clipping operations
[GDI functions]

Functions

Function Documentation

void GUIAPI ClipRectIntersect (  HDC  hdc,
const RECT *  prc
) 
 

Intersects the specified rectangle with the visible region of the DC.

This function intersects the specified rectangle prc with the visible region of the device context hdc.

Parameters:
hdc The device context.
prc Pointer to the rectangle.
See also:
IncludeClipRect, ExcludeClipRect, Region operations

void GUIAPI ExcludeClipRect (  HDC  hdc,
const RECT *  prc
) 
 

Excludes the specified rectangle from the current visible region of a DC.

This function excludes the specified rect prc from the current visible region of the device context hdc.

Parameters:
hdc The device context.
prc The rectangle to be excluded.
See also:
IncludeClipRect, Region operations

void GUIAPI GetBoundsRect (  HDC  hdc,
RECT *  pRect
) 
 

Retrives the bounding rectangle of the current visible region of a DC.

This function retrives the bounding rectangle of the current visible region of the specified device context hdc, and returned through pRect.

Parameters:
hdc The device context.
pRect The bounding rectangle will be returned through this buffer.
See also:
Region operations

void GUIAPI IncludeClipRect (  HDC  hdc,
const RECT *  prc
) 
 

Includes the specified rectangle to the current visible region of a DC.

This function includes the specified rectangle prc to the current visible region of the device context hdc.

Parameters:
hdc The device context.
prc The rectangle to be included.
See also:
ExcludeClipRect, Region operations

BOOL GUIAPI PtVisible (  HDC  hdc,
int  x,
int  y
) 
 

Checks whether a point is visible.

This function checks whether the point specified by (x,y) is visible, i.e. it is within the current visible clipping region of the device context hdc.

Parameters:
hdc The device context.
x x,y: The coordinates of the point.
y x,y: The coordinates of the point.
Returns:
TRUE for visible, else for not.
See also:
RectVisible, Region operations

BOOL GUIAPI RectVisible (  HDC  hdc,
const RECT *  pRect
) 
 

Checks whether the specified rectangle is visible.

This function checks whether the rectangle pointed to by pRect is visible, i.e. it is intersected with the current visible region of the device context hdc.

Parameters:
hdc The device context.
pRect Pointer to the rectangle.
See also:
PtVisible, Region operations
Example:

/*
 * Use RectVisible to optimize the repaint of the window.
 */
MSG_PAINT:
{
        HDC hdc = BeginPaint (hWnd);

        for (j = 0; j < 10; j ++) {
                if (RectVisible  (hdc, rcs + j)) {
                        FillBox (hdc, rcs[j].left, rcs[j].top, rcs [j].right, rcs [j].bottom);
                }
        }

        EndPaint (hWnd, hdc);
        return 0;
}

void GUIAPI SelectClipRect (  HDC  hdc,
const RECT *  prc
) 
 

Sets the visible region of a DC to be a rectangle.

This function sets the visible region of the device context hdc to the rectangle pointed to by prc.

Parameters:
hdc The device context.
prc Pointer to the rectangle.
See also:
SelectClipRegion, Region operations

void GUIAPI SelectClipRegion (  HDC  hdc,
const CLIPRGN *  pRgn
) 
 

Sets the visible region of a DC to be a region.

This function sets the visible region of the device context hdc to the region pointed to by pRgn.

Parameters:
hdc The device context.
pRgn Pointer to the region.
See also:
SelectClipRect, Region operations

Generated on Mon Jun 26 13:54:30 2006 for MiniGUI V1.6.9 API Reference by  doxygen 1.4.2