AcDbPolyFaceMesh::appendFaceRecord

C++

Acad::ErrorStatus appendFaceRecord(
    AcDbFaceRecord*
);

Description

This function appends the AcDbFaceRecord pointed to by pNewFace to the end of the facelist of the PolyFaceMesh, establishes the PolyFaceMesh object as the FaceRecord's owner, and adds the FaceRecord to the database 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 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