L_PntSetDCExtents

Summary

Sets the boundaries of the device context (DC).

Syntax

L_LTPNT_API L_INT L_PntSetDCExtents(pPaint, prcRect)

Parameters

pPAINTHANDLE pPaint

Pointer to a paint handle.

const LPRECT prcRect

Pointer to a RECT structure that contains the boundaries of the user DC.

Returns

Comments

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

See Also

Functions

• L_PntRegionSurface
• L_PntRegionBorder
• L_PntRegionColor
• L_PntFillSurface
• L_PntFillBorder
• L_PntFillColorReplace
• L_PntPickColor
• L_PntGetDCExtents

Topics

• DigitalPaint Functions: Getting and Setting the DC Boundaries
• Setting General DigitalPaint Information

Example

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; 
}