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 AcDbBlockReference * pMatchThisBlockReference = NULL
);
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.  
pMatchThisBlockReference 
Input optional pointer to an existing annotation reference, whose static-property and expression-string overrides are used to create the new annotation reference.  
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. If the caller provides an optional pointer to an existing annotation reference, that reference's static-property and expression-string overrides are used to create the new annotation reference.

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].