Share via

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 对象。

返回值

此方法可以返回其中一个值。

返回代码 说明
S_OK
 成功。
E_FAIL
 发生了未指定的错误。

备注

通常，应用程序从 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 [仅限桌面应用]
最低受支持的服务器
 无受支持的版本
库
Wisptis.exe

另请参阅

ITablet 接口

CONTEXT_ENABLE_TYPE 枚举

TABLET_CONTEXT_SETTINGS结构

PACKET_DESCRIPTION 结构

ITabletContextP 接口

ITabletEventSink 接口