L_PntGetClipRgn

#include "LtPnt.h"

L_LTPNT_API L_INT L_PntGetClipRgn(pPaint, phClipRgn)

pPAINTHANDLE pPaint;

/* pointer to a paint handle */

pHRGN phClipRgn;

/* pointer to a Windows region handle */

Gets the current clipping region, set using L_PntSetClipRgn.

Parameter

Description

pPaint

Pointer to a paint handle.

phClipRgn

Pointer to a Windows region handle to be updated with the current clipping region.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

The phClipRgn parameter is updated with a windows region, which is a snapshot of the current clipping region, used by the toolkit. The user is responsible for deleting this region.

Required DLLs and Libraries

LTPNT

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application

See Also

Functions:

L_PntSetClipRgn, L_PntOffsetClipRgn

Topics:

DigitalPaint Functions: Region Processing

 

Setting a DigitalPaint Clipping Region

Example

 L_INT PntGetClipRgnExample(pPAINTHANDLE pPaint)
{
   L_INT nRet;
   HRGN hRgn, hClipRgn ;

   /* create some region */
   hRgn = CreateRectRgn ( 0, 0, 100, 100 ) ;

   /* get the current painting tools clip region */
   nRet = L_PntGetClipRgn ( pPaint, &hClipRgn) ;
   if(nRet != SUCCESS)
      return nRet;

   /* combine the regions */
   CombineRgn ( hRgn, hClipRgn, hRgn, RGN_OR ) ;

   /* set the painting tools new clip region */
   nRet = L_PntSetClipRgn ( pPaint, hRgn) ;
   if(nRet != SUCCESS)
      return nRet;

   /* delete the regions */
   DeleteObject ( ( HRGN ) hRgn ) ;
   DeleteObject ( ( HRGN ) hClipRgn ) ;
   return SUCCESS;
}