#include "LtPnt.h"
L_LTPNT_API L_INT L_PntSetDCExtents(pPaint, prcRect)
pPAINTHANDLE pPaint; |
pointer to a paint handle |
const LPRECT prcRect; |
pointer to a RECT structure |
Sets the boundaries of the device context (DC).
Parameter |
Description |
pPaint |
Pointer to a paint handle. |
prcRect |
Pointer to a RECT structure that contains the boundaries of the user DC. |
SUCCESS |
The function was successful. |
< 1 |
An error occurred. Refer to Return Codes. |
It is best to set the boundaries of the device context (DC) before calling any functions that use the DC. In addition, the device context boundaries should be updated whenever the old boundaries become invalid, such as when the client area of the window has been resized.
Call this function before calling any of the following:
L_PntDrawShapeLine
L_PntDrawShapeRectangle
L_PntDrawShapeRoundRect
L_PntDrawShapeEllipse
L_PntDrawShapePolygon
L_PntDrawShapePolyBezier
L_PntRegionSurface
L_PntRegionBorder
L_PntRegionColor
L_PntFillSurface
L_PntFillBorder
L_PntFillColorReplace
L_PntPickColor
L_PntApplyText
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 |
/* This example shows how to set the user DC extents */
L_INT PntSetDCExtentsExample( HWND hWnd,
UINT state,
L_INT cxClient,
L_INT cyClient,
pPAINTHANDLE g_pPaint)
{
L_INT nRet;
UNREFERENCED_PARAMETER(hWnd);
UNREFERENCED_PARAMETER(state);
RECT rcNewRect, rcDCRect ;
SetRect ( &rcNewRect, 0, 0, cxClient, cyClient ) ;
/* Initiate the Paint toolkit */
nRet = L_PntInit ( &g_pPaint );
if ( SUCCESS != nRet)
{
return nRet;
}
/* Do the program sizing stuff */
nRet = L_PntGetDCExtents ( g_pPaint, &rcDCRect ) ;
if(nRet != SUCCESS)
return nRet;
if ( ! EqualRect ( &rcNewRect, &rcDCRect ) )
{
nRet = L_PntSetDCExtents ( g_pPaint, & rcNewRect ) ;
if(nRet != SUCCESS)
return nRet;
}
return SUCCESS;
}