L_VecSetHitTest

#include "lvkrn.h"

L_LVKRN_API L_INT L_VecSetHitTest(pVector, pHitTest)

pVECTORHANDLE pVector;	/* pointer to a vector handle */
const pVECTORHITTEST pHitTest;	/* pointer to a structure */

Sets the new hit test settings.

Parameter	Description
pVector	Pointer to a vector handle.
pHitTest	Pointer to a VECTORHITTEST structure that contains the new hit test settings.

Returns

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

Comments

The hit test settings determine the behavior of the hit test. The hit test itself is performed by calling L_VecHitTest.

To get the current hit test settings, call L_VecGetHitTest.

For more information on possible hit test settings, refer to the VECTORHITTEST structure.

Required DLLs and Libraries

LVKRN

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_VecGetHitTest, L_VecHitTest
Topics:	Working with Vector Objects

Example

This example will set the new hit test settings.

L_INT VecSetHitTestExample(pVECTORHANDLE pVector)
{
   VECTORHITTEST   HitTest;  /* Hittest settings */

   /* Allow for 4 pixels error calibration value */
   HitTest.nDistance = 4;

   /* Allow hittest checking to be done inside closed figures as well */
   HitTest.dwFlags = VECTOR_HITTEST_CLOSEDFIGURES;

   /* Set new hittest settings */
   return L_VecSetHitTest( pVector, &HitTest );
}