AcMapAnnotationManager::InsertAnnotationReference Function

Land Desktop Development ARX CPP SDK

AcMapAnnotationManager:: InsertAnnotationReference Function
 

Attaches an annotation reference to an associated entity.

Acad::ErrorStatus InsertAnnotationReference(
    AcDbObjectId& newBlockReferenceId, 
    const ACHAR * pszTemplateName, 
    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.  
pszTemplateName 
Input name of the annotation template 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 named annotation template 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].