AcDbPolyFaceMesh::appendFaceRecord

C++

Acad::ErrorStatus appendFaceRecord(
    AcDbObjectId&, 
    AcDbFaceRecord*
);

Description

This function appends the AcDbFaceRecord object pointed to by pNewFace to the end of the facelist of the PolyFaceMesh, establishes the PolyFaceMesh as the FaceRecord's owner, and adds the FaceRecord to the AcDbDatabase that contains the PolyFaceMesh (the PolyFaceMesh must be database-resident for this function to succeed).

The appended FaceRecord must be explicitly closed by the calling application after the appendFaceRecord() call returns.

Returns Acad::eOk if successful. If the PolyFaceMesh is not yet database-resident, then the append fails and Acad::eNoDatabase is returned. If the FaceRecord contains any vertex indices greater than the vertex count of the PolyFaceMesh, then the append fails and Acad::eInvalidMeshVertexIndex is returned.

All vertices must be appended before any FaceRecords are appended. Once even one FaceRecord has been appended, the appendVertex() methods no longer work.

Parameters

Links

AcDbPolyFaceMesh