L_PntOffsetClipRgn
#include "LtPnt.h"
L_LTPNT_API L_INT L_PntOffsetClipRgn(pPaint, nDx, nDy)
pPAINTHANDLE pPaint; |
/* pointer to a paint handle */ |
L_INT nDx; |
/* x-offset */ |
L_INT nDy; |
/* y-offset */ |
Offsets the paint-clipping region of the device context (DC) and the bitmap.
Parameter |
Description |
pPaint |
Pointer to a paint handle. |
nDx |
The offset in the horizontal direction. |
nDy |
The offset in the vertical direction. |
Returns
SUCCESS |
The function was successful. |
< 1 |
An error occurred. Refer to Return Codes. |
Comments
The toolkit will perform the necessary transformations to the offset values, using the current painting transformation values set by calling L_PntSetTransformation. Therefore, the user should provide the offset values without any transformations.
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_PntGetClipRgn, L_PntSetTransformation, L_PntGetTransformation |
Topics: |
|
|
Example
L_INT PntOffsetClipRgnExample(pPAINTHANDLE pPaint) { L_INT nRet; HRGN hRgn ; /* create some region */ hRgn = CreateRectRgn ( 0, 0, 100, 100 ) ; /* set the painting tools new DC clip region */ nRet = L_PntSetClipRgn ( pPaint, hRgn) ; if(nRet != SUCCESS) return nRet; /* offset the current painting tools clipping region */ /* using the current transformatoin settings */ nRet = L_PntOffsetClipRgn ( pPaint, 10, 10) ; if(nRet != SUCCESS) return nRet; /* delete the regions */ DeleteObject ( ( HRGN ) hRgn ) ; return SUCCESS; }