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