AcDb2dPolyline::openSequenceEnd

C++

Acad::ErrorStatus openSequenceEnd(
    AcDbSequenceEnd*&, 
    AcDb::OpenMode
);

Description

This function provides access to the AcDbSequenceEnd entity for the polyline for the purpose of getting or setting xdata. An attempt is made to open the polyline's Seqend in the mode specified by openMode.

The openMode argument may be one of the following:

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

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

If attempting to open AcDb::kForRead and the Seqend 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 Seqend is currently open AcDb::kForNotify, then the open attempt will fail and this function will return Acad::eWasNotifying.

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

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

This functionality is provided only for compatibility with existing AutoLISP applications that use AcDbSequenceEnd objects for xdata storage.

Storing xdata on AcDbSequenceEnd objects is not recommended. Instead, the xdata can be attached to the AcDb3dPolyline object or any of the vertices, or extension dictionaries may be used.

Parameters

Links

AcDb2dPolyline