L_LVKRN_API L_INT L_VecEmptyGroup(pVector, pGroup)
Empties the specified group. This function is available in the LEADTOOLS Vector Imaging Pro Toolkit.
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.
Required DLLs and Libraries
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;
}