HM_ExtAPI::ComponentGetNextElement()
Returns the next element in a mesh component.
Syntax
bool ComponentGetNextElement(
const HM_EntityMesh& hmesh,
const HM_EntityMeshComponent& hcomp,
HM_EntityElement& helem
);Type
HyperMesh Ext API
Description
This is used together with the function HM_ExtAPI::ComponentGetFirstElement() to iterate through all the elements contained in the component referenced by the mesh and component objects. A call to the HM_ExtAPI::ComponentGetFirstElement() function resets the internal element counter of the mesh object to the first element. Subsequent calls to HM_ExtAPI::ComponentGetNextElement() increment the counter until all elements of the component are iterated.
If the function fails, the return value is false. To get extended value information, call HM_ExtAPI::GetLastErrorCode().
Requires including hm_extapi.h.
Inputs
- hmesh
- [in] - Handle to mesh object that was returned by previous calls to API functions.
- hcomp
- [in] - Handle to mesh component object that was returned by previous calls to API functions for the mesh object referenced by hmesh.
- helem
- [out] - Handle to the next element in the mesh component referenced by the mesh and component objects. The value of the handle is zero in case the component does not have any elements, or if all elements contained in the component were already returned by previous calls to this function.
Errors
None.
Version History
11.0.101