L_VecSelectObject

#include "lvkrn.h"

L_INT EXT_FUNCTION L_VecSelectObject(pVector, pObject, bSelect)

const pVECTORHANDLE pVector;

/* pointer to a vector handle */

pVECTOROBJECT pObject;

/* pointer to a vector object */

L_BOOL bSelect;

/* flag that indicates whether to select or unselect */

Selects or unselects an object.

Parameter

Description

pVector

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

pObject

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

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

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

Selects or unselects an object within the specified vector handle.

This function is not supported in the OpenGL and DirectX engines.

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_VecIsObjectSelected, L_VecDeleteObject, L_VecHitTest, L_VecGetObject

Example

/* This example will select the object under a given 2D point */

void SelectObjectUnder( pVECTORHANDLE pVector, POINT L_FAR *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 */
      L_VecSelectObject( pVector, &Object, TRUE );
   }
}