In This Topic ▼

L_VecSelectObject

Summary

Selects or unselects an object.

Syntax

#include "ltvkrn.h"

L_LVKRN_API L_INT L_VecSelectObject(pVector, pObject, bSelect)

Parameters

const pVECTORHANDLE pVector

Pointer to a vector handle. Objects within this vector handle will be selected or unselected.

pVECTOROBJECT pObject

Pointer to a VECTOROBJECT structure that references an object to be selected or unselected.

L_BOOL bSelect

Flag that indicates whether to select or unselect the specified object. Possible values are:

Value	Meaning
TRUE	Select the specified object.
FALSE	Unselect the specified object.

Returns

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

Comments

Selects or unselects an object within the specified vector handle.

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 select the object under a given 2D point.

L_INT VecSelectObjectExample( 
   pVECTORHANDLE pVector, 
   POINT* pPoint) 
{ 
   VECTOROBJECT   Object;    /* Object under point */ 
   L_INT          nRet; 
 
   /* Get object under that point */ 
   nRet = L_VecHitTest( pVector, pPoint, &Object ); 
 
   /* Is there an object under that point? */ 
   if( nRet == SUCCESS ) 
      /* Yes, select it */ 
      nRet = L_VecSelectObject( pVector, &Object, TRUE ); 
 
   return nRet; 
}