acdbBindXrefs

C++

Acad::ErrorStatus acdbBindXrefs(
    AcDbDatabase* pHostDb, 
    const AcDbObjectIdArray& xrefBlkIds, 
    const bool bInsertBind, 
    const bool bAllowUnresolved = false, 
    const bool bQuiet = true
);

File

acdbxref.h

Description

This function binds the xrefs whose AcDbBlockTableRecord object IDs are in xrefBlkIds. If bInsertBind is true, then the symbolTable record names will be changed from the xref naming convention to normal insert block names.

The object IDs in xrefBlkIds must all be from pHostDb and they must all be resolved unless bAllowUnresolved is true. If bAllowUnresolved is true, then unresolved xrefs involved in the bind operation will have their BlockTableRecord set to a normal BlockTableRecord and a text entity containing the path/filename of the xref will be added to the BlockTableRecord.

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().

Returns Acad::eOk if the operation is successful.

Parameters