L_PntIsValid

#include "LtPnt.h"

L_LTPNT_API L_INT L_PntIsValid(pPaint)

/* pointer to a paint handle */

Determines the validity of the given paint handle.

Parameter	Description
pPaint	Pointer to a paint handle.

Returns

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

See Also

Functions:	L_PntInit, L_PntFree
Topics:	DigitalPaint Functions: Initializing and Freeing the Paint Handle
	Initializing and Freeing DigitalPaint Handles

Example

This example shows how to use the L_PntIsValid function.

   L_INT PntIsValidExample(HWND hWnd,pPAINTHANDLE pPaint)
{
   L_INT 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 ) ;

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