研究AcDbGripData类_文抄公_新浪博客

来自 : 新浪博客 发布时间：2021-03-25

http://hi.baidu.com/lihao102/blog/item/247f0d126490cb5bf819b8fb.html

目的：
实现夹点操作过程中，一系列要控制的功能（比如：各个夹点的提示语、夹点样子、对应的动态标注等）。
我们都知道，CAD的自定义实体中支撑用户自定义夹点的接口（getGripPoints和moveGripPointsAt）。而CAD支持的夹点对象就是AcDbGripData类。所以，如果需要依靠夹点操作这一套机制来实现我们要的一些功能，就需要研究研究这个类，否则就要自己写了（这样，复杂，并且有些效果并不一定能实现）。庆幸的是，ARX为AcDbGripData内置了一系列的回调函数（其实就是钩子函数来获取二次开发者对其的一些行为的定义），下面，我们就来慢慢的剖析这个类。
在这其中，我们只需要知道以下私有成员变量的用途即可：
private:
AcGePoint3dm_gripPt;
//用来保存夹点位置

AcGePoint3d*m_pAltBasePt;
//用来设置夹点编辑操作时，拖动的基点

void*m_pAppData;
//非常有用，用来保存用户自定义数据的地址

GripOperationPtrm_pHotGripFunc;
//夹点被拉伸时的回调函数，在这里，返回不同的值，将导致夹点进行不同的操作，比如返回eGetNewGripPoints将导致重新调用实体的getGripPoints
typedef AcDbGripOperations::ReturnValue(*GripOperationPtr)(AcDbGripData* pThis,
constAcDbObjectId entId, int contextFlags);

GripOperationPtrm_pHoverFunc;
//鼠标放在夹点上时的回调函数，这里，返回不同的值，将导致夹点进行不同的操作，比如返回eRedrawGrip将导致重新调用夹点的WORLDDRAW和VIEWPORTDRAW回调函数
typedef AcDbGripOperations::ReturnValue(*GripOperationPtr)(AcDbGripData* pThis,
constAcDbObjectId entId, int contextFlags);

GripRtClkHandlerm_pRtClk;
//当选中一个夹点，点击右键时，触发，在这里，你可以给定一个MENU的句柄，使其在不同的夹点上右击，弹出不同的菜单
typedef AcDbGripOperations::ReturnValue(*GripRtClkHandler)(AcDbGripDataArray hotGrips,
constAcDbObjectIdArray ents, ACHAR * menuName, HMENU menu,
ContextMenuItemIndexPtr cb);

GripWorldDrawPtrm_pWorldDraw;
//夹点WorldDraw回调函数，像十字型、三角型等不同类型的夹点形状，可以在这里定义（默认的为方型）
typedef bool (*GripWorldDrawPtr)(AcDbGripData* pThis,AcGiWorldDraw* pWd,
constAcDbObjectId entId, AcDbGripOperations::DrawTypetype,
AcGePoint3d*imageGripPoint, double dGripSize);

GripViewportDrawPtr m_pViewportDraw;
//夹点ViewportDraw回调函数
typedef void (*GripViewportDrawPtr)(AcDbGripData* pThis,AcGiViewportDraw* pWd,
constAcDbObjectId entId, AcDbGripOperations::DrawTypetype,
AcGePoint3d*imageGripPoint, int gripSize);

GripOpStatusPtrm_pGripOpStatFunc;
//夹点操作时的回调函数，判断当前是对夹点进行什么操作，返回操作状态
typedef void (*GripOpStatusPtr)(AcDbGripData* pThis, constAcDbObjectId entId,
AcDbGripOperations::GripStatus stat);

GripToolTipPtrm_pToolTipFunc;
//夹点提示回调函数，像那什么按CTRL切换的，就是在这里设置的提示语
typedef const ACHAR * (*GripToolTipPtr)(AcDbGripData* pThis);

GripDimensionPtrm_pHoverDimensionFunc;
//鼠标放在夹点的标注回调函数，在这里也可以定义标注，但一般与被拉伸时定义成一样的
typedef void (*GripDimensionPtr)(AcDbGripData* pThis, constAcDbObjectId entId,
doubledimScale, AcDbDimDataPtrArray dimData);

GripDimensionPtrm_pHotGripDimensionFunc;
//夹点被拉伸的标注回调函数，一般的动态标注在这里定义。
typedef void (*GripDimensionPtr)(AcDbGripData* pThis, constAcDbObjectId entId,
doubledimScale, AcDbDimDataPtrArray dimData);

unsignedintm_bitFlags;
//用来设置夹点的一些动作特征标志
//像，可以设置夹点被拉伸时，是否出现橡皮条、是否有关键字提示等

GripInputPointPtrm_pInputPointFunc;
//在夹点编辑状态输入一个三维点时触发，从而可以做到控件用户的操作，其中的这些参数有点类似于CAD的用户输入点过滤或监视类的参数
typedef AcDbGripOperations::ReturnValue (*GripInputPointPtr)(
AcDbGripData* pThis, const AcDbObjectId entId,bool changedPoint,
AcGePoint3d newPoint, constAcGiViewport viewContext,
constAcDbObjectId viewportId, bool pointComputed, inthistory,
constAcGePoint3d lastPoint, constAcGePoint3d rawPoint,
constAcGePoint3d grippedPoint, constAcGePoint3d cartesianSnappedPoint,
constAcGePoint3d osnappedPoint, AcDb::OsnapMaskosnapMask,
constAcArray AcDbCustomOsnapMode* customOsnapModes,
AcDb::OsnapMask osnapOverrides,
constAcArray AcDbCustomOsnapMode* customOsnapOverrides,
constAcArray AcDbObjectId pickedEntities,
constAcArray AcDbObjectIdArray,
AcArrayObjectCopyReallocator AcDbObjectIdArraynestedPickedEntities,
constAcArray Adesk::GsMarker gsSelectionMark,
constAcArray AcDbObjectId keyPointEntities,
constAcArray AcDbObjectIdArray,
AcArrayObjectCopyReallocator AcDbObjectIdArraynestedKeyPointEntities,
constAcArray Adesk::GsMarker keyPointGsSelectionMark,
constAcArray AcGeCurve3d* alignmentPaths, const AcGePoint3d computedPoint);

AcRxClass*m_pAppDataClass;
//这个就不用讲了，每个ACDB对象都会有，用来识别对象等操作的。