C++
Acad::ErrorStatus acedConvertEntityToHatch( AcDbHatch* pHatch, AcDbEntity*& pEnt, bool transferId );
File
aced.h
Description
Converts a block reference or a solid to a hatch.
If transferId is true, the calling AcDbHatch assumes the AcDbObjectId, handle, any extended entity data, extension dictionaries, or reactors, as well as any hatch associativity of pEnt. This is the only way the associativity with the boundary objects can be transferred. pEnt will then be deleted and set to NULL.
If transferId is false, pEnt remains in the database as is and the caller is responsible for closing it. The resulting AcDbHatch is not database-resident and, as such, cannot assume any of the associativity with pEnt boundary objects. The caller can later call pEnt->handOverTo() to exchange the new AcDbHatch for pEnt in the database, but the associativity cannot be re-established.
Parameters
| Parameters | Description |
|---|---|
| pHatch | Pointer to an AcDbHatch, which must be newly created and open for write |
| pEnt | Input AcDbBlockReference or AcDbSolid |
| transferId | Input Boolean indicating whether the AcDbHatch will assume the AcDbObjectId, handle, extended entity data, extension dictionaries, reactors, and hatch associativity of pEnt |