Empties the specified group. This function is available in the LEADTOOLS Vector Imaging Pro Toolkit.
#include "ltvkrn.h"
L_LVKRN_API L_INT L_VecEmptyGroup(pVector, pGroup)
Pointer to the vector handle.
Pointer to a VECTORGROUP structure that references the group to be emptied.
Value | Meaning |
---|---|
SUCCESS | The function was successful. |
< 1 | An error occurred. Refer to Return Codes. |
The specified group is emptied by deleting all objects within that group.
To delete a group, call L_VecDeleteGroup.
After calling this function, all clone objects of this group will reflect the change immediately.
This example will delete all objects inside the group with the given name.
L_LTVKRNTEX_API L_INT VecEmptyGroupExample(
pVECTORHANDLE pVector,
L_TCHAR* pszName)
{
VECTORGROUP Group;
L_INT nRet;
/* Get the group with the given name */
nRet = L_VecGetGroupByName( pVector, pszName, &Group );
if( SUCCESS == nRet )
nRet = L_VecEmptyGroup ( pVector, &Group ); /* empty out */
return nRet;
}