L_VecHideObject

Summary

Hides or shows an object.

Syntax

L_LVKRN_API L_INT L_VecHideObject(pVector, pObject, bHide)

Parameters

const pVECTORHANDLE pVector

Pointer to a vector handle. Objects within this vector handle will be hidden or shown.

pVECTOROBJECT pObject

Pointer to a VECTOROBJECT structure that references an object to be hidden or shown.

L_BOOL bHide

Flag that indicates whether to hide or show the specified object. Possible values are:

Returns

Comments

Hides or shows an object within the specified vector handle.

A hidden object will not be drawn. It will also not be returned when calling the L_VecHitTest function.

Please note that you will have to update the window to see the results of this function.

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.

See Also

Functions

• L_VecIsObjectHidden
• L_VecSelectObject
• L_VecIsObjectSelected
• L_VecDeleteObject
• L_VecHitTest
• L_VecGetObject

Example

This example will hide the object under a given 2D point.

L_LTVKRNTEX_API L_INT VecHideObjectExample( 
   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, hide it */ 
      nRet = L_VecHideObject( pVector, &Object, TRUE ); 
 
   return nRet; 
}