acdbXBindXrefs

C++

Acad::ErrorStatus acdbXBindXrefs(
    AcDbDatabase* pHostDb, 
    const AcDbObjectIdArray xrefSymbolIds, 
    const bool bInsertBind, 
    const bool bQuiet = true
);

File

acdbxref.h

Description

This function binds the xref symbolTable records whose ObjectIds are in xrefSymbolIds. If bInsertBind is true, then the symbolTable record names will be changed from the xref naming convention to normal insert symbolTable record names.

The ObjectIds in xrefSymbolIds must all be from pHostDb and they must all be from resolved xrefs. If pHostDb is NULL, then the database specified by AcDbHostApplicationServices::workingDatabase() will be assumed to be the host database. If bQuiet is false, then status and error messages will be sent to AcDbHostApplicationServices::DisplayString().

xrefSymbolIds may contain ObjectIds for the following symbol table record types: AcDbBlockTableRecord, AcDbLayerTableRecord, AcDbLinetypeTableRecord, AcDbTextStyleTableRecord (if it does not represent a shape file), AcDbRegAppTableRecord, and AcDbDimStyleTableRecord.

This function returns Acad::eOk if successful, Acad::eInvalidInput if xrefSymbolIds is empty, or Acad::eWrongObjectType if any of the ObjectIds in xrefSymbolIds refer to objects of an inappropriate type.

Parameters