AcDbPolyFaceMesh::openVertex

C++

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

Description

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

The openMode argument may be one of the following:

AcDb::kForRead

AcDb::kForWrite

AcDb::kForNotify

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

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

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

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

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

If the vertex or FaceRecord 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 fails and this function returns Acad::eNullObjectId.

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

Parameters

Use Instead

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

Links

AcDbPolyFaceMesh