AcMapAnnotationManager:: InsertAnnotationReference Function
Attaches an annotation reference to an associated entity.
Acad::ErrorStatus InsertAnnotationReference(
AcDbObjectId& newBlockReferenceId,
AcDbObjectId templateOrBlockId,
const AcDbObjectId assocEnt,
const AnnotationOverrides & overrides
);
File
AcMapAnnotationManager.h
|
Parameters |
Description |
|
newBlockReferenceId |
Input/Output object ID of the newly created annotation reference. If newBlockReferenceId is AcDbObjectId::kNull, then a new annotation reference is created. If not, then the AcDbBlockReference whose Object ID is newBlockReferenceID is reused. |
|
templateOrBlockId |
Input object ID of an annotation template's block table record or a regular AutoCAD block table record to attach. |
|
assocEnt |
Input object ID of the entity to which the reference will be attached. |
|
overrides |
Input AnnotationOverridesstruct containing the static-property and expression-string overrides to be used when creating the new annotation reference. In the AnnotationOverrides structure, pass a NULL for each individual property that you do not want to override; instead, these property values will be computed from the template's corresponding expression or static property. |
Returns
Returns Acad::eOk if successful; otherwise, returns an error code.
Remarks
This function takes a template or block table record ID and an associated entity object ID. The new block reference object ID is an output parameter. The static-property and expression-string overrides of the input structure are used to create the new annotation reference (unless a NULL prevents an override).
Created with a commercial version of Doc-O-Matic. In order to make this message disappear you need to register this software. If you have problems registering this software please contact us at [email protected].