（33）ObjectARX2015 + vs2012扩展字典和有名对象字典

最新推荐文章于 2023-05-14 11:42:32 发布

qq_42981953

最新推荐文章于 2023-05-14 11:42:32 发布

阅读量489

点赞数

文章标签： cad c++

本文链接：https://blog.csdn.net/qq_42981953/article/details/121950127

版权

1. 说明

扩展记录与扩展数据类似，但是其数据存储量和能够存储的数据类型都要多于扩展数据。扩展记录可以保存在实体的扩展字典或有名对象字典中。

扩展字典隶属于特定的实体，每个实体只能包含一个扩展字典，它为实体保存自定义数据提供了一种途径，实际上，Autodesk 也建议开发者用扩展字典和扩展记录来代替传统的扩展数据。有名对象字典直接保存在图形数据库中，不与特定的实体有关，因此可用于保存与实体无关的设计参数。

字典与符号表类似，其中包含一个惟一的字符串关键字索引和对象 ID 号，通过关键字来访问字典中保存的内容。

本节的实例分别在实体和图形中保存与上节实例相同的数据，让读者对比扩展数据和扩展记录使用的异同，更好地理解这两种保存数据的机制。

2. 思路

(1) 访问实体的扩展字典

扩展字典与特定的实体关联，但是一个实体在默认情况下不包含扩展字典，如果要利用扩展字典保存与实体关联的数据，可以使用 createExtensionDictionary 函数为实体建立扩展字典，如果实体已经包含扩展字典，该函数的调用不会产生任何影响。

创建扩展字典之后，就可以使用 extensionDictionary 函数获得实体的扩展字典， AcDbDictionary 对象的 setAt 函数可以为字典添加一个元素，该元素既可以是 AcDbXrecord ，也可以是其他类型的对象。如果添加了 AcDbXrecord （扩展记录），就可以使用 acutBuildList函数构建一个保存数据的结果缓冲区链表，然后使用 setFromRbChain 函数将结果缓冲区链表添加到扩展及记录中，这样就使用扩展记录保存了数据。

如果要访问实体扩展字典中保存的扩展记录，可以使用 extensionDictionary 函数获得实体的扩展字典，然后通过字典的 getAt 函数得到指定的元素（扩展记录），使用 AcDbXrecord类的 rbChain 函数得到保存数据的结果缓冲区链表，并且遍历该链表获得保存的数据。

(2) 访问有名对象字典

AutoCAD 每个图形数据库中都包含一个有名对象字典，默认情况下该字典中包含了组、多线样式、布局和打印等信息。例如，用户在 AutoCAD 创建一个组，就会有一个代表改组的元素被添加到组字典中。

如果需要在有名对象字典中保存自己的数据，一般可以在有名对象字典中添加一个根字典，然后再向根字典中添加新的字典，进而在新字典中保存数据。这样的好处是不会与有名对象字典的基本字典相混淆。

使用 AcDbDatabase 对象的 getNamedObjectsDictionary 函数可以获得图形的有名对象字典（根字典），可以通过 setAt 函数向根字典添加一个字典，或者通过 getAt 函数获得其中的一个字典。获得字典之后，向字典中保存数据的方法与扩展字典完全一致。

3. 步骤

(1) 提示用户选择一个实体，并将一些附加的数据保存到该实体的扩展字典中

    // 添加到扩展字典
    static void AddXRecord(); // 提示用户选择一个实体，并将一些附加的数据保存到该实体的扩展字典中

// 添加到扩展字典
// 提示用户选择一个实体，并将一些附加的数据保存到该实体的扩展字典中
void CXData::AddXRecord()
{
    // 提示用户选择所要添加扩展记录的图形对象
    ads_name en;
    ads_point pt;

    if (acedEntSel(_T("\n选择所要添加扩展记录的实体："), en, pt) != RTNORM)
        return;

    AcDbObjectId entId; // 要添加扩展记录的实体ID 
    Acad::ErrorStatus es = acdbGetObjectId(entId, en);
    AcDbXrecord *pXrec = new AcDbXrecord;
    AcDbObject *pObj;
    AcDbObjectId dictObjId, xRecObjId;
    AcDbDictionary *pDict;
    
    // 要在扩展记录中保存的字符串
    TCHAR entType[] = {_T("直线")};
    struct resbuf* pRb;
   
    // 向实体中添加扩展字典
    acdbOpenObject(pObj, entId, AcDb::kForWrite);
    pObj->createExtensionDictionary();
    dictObjId = pObj->extensionDictionary();
    pObj->close();
    
    // 向扩展字典中添加一条记录
    acdbOpenObject(pDict, dictObjId, AcDb::kForWrite);
    pDict->setAt(_T("XRecord"), pXrec, xRecObjId);
    pDict->close();
    
    // 设置扩展记录的内容
    pRb = acutBuildList(AcDb::kDxfText, entType,
        AcDb::kDxfInt32, 12,
        AcDb::kDxfReal, 3.14,
        AcDb::kDxfXCoord, pt,
        RTNONE);
    pXrec->setFromRbChain(*pRb);
    
    pXrec->close();
    acutRelRb(pRb);
}


/*
// AcDbXrecord 类的成员函数 setFromRbChain 的定义：
Acad::ErrorStatus setFromRbChain( 
    const resbuf& pRb, 
    AcDbDatabase* auxDb = NULL);
// 因此，传递的第一个参数必须是 pRb 所指向的结果缓冲区对象，也就是*pRb。
*/

(2) 提示用户选择图形对象，如果选中的实体包含扩展字典，就查看扩展字典中“Xrecord”元素所保存的数据

    // 查看扩展字典保存的数据
    static void ViewXRecord();

// 查看扩展字典保存的数据
// 提示用户选择图形对象，如果选中的实体包含扩展字典，就查看扩展字典中“Xrecord”元素所保存的数据
void CXData::ViewXRecord()
{
    // 提示用户选择所要查看扩展记录的图形对象
    ads_name en; 
    ads_point pt; 

    if (acedEntSel(_T("\n选择所要查看扩展记录的实体："), en, pt) != RTNORM) 
        return; 

    AcDbObjectId entId; 
    Acad::ErrorStatus es = acdbGetObjectId(entId, en); 

    // 打开图形对象，获得实体扩展字典的ObjectId 
    AcDbEntity *pEnt; 
    acdbOpenAcDbEntity(pEnt, entId, AcDb::kForRead); 
    AcDbObjectId dictObjId = pEnt->extensionDictionary(); 
    pEnt->close(); 
    // 查看实体是否包含扩展字典
    if (dictObjId == AcDbObjectId::kNull) 
    { 
        acutPrintf(_T("\n所选择的实体不包含扩展字典!")); 
        return; 
    } 
    // 打开扩展字典，获得与关键字“XRecord”关联的扩展记录
    AcDbDictionary *pDict; 
    AcDbXrecord *pXrec; 
    acdbOpenObject(pDict, dictObjId, AcDb::kForRead); 
    pDict->getAt(_T("XRecord"), (AcDbObject*&)pXrec, AcDb::kForRead); 
    pDict->close(); 

    // 获得扩展记录的数据链表并关闭扩展数据对象
    struct resbuf *pRb; 
    pXrec->rbChain(&pRb); 
    pXrec->close();

    if (pRb != NULL) 
    { 
        // 在命令行显示扩展记录内容
        struct resbuf *pTemp; 
        pTemp = pRb; 

        acutPrintf(_T("\n字符串类型的扩展数据是：%s"), pTemp->resval.rstring); 

        pTemp = pTemp->rbnext; 
        acutPrintf(_T("\n整数类型的扩展数据是：%d"), pTemp->resval.rint); 

        pTemp = pTemp->rbnext; 
        acutPrintf(_T("\n实数类型的扩展数据是：%.2f"), pTemp->resval.rreal); 

        pTemp = pTemp->rbnext; 
        acutPrintf(_T("\n点坐标类型的扩展数据是：(%.2f, %.2f, %.2f)"), 
            pTemp->resval.rpoint[X], pTemp->resval.rpoint[Y],  pTemp->resval.rpoint[Z]); 

        acutRelRb(pRb); 
    }
}


/*
//AcDbXrecord 类的 rbChain 函数定义为：
Acad::ErrorStatus rbChain( 
    resbuf** ppRb,                 
    AcDbDatabase* auxDb = NULL) const; 
//第一个参数是一个指针的指针，帮助系统中已经说明要输入一个指向结果缓冲区的指针的地址    
//（Input the address of a pointer to resbuf structure），因此应该输入&pRb 作为参数值。
*/

(3) 向当前的图形数据库中添加一个字典，并在其中保存自定义数据

    //向当前的图形数据库中添加一个字典，并在其中保存自定义数据
    static void AddNameDict(); // 向当前的图形数据库中添加一个字典，并在其中保存自定义数据

//向当前的图形数据库中添加一个字典，并在其中保存自定义数据
void CXData::AddNameDict()
{
    // 要在扩展记录中保存的字符串
    TCHAR entType[] = {_T("直线")};
    struct resbuf *pRb;

    // 获得有名对象字典，向其中添加指定的字典项
    AcDbDictionary *pNameObjDict, *pDict;
    acdbHostApplicationServices()->workingDatabase()->getNamedObjectsDictionary(pNameObjDict, AcDb::kForWrite);
    
    // 检查所要添加的字典项是否已经存在
    AcDbObjectId dictObjId;
    if (pNameObjDict->getAt(_T("MyDict"), (AcDbObject*&)pDict, AcDb::kForWrite) == Acad::eKeyNotFound)
    {
        pDict = new AcDbDictionary;
        pNameObjDict->setAt(_T("MyDict"), pDict, dictObjId);
        pDict->close();
    }
    pNameObjDict->close();
    
    // 向新建的字典中添加一个扩展记录
    AcDbObjectId xrecObjId;
    AcDbXrecord *pXrec = new AcDbXrecord;
    acdbOpenObject(pDict, dictObjId, AcDb::kForWrite);
    pDict->setAt(_T("XRecord"), pXrec, xrecObjId);
    pDict->close();

    // 设置扩展记录的内容
    ads_point pt;
    pt[X] = 100;
    pt[Y] = 100;
    pt[Z] = 0;
    pRb = acutBuildList(AcDb::kDxfText, entType,
                        AcDb::kDxfInt32, 12,
                        AcDb::kDxfReal, 3.14,
                        AcDb::kDxfXCoord, pt,
                        RTNONE);
    pXrec->setFromRbChain(*pRb);
    pXrec->close();

    acutRelRb(pRb);
}

从上面的代码可以看出，在有名对象字典中保存数据与在扩展字典中保存数据相比，仅仅是获得字典的方法有所不同。

(4) 检查当前图形中是否包含指定的用户字典，并在命令窗口中显示字典中保存的自定义数据

    // 检查当前图形中是否包含指定的用户字典，并在命令窗口中显示字典中保存的自定义数据
    static void ViewNameDict(); // 检查当前图形中是否包含指定的用户字典，并在命令窗口中显示字典中保存的自定义数据

// 检查当前图形中是否包含指定的用户字典，并在命令窗口中显示字典中保存的自定义数据
void CXData::ViewNameDict()
{
    // 获得对象有名字典中指定的字典项
    AcDbDictionary *pNameObjDict, *pDict;
    Acad::ErrorStatus es;
    acdbHostApplicationServices()->workingDatabase()->getNamedObjectsDictionary(pNameObjDict, AcDb::kForRead);
    es = pNameObjDict->getAt(_T("MyDict"), (AcDbObject*&)pDict, AcDb::kForRead);
    pNameObjDict->close();
    // 如果不存在指定的字典项，退出程序
    if (es == Acad::eKeyNotFound)
        return;
    // 获得指定的对象字典
    AcDbXrecord *pXrec;
    pDict->getAt(_T("XRecord"), (AcDbObject*&)pXrec, AcDb::kForRead);
    pDict->close();

    // 获得扩展记录的数据链表并关闭扩展数据对象
    struct resbuf *pRb;
    pXrec->rbChain(&pRb);
    pXrec->close();

    if (pRb != NULL)
    {
        // 在命令行显示扩展记录内容
        struct resbuf *pTemp;
        pTemp = pRb;

        acutPrintf(_T("\n字符串类型的扩展数据是：%s"), pTemp->resval.rstring);

        pTemp = pTemp->rbnext;
        acutPrintf(_T("\n整数类型的扩展数据是：%d"), pTemp->resval.rint);

        pTemp = pTemp->rbnext;
        acutPrintf(_T("\n实数类型的扩展数据是：%.2f"), pTemp->resval.rreal); 

        pTemp = pTemp->rbnext; 
        acutPrintf(_T("\n点坐标类型的扩展数据是：(%.2f, %.2f, %.2f)"), 
            pTemp->resval.rpoint[X], pTemp->resval.rpoint[Y], pTemp->resval.rpoint[Z]); 

        acutRelRb(pRb); 
    }
}

(5) 在acrxEntryPoint.cpp中

ACED_ARXCOMMAND_ENTRY_AUTO(CArxConfigApp, MidasMyGroup, MyAddXRecord, MyAddXRecord, ACRX_CMD_MODAL, NULL) //添加扩展字典
ACED_ARXCOMMAND_ENTRY_AUTO(CArxConfigApp, MidasMyGroup, MyViewXRecord, MyViewXRecord, ACRX_CMD_MODAL, NULL) //查看扩展字典
ACED_ARXCOMMAND_ENTRY_AUTO(CArxConfigApp, MidasMyGroup, MyAddNameDict, MyAddNameDict, ACRX_CMD_MODAL, NULL) //添加自定义数据
ACED_ARXCOMMAND_ENTRY_AUTO(CArxConfigApp, MidasMyGroup, MyViewNameDict, MyViewNameDict, ACRX_CMD_MODAL, NULL) //查看自定义数据

    //当前项目中注册命令 AddXRecord(添加扩展数据)
    static void MidasMyGroupMyAddXRecord()
    {
        CXData::AddXRecord();
    }

    //当前项目中注册命令 ViewXRecord(查看扩展数据)
    static void MidasMyGroupMyViewXRecord()
    {
        CXData::ViewXRecord();
    }

    //当前项目中注册命令 AddNameDict(添加扩展数据)
    static void MidasMyGroupMyAddNameDict()
    {
        CXData::AddNameDict();
    }

    //当前项目中注册命令 ViewNameDict(查看扩展数据)
    static void MidasMyGroupMyViewNameDict()
    {
        CXData::ViewNameDict();
    }

效果展示