[mxcad_2d API documentation] (../README. md)/[2d] (../modules/2d. md)/McDbBlockTable

Class: McDbBlockTable ​

2d.McDbBlockTable

The block table class in the database stores block table records.

Example

//Traverse all blocks in the drawing
import { MxCpp, McDbBlockTable } from "mxcad"

//Retrieve the current CAD object
let mxcad = MxCpp.App.getCurrentMxCAD();
//Get block table object
let blockTable: McDbBlockTable = mxcad.getDatabase().getBlockTable();
//Retrieve all record object IDs from the block table
let aryId = blockTable.getAllRecordId();
//Traverse the record object ID to obtain the details of the block table record object
aryId.forEach((id) => {
let blkRec = id.getMcDbBlockTableRecord();
if (blkRec === null) return;
    console.log(blkRec);
    console.log("blkRec.name:" + blkRec.name);
    console.log("blkRec.origin:" + blkRec.origin);
});

Hierarchy ​

• McDbObject

  ↳ McDbBlockTable

Table of contents ​

Constructors ​

• constructor

Properties ​

• imp

Accessors ​

• dxf0
• objectName

Methods ​

• add
• assertObjectModification
• clone
• createExtensionDictionary
• erase
• get
• getAllRecordId
• getDatabase
• getDatabaseIndexId
• getExtensionDictionary
• getGripPoints
• getHandle
• getImp
• getJson
• getObjectID
• getOwnerID
• has
• initTempObject
• isErased
• isHaveExtensionDictionary
• isKindOf
• isNull
• moveGripPointsAt
• setJson
• unErase

Constructors ​

constructor ​

• new McDbBlockTable(imp?)

Constructor.

Parameters ​

Overrides ​

McDbObject.constructor

Properties ​

imp ​

• imp: any = 0

Internal implementation object.

Inherited from ​

McDbObject.imp

Accessors ​

dxf0 ​

• get dxf0(): string

Obtain the type name of the object's DXF group code, which is the same as the DXF group code in AutoCAD. For example, the type name of the line is McDbLine, and the group code value for DXF0 is: LINE and DXF0 group code values can be used for type filtering when constructing sets.

Returns ​

string

Inherited from ​

McDbObject.dxf0

objectName ​

• get objectName(): string

Get the object name.

Example

import { McRxObject } from 'mxcad';

let obj = new McRxObject();
console.log(obj.objectName);

Returns ​

string

Return object name

Inherited from ​

McDbObject.objectName

Methods ​

add ​

▸ add(rec): McObjectId

Add block records to the block table.

Example

import { MxCpp, McDbBlockTable } from "mxcad"

let mxcad = MxCpp.App.getCurrentMxCAD();
let blockTable: McDbBlockTable = mxcad.getDatabase().getBlockTable(); 
const blkRec = new McDbBlockTableRecord();
const objId = blockTable.add(blkRec);

Parameters ​

Returns ​

McObjectId

Add block record object ID.

assertObjectModification ​

▸ assertObjectModification(autoUndo?): number

Setting the state of the object to be changed can automatically trigger the update display function to update the display. For example, if the block table record is updated and the block reference needs to be notified to update the display, this function can be called.

Example

//Assuming obj is a database object
obj.assertObjectModification()

Parameters ​

Returns ​

number

Inherited from ​

McDbObject.assertObjectModification

clone ​

▸ clone(): null | McDbObject

Clone objects.

Example

//Assuming obj is a database object
const obj_clone = obj.clone();

Returns ​

null | McDbObject

The cloned object.

Inherited from ​

McDbObject.clone

createExtensionDictionary ​

▸ createExtensionDictionary(): boolean

Create extended dictionary data for objects

Example

//Assuming obj is a database object
const res = obj.createExtensionDictionary();

Returns ​

boolean

Inherited from ​

McDbObject.createExtensionDictionary

erase ​

▸ erase(): boolean

Delete object.

Example

//Assuming obj is a database object
const res = obj.erase();
console.log(res);

Returns ​

boolean

Whether the deletion was successful.

Inherited from ​

McDbObject.erase

get ​

▸ get(sName, skipDeleted?): McObjectId

Search for block records in the block table.

Example

import { MxCpp, McDbBlockTable } from "mxcad"

let mxcad = MxCpp.App.getCurrentMxCAD();
let blockTable: McDbBlockTable = mxcad.getDatabase().getBlockTable(); 
const blkRec = new McDbBlockTableRecord();
BlkRec.name="Test Block";
blockTable.add(blkRec);
Const objId=blockTable.get ("test block");

Parameters ​

Returns ​

McObjectId

Block record object ID.

getAllRecordId ​

▸ getAllRecordId(skipDeleted?): McObjectId[]

Retrieve the IDs of all block records in the block table.

Example

import { MxCpp, McDbBlockTable } from "mxcad"

let mxcad = MxCpp.App.getCurrentMxCAD();
let blockTable: McDbBlockTable = mxcad.getDatabase().getBlockTable(); 
const aryId = blockTable.getAllRecordId();
console.log(aryId)

Parameters ​

Returns ​

McObjectId[]

Ret block record ID array.

getDatabase ​

▸ getDatabase(): McDbDatabase

Get the database where the object is located

Example

//Assuming obj is a database object
const data = obj.getDatabase();

Returns ​

McDbDatabase

Return to database

Inherited from ​

McDbObject.getDatabase

getDatabaseIndexId ​

▸ getDatabaseIndexId(): number

Get the index ID of the object

Example

//Assuming obj is a database object
const id = obj.getDatabaseIndexId();

Returns ​

number

Inherited from ​

McDbObject.getDatabaseIndexId

getExtensionDictionary ​

▸ getExtensionDictionary(): McDbDictionary

Obtain the extended dictionary data of the object

Example

//Assuming obj is a database object
const id = obj.getOwnerID();

Returns ​

McDbDictionary

Expand dictionary data

Inherited from ​

McDbObject.getExtensionDictionary

getGripPoints ​

▸ getGripPoints(): McGePoint3dArray

Get the control points of the object

Example

//Assuming obj is a database object
const ptArr = obj.getGripPoints();

Returns ​

McGePoint3dArray

Inherited from ​

McDbObject.getGripPoints

getHandle ​

▸ getHandle(): string

Obtain object handle

Example

//Assuming obj is a database object
const handle = obj.getHandle();

Returns ​

string

Return object handle

Inherited from ​

McDbObject.getHandle

getImp ​

▸ getImp(): any

Retrieve internal implementation objects.

Example

import { McRxObject } from 'mxcad';

let obj = new McRxObject();
let imp = obj.getImp();

Returns ​

any

Internal implementation object.

Inherited from ​

McDbObject.getImp

getJson ​

▸ getJson(): string

Retrieve a string in JSON format.

Example

import { McRxObject } from 'mxcad';

let obj = new McRxObject();
const json = obj.getJson()

Returns ​

string

A string in JSON format.

Inherited from ​

McDbObject.getJson

getObjectID ​

▸ getObjectID(): McObjectId

Get the object ID.

Example

import { McDbObject } from "mxcad";
const id = obj.getObjectID();

Returns ​

McObjectId

Object ID.

Inherited from ​

McDbObject.getObjectID

getOwnerID ​

▸ getOwnerID(): number

Obtain the ID of the object owner

Example

//Assuming obj is a database object
const id = obj.getOwnerID();

Returns ​

number

Inherited from ​

McDbObject.getOwnerID

has ​

▸ has(sName): boolean

Check if there is a block record with the specified name in the block table.

Example

import { MxCpp, McDbBlockTable } from "mxcad"

let mxcad = MxCpp.App.getCurrentMxCAD();
let blockTable: McDbBlockTable = mxcad.getDatabase().getBlockTable(); 
const blkRec = new McDbBlockTableRecord();
BlkRec.name="Test Block";
blockTable.add(blkRec);
Const res=blockTable.Has ("test block");
console.log(res)

Parameters ​

Returns ​

boolean

Boolean value.

initTempObject ​

▸ initTempObject(imp): void

Initialize temporary objects.

Example

import { McRxObject } from 'mxcad';

let obj = new McRxObject();
obj.initTempObject()

Parameters ​

Returns ​

void

Inherited from ​

McDbObject.initTempObject

isErased ​

▸ isErased(): boolean

Has the object been deleted

Example

//Assuming obj is a database object
const res = obj.isErased();
console.log(res);

Returns ​

boolean

Inherited from ​

McDbObject.isErased

isHaveExtensionDictionary ​

▸ isHaveExtensionDictionary(): boolean

Is there any extended dictionary data available

Example

//Assuming obj is a database object
const res = obj.isHaveExtensionDictionary();

Returns ​

boolean

Inherited from ​

McDbObject.isHaveExtensionDictionary

isKindOf ​

▸ isKindOf(sObjectName): boolean

Determine object type

Example

import { McRxObject } from 'mxcad';

let obj = new McRxObject();
let isKind = obj.isKindOf('SomeObjectType');
console.log(isKind); //  Output: True or false

Parameters ​

Returns ​

boolean

Return whether the object is of the target type

Inherited from ​

McDbObject.isKindOf

isNull ​

▸ isNull(): any

Determine if it is an empty object

Example

import { McRxObject } from 'mxcad';

let obj = new McRxObject();
console.log(obj.isNull()); //  Output: True or false

Returns ​

any

Inherited from ​

McDbObject.isNull

moveGripPointsAt ​

▸ moveGripPointsAt(iIndex, dXOffset, dYOffset, dZOffset): any

Control points for moving objects

Example

//Assuming obj is a database object
obj.moveGripPointsAt(1,10,10,10);

Parameters ​

Returns ​

any

Inherited from ​

McDbObject.moveGripPointsAt

setJson ​

▸ setJson(str): boolean

Set a string in JSON format.

Example

import { McRxObject } from 'mxcad';

let obj = new McRxObject();
const res = obj.setJson('{"key": "value"}');
console.log(res)

Parameters ​

Returns ​

boolean

Is the setting successful.

Inherited from ​

McDbObject.setJson

unErase ​

▸ unErase(): boolean

Anti delete object.

Example

//Assuming obj is a database object
const res = obj.unErase();
console.log(res);

Returns ​

boolean

Inherited from ​

McDbObject.unErase