Available in LEADTOOLS Vector Imaging toolkits. |
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; }