In This Topic ▼

L_PntIsValid

Summary

Determines the validity of the given paint handle.

Syntax

#include "LtPnt.h"

L_LTPNT_API L_INT L_PntIsValid(pPaint)

Parameters

pPAINTHANDLE pPaint

Pointer to a paint handle.

Returns

Value	Meaning
SUCCESS	The function was successful.
< 1	An error occurred. Refer to Return Codes.

Comments

The paint handle will be valid after calling L_PntInit, and will remain valid until L_PntFree is called.

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

Example

This example shows how to use the L_PntIsValid function.

L_INT PntIsValidExample(HWND hWnd,pPAINTHANDLE pPaint) 
{ 
   L_INT nRet; 
 
   /* Initiate the Paint toolkit */ 
   nRet = L_PntInit ( &pPaint ); 
   if ( SUCCESS != nRet) 
   { 
      return nRet; 
   } 
 
   nRet = L_PntIsValid ( pPaint ); 
   if ( SUCCESS == nRet ) 
   { 
      HDC   hDC; 
      RECT  rcShape; 
 
      /* Get the device context */ 
      hDC = GetDC ( hWnd ) ; 
 
      /* Set the coordinates with respect to the DC dimensions */ 
      SetRect ( &rcShape, 10, 10, 150, 150 ) ; 
 
      /* Set the DC Extents */ 
      RECT rcClient; 
      GetClientRect(hWnd, &rcClient); 
      nRet = L_PntSetDCExtents ( pPaint, &rcClient ); 
 
      /* Use the current shape properties to draw an ellipse to DC (hDC) */ 
      nRet = L_PntDrawShapeEllipse ( pPaint, hDC, &rcShape ) ; 
      if(nRet != SUCCESS) 
         return nRet; 
 
      /* Release the device context */ 
      ReleaseDC ( hWnd, hDC ) ; 
   } 
   else 
   { 
      MessageBox ( hWnd, TEXT("Invalid PAINTHANDLE"), TEXT("Error"), MB_OK ) ; 
      return nRet; 
   } 
 
   return SUCCESS ; 
}