InkDisp 类

表示墨迹空间中收集的墨迹笔划。

InkDisp 具有以下类型的成员：

• 事件
• 接口
• 方法
• 属性

事件

InkDisp 类具有这些事件。

事件	说明
InkAdded	在将笔划添加到 InkDisp 对象时发生。
InkDeleted	从 InkDisp 对象中删除笔划时发生。

接口

InkDisp 类定义这些接口。

接口	说明
IInkDisp	此对象实现 IInkDisp COM 接口。

方法

InkDisp 类具有这些方法。

方法	说明
AddStrokesAtRectangle	将笔划集合插入到指定矩形的 InkDisp 对象中。
CanPaste	指示是否可以将 IDataObject 转换为 InkDisp 对象。
Clip	删除矩形外部的笔划部分或笔划集合。
ClipboardCopy	将 InkStrokes 集合复制到剪贴板。
ClipboardCopyWithRectangle	将已知矩形中包含的 IInkStrokeDisp 对象复制到剪贴板。
ClipboardPaste	将 IDataObject 从剪贴板复制到 InkDisp 对象。
克隆	创建重复的 InkDisp 对象。
CreateStroke	根据点或数据包数据创建笔划。
CreateStrokes	为此 InkDisp 对象创建 InkStrokes 集合。
DeleteStroke	从 InkDisp 对象中删除笔划。
DeleteStrokes	从 InkDisp 对象中删除笔划。
ExtractStrokes 方法	从 InkDisp 对象中提取笔划，并返回包含提取的笔划的新 InkDisp 对象。
ExtractWithRectangle 方法	使用已知矩形确定要提取的笔划，剪切或复制现有 InkDisp Class 对象的笔划，并将其粘贴到新的 InkDisp Class 对象中。
GetBoundingBox	检索 InkDisp 对象中所有笔划的边界框。
HitTestCircle	检索完全位于已知圆圈内部或相交的 InkStrokes 集合。
HitTestWithLasso	检索折线选择区域内的笔划。
HitTestWithRectangle	检索包含在指定矩形中的笔划。
加载	使用已知的二进制数据填充新的 InkDisp 对象。
NearestPoint	检索最接近已知点的 InkDisp 对象中的 IInkStrokeDisp，可以选择提供其他信息。
保存	将墨迹转换为指定的格式并返回二进制数据。

属性

InkDisp 类具有这些属性。

属性	访问类型	说明
CustomStrokes	只读	获取要与墨迹一起保留的 IInkCustomStrokes 集合。
脏	读取/写入	获取或设置值，该值指示自上次保存墨迹以来是否已修改 InkDisp 对象。
ExtendedProperties	只读	获取应用程序定义的数据的集合。
中风	只读	获取 InkDisp 对象中包含的 InkStrokes 集合。

备注

可以通过在 C++ 中调用 CoCreateInstance 方法来实例化此对象。

注意

此对象的第一次实例化也会导致 GDI+ 被实例化。 一个副作用是，如果在循环中使用单个墨迹对象并在循环中创建并销毁它，将导致 GDI+ 被一遍又一遍地实例化。 这可能会导致应用程序性能下降。 若要避免这种情况，请在应用程序使用墨迹时始终保留墨迹对象的单个实例。

InkDisp 对象是笔划 (点) 数据的容器。 笔划数据或笔收集的点将放入 InkDisp 对象中。 Strokes 属性包含 InkDisp 对象中所有笔划的数据。

InkCollector 对象、InkOverlay 对象和 InkPicture 控件从输入设备收集点，并将其放入 InkDisp 对象中。 这些对象实质上充当将墨迹分发到一个或多个不同 InkDisp 对象的源，这些对象充当保存分布式墨迹的容器。

墨迹空间是平板电脑上下文坐标映射到的虚拟坐标空间。 此空间固定为 HIMETRIC 坐标系。 在墨迹空间坐标中，从 0 移动到 1 等于 1 HIMETRIC 单位。 通过此映射，可以轻松地关联多个 InkDisp 对象。

InkRenderer 对象管理墨迹与显示窗口之间的映射。

要求

要求	值
最低受支持的客户端	Windows XP Tablet PC Edition [仅限桌面应用]
最低受支持的服务器	无受支持的版本
标头	Msinkaut.h (还需要 Msinkaut_i.c)
库	InkObj.dll

另请参阅

IInkStrokeDisp 接口

InkStrokes 集合

IInkTablet 接口