在本教程的准备文件中已备好所需头文件及源文件，如下所示：

教程  MyCFilter.h

教程  MyCFilter.cpp

在本教程中，我们使用CAD控件\MxDraw52\Src\MxDraw5.2\samples\Edit项目进行添加自定义实体演示。

运行VS，打开“Edit”项目，添加MyCFilter类(本教程使用已准备好的文件)。在TestCommands.cpp头文件中包含“MyCFilter.h”，并在CTestCommands类的RegisterCommand函数下调用MyFilterByMrxDbgSelSet类的RegisterCommand函数。

在上述操作中，我们将类及其命令注册进了CAD控件系统，而后我们将调用命令来实现过滤。

在本实例中，我们将使用构造选择集(Mx::mcedSSGet函数)进行过滤,该函数与用户交互或直接构建选择集，函数调用了空间搜索算法，执行效率高，多用于图面搜索程序，且支持如下过滤条件。

接下来将解释构造集函数及创建过滤表函数。

mcedSSGet function

作用：与用户交互，选择实体。

接口：ARXDLL int mcedSSGet (

          LPCTSTR pszStr, 

          const void * pt1,

          const void * pt2, 

          const struct resbuf * filter,

          mds_name & ss, 

          MxSSGetSubEntity * pSubEntitys = NULL

      );

参数：

比如只想选择文字实体，代码如下：

struct resbuf* filter = acutBuildList(RTDXF0, _T("TEXT"), 0);

过滤实体图层组码是8，比如只想选择MYLayer图层上的实体，代码如下：

Struct resbuf* filter = acutBuildList(8, _T("MYLayer"), 0);

图块名的组码是2，比如只想选择图块名为CL的图块，代码如下：

struct resbuf* filter = acutBuildList(2, _T("CL"), 0);

过滤条件还支持通配符比较和OR（逻辑或），AND(逻辑与)运算，支持把扩展数据应用程序名当着过滤条件。

返回值：成功返回RTNORM，用户取消返回RTCAN。

参考例程：

BOOL MxTools::FindEntAtPoint(IN AcGePoint3d pt, IN struct resbuf* pFilter,
IN double dTol, OUT AcDbObjectIdArray& aryId)
{
aryId.setLogicalLength(0);
AcGePoint3d pt1 = pt + dTol * (AcGeVector3d::kXAxis + AcGeVector3d::kYAxis);
AcGePoint3d pt2 = pt - dTol * (AcGeVector3d::kXAxis + AcGeVector3d::kYAxis);
 
ads_name        ss;
int result = acedSSGet(_T("_C"), asDblArray(pt1), asDblArray(pt2), pFilter, ss);
if (result != RTNORM)
{
return FALSE;
}
 
long sslen;
if (acedSSLength(ss, &sslen) != RTNORM)
{
acedSSFree(ss);
return FALSE;
}
 
for (int i = 0; i < sslen; i++)
{
ads_name ent;
acedSSName(ss, i, ent);
 
AcDbObjectId id;
acdbGetObjectId(id, ent);
aryId.append(id);
}
acedSSFree(ss);
 
return !aryId.isEmpty();
}

mcutBuildList function

作用：创建一个链表数据，该函数是变参数的，可以一下传入多个链表数据，返回的链表数据在不使用时调用mcutRelRb释放内存。

接口：ARXDLL struct resbuf * mcutBuildList (int rtype, ...);

参数：

参考例程：

void MyFilterBymcedSSGet::FilterByBit()
{
ads_name ss;
 
//按位 “或”
auto pFilter = Mx::mcutBuildList(
-4, L"<OR",
RTDXF0, L"CIRCLE",
8, L"TestColor1",
-4, L"OR>",
0);
Mx::mcedSSGet(L"_X", nullptr, nullptr, pFilter, ss);
PrintVecEntName(ss);
 
//按位 “与”
pFilter = Mx::mcutBuildList(
-4, L"<AND",
RTDXF0, L"CIRCLE",
8, L"SSCP",
-4, L"AND>",
0);
Mx::mcedSSGet(L"_X", nullptr, nullptr, pFilter, ss);
PrintVecEntName(ss);
 
Mx::mcutRelRb(pFilter);
}

注意：在上述的滤过演示中，我们根据“基本类型”、“图层”、“图块”及“按位OR”和“按位AND”， 在过滤时，我们需要在参数中填入类型，而在后跟类型名，如只选择文字时，我们需要在第一个参数填入“RTDXF0”，而在下一个参数填入类型，这里的类型如都是输入“RTDXF0”类型下的基本类型，则可以使用逗号隔开进行填入，而在连接符号中，我们需要使用成对的符号进行填写。

如选择“基本类型”中的“TEXT”且在“TestColor1”层时，我们需要写成：

Mx::mcutBuildList(
 -4, _T("<AND"), RTDXF0,  _T("TEXT"),
 8, _T("TestColor1"), -4, _T("AND>"),
0));