C++
ACDBCORE2D_PORT Acad::ErrorStatus dwgOutFields( AcDbDwgFiler* pFiler ) const;
Description
This function is called by dwgOut(). Its purpose is to allow the object to write out its data.
There is a fixed set of steps that should be followed when implementing your own version of this function:
- Call assertReadEnabled().
- Call the parent class's dwgOutFields() passing it pFiler. If this returns Acad::eOk, then continue; otherwise, immediately return whatever the parent class's dwgInFields() returned.
- Use pFiler to call the appropriate AcDbDwgFiler methods to write out the object's data items. It is essential that the same number of data items be written out, and in the same order, as those that are read in via dwgInFields().
Following these steps results in all base classes having their implementations of this function called as well, thus writing out all the object's data in class hierarchical order.
The actual AcDbObject::dwgOutFields() implementation takes care of writing out the object's handle as well as its persistent reactor, extension dictionary, and xdata information.
This function should return Acad::eOk if successful. In your own custom class implementations of this function, it's easiest to just return pFiler->filerStatus().
Parameters
Parameters | Description |
---|---|
pFiler | Passed in pointer to filer to use to write out the object's data |