AcDbPolygonMesh::openSequenceEnd

C++

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

Description

This function provides access to the AcDbSequenceEnd entity for the PolygonMesh for the purpose of getting or setting xdata. An attempt is made to open the PolygonMesh'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 fails and this function returns Acad::eAtMaxReaders.

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

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

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

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

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

Parameters

Links

AcDbPolygonMesh