In This Topic ▼

L_VecGetHitTest

Summary

Gets the current hit test settings.

Syntax

#include "ltvkrn.h"

L_LVKRN_API L_INT L_VecGetHitTest(pVector, pHitTest)

Parameters

const pVECTORHANDLE pVector

Pointer to a vector handle.

pVECTORHITTEST pHitTest

Pointer to a VECTORHITTEST structure to be updated with the current 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.

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

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