In This Topic ▼

L_VecSetHitTest

Summary

Sets the new hit test settings.

Syntax

#include "ltvkrn.h"

L_LVKRN_API L_INT L_VecSetHitTest(pVector, pHitTest)

Parameters

pVECTORHANDLE pVector

Pointer to a vector handle.

const pVECTORHITTEST pHitTest

Pointer to a VECTORHITTEST structure that contains the new hit test settings.

Returns

Value	Meaning
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

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