AcDbPolygonMesh::openVertex

C++

ACDBCORE2D_PORT Acad::ErrorStatus openVertex(
    AcDbPolygonMeshVertex*&, 
    AcDbObjectId vertId, 
    AcDb::OpenMode, 
    bool openErasedOne = false
);

Description

Deprecated. This function provides access to the PolyMesh's vertices and FaceRecords. The function is passed in an empty pointer, pVertex. VertId is the object ID of the vertex to open. openMode is the mode to open in. openErasedOne is a Boolean indicating whether or not to open the object if it's erased.

The mode argument may be one of the following:

AcDb::kForRead

AcDb::kForWrite

AcDb::kForNotify

If the open attempt is successful, then pVertex is set to the address of the object and Acad::eOk will be returned.

If openErasedEntity is Adesk::kFalse, then attempting to open an erased vertex fails and this function returns Acad::eWasErased.

If attempting to open AcDb::kForRead and the vertex is already opened for read the maximum of 256 times, then the open attempt fails and this function returns Acad::eAtMaxReaders.

If the vertex is currently open AcDb::kForNotify, then the open attempt fails and this function returns Acad::eWasNotifying.

If the vertex is currently involved in an Undo operation, then the open attempt fails and this function returns Acad::eWasOpenForUndo.

If the vertex is currently open AcDb::kForWrite, then the open attempt fails and this function returns Acad::eWasOpenForWrite.

If objId is AcDbObjectId::kNull, then the open attempt will, of course, fail and this function returns Acad::eNullObjectId.

acdbOpenObject(), or acdbOpenAcDbEntity() can also be used directly on the vertex if desired.

Parameters

Use Instead

Acad::ErrorStatus acdbOpenObject(AcDbObject*& pObj, AcDbObjectId id, AcDb::OpenMode mode = AcDb::kForRead, bool openErased = false);

Links

AcDbPolygonMesh