ITablet::CreateContext 方法
创建描述指定平板电脑设备的上下文对象。
语法
HRESULT CreateContext(
[in] HWND hWnd,
[in] RECT *prcInput,
[in] DWORD dwOptions,
[in] TABLET_CONTEXT_SETTINGS *pTCS,
[in] CONTEXT_ENABLE_TYPE cet,
[out] ITabletContext **ppCtx,
[in, out] TABLET_CONTEXT_ID *pTcid,
[in, out] PACKET_DESCRIPTION **ppPD,
[in] ITabletEventSink *pSink
);
parameters
-
hWnd [in]
-
要附加到平板电脑上下文的窗口。
-
prcInput [in]
-
[in, unique]
墨迹输入矩形。
-
dwOptions [in]
-
设置平板电脑上下文选项的标志。
-
pTCS [in]
-
[in, unique]
有关要创建的平板电脑上下文的详细信息。
-
cet [in]
-
启用或禁用发送到窗口的上下文消息的值。
-
ppCtx [out]
-
指向新创建的平板电脑上下文的指针。
-
pTcid [in, out]
-
唯一标识平板电脑的值。
-
ppPD [in, out]
-
指向有关每个数据包中包含的数据的信息的指针。
-
pSink [in]
-
将在其中发送通知消息的 ITabletEventSink 对象。
返回值
此方法可以返回其中一个值。
返回代码 | 说明 |
---|---|
|
成功。 |
|
发生了未指定的错误。 |
备注
通常,应用程序从 ITablet::GetDefaultContextSettings 方法获取默认值,修改值以满足其需求,然后将修改后的设置结构传递给 ITablet::CreateContext 方法。
注意
调用 ITablet::CreateContext 方法时,必须实现 ITabletEventSink接口。
dwOptions 参数是描述上下文选项的一组位标志。 下表介绍了这些标志。
标志名称 | “值” | 说明 |
---|---|---|
TCXO_MARGIN |
0x00000001 |
指定平板电脑上的输入上下文将具有边距。 边距是指定输入区域外部的区域,其中事件将映射到输入区域的边缘。 此功能可更轻松地在上下文边缘输入点。 |
TCXO_PREHOOK |
0x00000002 |
预挂钩在常规上下文和后挂钩之前获取数据包。 它们按创建顺序获取数据包。 |
TCXO_CURSOR_STATE |
0x00000004 |
即使游标已打开,TC 也会返回数据包。 默认情况下,TC 仅在光标关闭时返回数据包。 |
TCXO_NO_CURSOR_DOWN |
0x00000008 |
当光标关闭时,TC 不会返回数据包。 |
TCXO_NON_INTEGRATED |
0x00000010 |
上下文将是非集成的。 |
TCXO_POSTHOOK |
0x00000020 |
Posthook 在常规平板电脑上下文之后但在系统上下文之前获取数据包。 它们按创建时相反的顺序获取数据包。 |
TCXO_DONT_SHOW_CURSOR |
0x00000080 |
TC 不会设置光标位置。 |
TCXO_DONT_VALIDATE_TCS |
0x00000100 |
TC 不会根据设备的受支持属性验证在平板电脑上下文设置中传递的 GUID。 |
TCXO_ALLOW_FLICKS |
0x00000400 |
默认情况下,TC 将允许在 (进行轻扫检测,这仅在系统上下文) 允许,客户端将获取SE_FLICK事件。 |
TCXO_ALLOW_FEEDBACK_TAPS |
0x00000800 |
TC 将允许显示笔反馈。 默认情况下,仅在系统上下文中允许这样做。 |
TCXO_ALLOW_FEEDBACK_BARREL |
0x00001000 |
TC 将允许显示笔反馈。 默认情况下,仅在系统上下文中允许这样做。 |
TCXO_ALL |
TCXO_MARGIN |TCXO_PREHOOK |TCXO_CURSOR_STATE |TCXO_NO_CURSOR_DOWN |TCXO_NON_INTEGRATED |TCXO_POSTHOOK |TCXO_DONT_SHOW_CURSOR |TCXO_DONT_VALIDATE_TCS |
所有定义的平板电脑上下文选项。 |
TCXO_HOOK |
TCXO_PREHOOK |TCXO_POSTHOOK |
结合了挂钩前和挂钩后功能。 |
要求
要求 | 值 |
---|---|
最低受支持的客户端 |
Windows XP Tablet PC Edition [仅限桌面应用] |
最低受支持的服务器 |
无受支持的版本 |
库 |
|