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 接口