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 类 对象的笔划，并使用已知的矩形来确定要提取的笔划并将其粘贴到新的 InkDisp 类 对象中。
GetBoundingBox	检索 InkDisp 对象中所有笔划的边界框。
HitTestCircle	检索完全位于已知圆圈内或相交的 InkStrokes 集合。
HitTestWithLasso	检索折线选择区域中的笔划。
HitTestWithRectangle	检索指定矩形中包含的笔划。
加载	使用已知的二进制数据填充新的 InkDisp 对象。
NearestPoint	检索最接近已知点的 InkDisp 对象中的 IInkStrokeDisp，可以选择提供其他信息。
保存	将墨迹转换为指定的格式并返回二进制数据。

属性

InkDisp 类具有以下属性。

properties	访问类型	说明
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 平板电脑版 [仅限桌面应用]
最低受支持的服务器	无受支持的版本
标头	Msinkaut.h (还需要 Msinkaut_i.c)
库	InkObj.dll

另请参阅

IInkStrokeDisp 接口

InkStrokes 集合

IInkTablet 接口