HM_ExtAPI::GetRootCADDocument()

Returns the root document in the model assembly hierarchy of the CAD model loaded into HyperMesh database.

Syntax

bool GetRootCADDocument(
HM_CAD_Document & doc,
Int&  doc_index
);

Type

HyperMesh Ext API

Description

The function GetRootCADDocument is used together with the functions HM_ExtAPI::CADDocumentGetFirstChild() and HM_ExtAPI::CADDocumentGetNext() to browse each of independent model assembly hierarchy trees.

The function GetRootCADDocument is used together with the function HM_ExtAPI::GetRootCADDocumentsCount(). The function HM_ExtAPI::GetRootCADDocumentsCount() is used to get the total number of independent assembly hierarchy trees.

If the function succeeds, the return value is true. If the function fails, the return value is false. To get extended value information, call HM_ExtAPI::GetLastErrorCode().

Requires including hm_extapi.h.

Inputs

doc
[out] - Handle to the root document. The value of the handle is zero in case if no model is loaded or there is no hierarchy associated with currently loaded model.
doc_index
[in] - Root document zero-based index. The value must be in the range from 0 to docs_count where docs_count is the number of root documents as returned by the function HM_ExtAPI::GetRootCADDocumentsCount().

Errors

None.