#include "LtPnt.h"
L_LTPNT_API L_INT L_PntGetClipRgn(pPaint, phClipRgn)
Gets the current clipping region, set using L_PntSetClipRgn.
Pointer to a paint handle.
Pointer to a Windows region handle to be updated with the current clipping region.
Value | Meaning |
---|---|
SUCCESS | The function was successful. |
< 1 | An error occurred. Refer to Return Codes. |
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
L_INT PntGetClipRgnExample(pPAINTHANDLE pPaint)
{
L_INT nRet;
HRGN hRgn, hClipRgn ;
/* create some region */
hRgn = CreateRectRgn ( 0, 0, 100, 100 ) ;
/* Initiate the Paint toolkit */
nRet = L_PntInit ( &pPaint );
if ( SUCCESS != nRet)
{
return nRet;
}
/* 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;
}