AcDb3dPolyline::openVertex

C++

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

Description

Deprecated. This function provides access to the polyline's vertices. pVertex passes in an empty pointer to the function. 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 is erased.

The openMode argument may be one of the following:

• AcDb::kForRead
• AcDb::kForWrite
• AcDb::kForNotify

If the open attempt is successful, then pVertex will be 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 will fail and this function will return 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 will fail and this function will return Acad::eAtMaxReaders.

If the vertex is currently open AcDb::kForNotify, then the open attempt will fail and this function will return Acad::eWasNotifying.

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

If the vertex is currently open AcDb::kForWrite, then the open attempt will fail and this function will return Acad::eWasOpenForWrite.

If objId is AcDbObjectId::kNull, then the open attempt will, of course, fail and this function will return 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

AcDb3dPolyline