L_VecGetHitTest

#include "lvkrn.h"

L_LVKRN_API L_INT L_VecGetHitTest(pVector, pHitTest)

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

Gets the current hit test settings.

Parameter	Description
pVector	Pointer to a vector handle.
pHitTest	Pointer to a VECTORHITTEST structure to be updated with the current 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.

The hit test settings can be changed by calling L_VecSetHitTest.

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

Example

This example will toggle dwFlags when doing hit testing.

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

   /* Get the hit test settings */
   nRet = L_VecGetHitTest( pVector, &HitTest );
   if(nRet != SUCCESS)
      return nRet;

   /* Toggle checking for closed areas */
   if( HitTest.dwFlags & VECTOR_HITTEST_CLOSEDFIGURES )
      HitTest.dwFlags &= ~VECTOR_HITTEST_CLOSEDFIGURES;
   else
      HitTest.dwFlags |= VECTOR_HITTEST_CLOSEDFIGURES;

   /* Set new hit test settings */
   nRet = L_VecSetHitTest( pVector, &HitTest );

   return nRet;
}