L_PntIsValid

#include "LtPnt.h"

L_INT EXT_FUNCTION L_PntIsValid(pPaint)

pPAINTHANDLE 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 Test ( pPAINTHANDLE pPaint, HWND hWnd )
{
   if ( SUCCESS == L_PntIsValid ( pPaint ) ) 
   {
      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) */
      L_PntDrawShapeEllipse ( pPaint, hDC, &rcShape ) ;

      /* Release the device context */
      ReleaseDC ( hWnd, hDC ) ;
   }
   else
   {
      MessageBox ( hWnd, TEXT("Invalid PAINTHANDLE"), TEXT("Error"), MB_OK ) ;
   }

   return SUCCESS ;
}