AcDbPolyFaceMesh::openSequenceEnd

C++

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

Description

This function provides access to the AcDbSequenceEnd entity for the PolyFaceMesh for the purpose of getting or setting xdata. An attempt is made to open the PolyFaceMesh'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 is 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 AcDbPolyFaceMesh object or any of the vertices, or extension dictionaries may be used.

Parameters

Links

AcDbPolyFaceMesh