首页 > 代码库 > CAD控件使用教程 自定义实体的实现
CAD控件使用教程 自定义实体的实现
自定义实体的实现
1 、 自定义实体... 3
1.1 说明... 3
1.2 类的类型信息... 3
1.3 worldDraw.. 4
1.4 getGripPoints 4
1.5 moveGripPointsAt 5
1.6 getGeomExtents 6
1.7 getOsnapPoints 6
1.8 explode. 7
1.9 dwgInFields 8
1.10 dwgOutFields 9
1.11 控件例程说明... 9
1 、 自定义实体
1.1 说明
控件支持自定义实体功能，可以从McDbEntity继承自己的实体，在自定体实体类中，实现相关虚函数来实现实体的自定义功能。
1.2 类的类型信息
使用MCRX_DECLARE_MEMBERS宏定义类的类型信息函数，宏的第一个参数是类的类名。使用例如：
MCRX_DECLARE_MEMBERS(CLinkLine);
使用 ACRX_DXF_DEFINE_MEMBERS宏实现类的类型信息函数。宏定义参数使用如下：
ACRX_DXF_DEFINE_MEMBERS(CLinkLine, McDbEntity,
AcDb::kDHL_CURRENT,AcDb::kMReleaseCurrent,
AcDbProxyEntity::kAllAllowedBits,_T("LinkLine"),
_T("MxDrawObjTest Custom Entity") );
CLinkLine 自定义实体的类名
McDbEnity 自定义实体的基类
AcDb::kDHL_CURRENT 当前文件版本
AcDb::kMReleaseCurrent 当前控件版本
AcDbProxyEntity::kAllAllowedBits代理实体处理标志
_T("LinkLine") Dfx0组码对应值
_T("MxDrawObjTest Custom Entity") 类说明
在程序启动的时候，调用rxInit函数，自定义实体的类型信息注册到系统中，使用例如：
BOOL CCustomEntityApp::InitInstance()
{
…..
// 注册自定义实体类信息。
CLinkBlock::rxInit();
CLinkLine::rxInit();
1.3 worldDraw
重载该虚函数，绘制自定义实体的显示效果
VC接口：
Adesk::Boolean worldDraw (AcGiWorldDraw * wd);;
参数：
Wd 显示绘制的上下文对象
参考例程：
Adesk::Boolean CLinkLine::worldDraw (AcGiWorldDraw * wd)
{
assertReadEnabled();
wd->geometry().line(m_start,m_end);
std::auto_ptr<AcDbText>spText(GetDimText() );
spText->worldDraw(wd);
returnAdesk::kTrue;
}
1.4 getGripPoints
重载该虚函数，返回自定义的编辑夹点
VC接口：
virtualAcad::ErrorStatus getGripPoints(
AcGePoint3dArray& gripPoints,
AcGeIntArray& osnapModes,
AcGeIntArray& geomIds) const;
参数：
gripPoints 返回夹点
osnapModes 暂没有使用
geomIds 暂没有使用
参考例程：
Acad::ErrorStatus CLinkLine::getGripPoints(
AcGePoint3dArray& gripPoints,
AcGeIntArray& osnapModes,
AcGeIntArray& geomIds) const
{
assertReadEnabled();
gripPoints.append(m_start); // 返回开始点夹点
gripPoints.append(m_end); // 返回结束点夹点
gripPoints.append(m_start+ (m_end - m_start) / 2.0); // 返回中点夹点。
returnAcad::eOk;
}
1.5 moveGripPointsAt
重载该虚函数，处理夹点编辑结果。
VC接口：
virtualAcad::ErrorStatusmoveGripPointsAt(
constAcGeIntArray& indices,
constAcGeVector3d& offset);
参数：
indices indices [0]参数是传入被编辑的夹点索引,其它数组元素暂没有使用。
offset 夹点编辑的偏移量
参考例程：
Acad::ErrorStatusCLinkLine::moveGripPointsAt(const AcGeIntArray& indices,
const AcGeVector3d& offset)
{
assertWriteEnabled();
int iIndex =indices[0];
switch(iIndex)
{
case 0:
m_start= m_start + offset; // 开始点被编辑
break;
case 1:
m_end= m_end + offset; // 结束点被编辑
break;
case 2:
m_start= m_start + offset; // 中点被编辑
m_end= m_end + offset; // 中点被编辑
break;
}
returnMcad::eOk;
}
1.6 getGeomExtents
重载该虚函数，返回自定义实体的外包矩形框
VC接口：
virtualAcad::ErrorStatus getGeomExtents(
AcDbExtents& extents) const;
参数：
extents 返回自定义实体外包矩形框。
参考例程：
Acad::ErrorStatus CLinkLine::getGeomExtents(AcDbExtents& extents) const
{
assertReadEnabled();
extents.set(m_start,m_end);
returnMcad::eOk;
}
1.7 getOsnapPoints
重载该虚函数，返回自定义实体的捕捉点
VC接口：
virtualAcad::ErrorStatus getOsnapPoints(
AcDb::OsnapMode osnapMode,
int gsSelectionMark,
constAcGePoint3d& pickPoint,
constAcGePoint3d& lastPoint,
const AcGeMatrix3d& viewXform,
AcGePoint3dArray& snapPoints,
AcDbIntArray& geomIds) const;
参数：
osnapMode 捕捉点类型，通过该变量可以确定需要返回什么类型的捕捉点
gsSelectionMark 暂没有使用
pickPoint 当前输入点
lastPoint 上一次的输入点
viewXform 暂没有使用
snapPoints 返回捕捉点
geomIds 暂没有使用
参考例程：
Acad::ErrorStatus CLinkLine::getOsnapPoints(
AcDb::OsnapMode osnapMode,
int gsSelectionMark,
constAcGePoint3d& pickPoint,
constAcGePoint3d& lastPoint,
constAcGeMatrix3d& viewXform,
AcGePoint3dArray& snapPoints,
AcDbIntArray& geomIds) const
{
assertReadEnabled();
if(osnapMode== McDb::kOsModeEnd)
{
// 返端点。
snapPoints.append(m_start);
snapPoints.append(m_end);
}
elseif(osnapMode == McDb::kOsModeMid)
{
// 返回的是中点。
snapPoints.append(m_start+ (m_end - m_start) / 2.0);
}
returnMcad::eOk;
}
1.8 explode
重载该虚函数，返回自定义实体打碎后的实体，在控件中，自定义实体保存在到dwg图中时，使用是块引用来保存，控件使用该函数得到自定义实体在块引用中的实体数据。
VC接口：
virtualAcad::ErrorStatus explode(
AcDbVoidPtrArray& entitySet) const;
参数：
entitySet 返回打碎后的基本实体。实体指针内存控件释放。
参考例程：
Acad::ErrorStatus CLinkLine::explode(AcDbVoidPtrArray& entitySet) const
{
assertReadEnabled();
AcDbLine*pLine = new AcDbLine(m_start,m_end);
entitySet.append(pLine);
entitySet.append(GetDimText());
returnAcad::eOk;
}
1.9 dwgInFields
重载该虚函数，响应控件系统，读取自定义实体数据，在从文件读取实体，复制实体等地方都会调用该函数。
VC接口：
virtualAcad::ErrorStatusdwgInFields(AcDbDwgFiler* pFiler);
参数：
pFiler 数据归档对象,在这个函数，使用该对象读取数据。
参考例程：
Acad::ErrorStatus CLinkLine::dwgInFields(AcDbDwgFiler* pFiler)
{
assertWriteEnabled();
if(pFiler->filerType()!= McDb::kCustomEntityFileFiler)
{
Mcad::ErrorStatuses;
if((es = McDbEntity::dwgInFields(pFiler)) != Mcad::eOk)
{
returnes;
}
}
int lVar =1;
pFiler->readInt(&lVar);
pFiler->readPoint3d(&m_start);
pFiler->readPoint3d(&m_end);
returnMcad::eOk;
}
1.10 dwgOutFields
重载该虚函数，响应控件系统，写入自定义实体数据，在把实体写入文件时，复制实体等地方都会调用该函数。
VC接口：
virtualAcad::ErrorStatusdwgOutFields(AcDbDwgFiler* pFiler) const;
参数：
pFiler 数据归档对象,在这个函数，使用该对象写入数据。
参考例程：
Acad::ErrorStatusCLinkLine::dwgOutFields(AcDbDwgFiler* pFiler) const
{
assertReadEnabled();
if(pFiler->filerType()!= McDb::kCustomEntityFileFiler)
{
Mcad::ErrorStatuses;
if((es = McDbEntity::dwgOutFields(pFiler)) != Mcad::eOk)
{
returnes;
}
}
pFiler->writeInt(LINKLINE_VERSION);
pFiler->writePoint3d(m_start);
pFiler->writePoint3d(m_end);
returnMcad::eOk;
}
1.11 控件例程说明
在控件安装目录下的samples\CustomEntityCustomEntity.sln例程，演示了自定义实体现。在例程实现连接块CLinkBlock自定义实体，CLinkLine自定义实体，
CLinkBlock类显示通过块引用显示，绘图捕捉点通过块记录中的块属性定义文本来确定，当该实体被编辑后，会自动移动与该实体连接的连接线，实现个连动效果。
CLinkLine 类实现一个线段实体功能，并带有长度标注功能。
CAD控件使用教程 自定义实体的实现