L_VecHideObject

#include "lvkrn.h"

L_LVKRN_API L_INT L_VecHideObject(pVector, pObject, bHide)

const pVECTORHANDLE pVector;	/* pointer to a vector handle */
pVECTOROBJECT pObject;	/* pointer to a vector object */
L_BOOL bHide;	/* flag that indicates whether to hide or show an object */

Hides or shows an object.

Parameter	Description
pVector	Pointer to a vector handle. Objects within this vector handle will be hidden or shown.
pObject	Pointer to a VECTOROBJECT structure that references an object to be hidden or shown.
bHide	Flag that indicates whether to hide or show the specified object. Possible values are:
	Value	Meaning
	TRUE	Hide the specified object.
	FALSE	Show the specified object.

Returns

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

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

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_VecIsObjectHidden, L_VecSelectObject, L_VecIsObjectSelected, L_VecDeleteObject, L_VecHitTest, L_VecGetObject

Example

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

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