函数说明

语法

参数(标志位说明)

返回值

评论

示例

要求

另请参见

函数说明

将窗口注册为具有触控功能。

语法

BOOL WINAPI RegisterTouchWindow(

__in HWND hWnd,

__in ULONG ulFlags

);

参数

hWnd [in]

所注册的窗口的句柄。如果调用的线程不拥有指定的窗口，则该函数将失败，并显示ERROR_ACCESS_DENIED 。

ulFlags [in]

一组可用于指定可选修改的位标志。此字段可能包含 0 或下列值之一。

标志位说明

TWF_FINETOUCH 设置 hWnd 为非合并触摸输入方式. 设置此标志将禁用防止手掌误触功能，从而减少获取WM_TOUCH 消息的延迟。如果您希望在用户触摸应用程序时尽可能快地做出响应，这样做非常有用。

TWF_WANTPALM 默认情况下，将启用防止手掌误触功能，并阻止将某些WM_TOUCH 消息发送到您的应用程序。如果您不希望接收因手掌接触引发的WM_TOUCH 消息，这样做非常有用。

返回值

如果函数成功，则返回值为非零值。

如果函数失败，则返回值为零。若要获取扩展的错误信息，请使用 GetLastError 函数。

评论

注意 必须针对将用于触控输入的每个窗口调用 RegisterTouchWindow。这意味着，如果您具有的应用程序内部包含多个窗口，则必须针对该应用程序中使用触控功能的每个窗口调用 RegisterTouchWindow。此外，如果某个应用程序希望更改修饰符标志，则该应用程序可以针对同一个窗口调用任意多次 RegisterTouchWindow。也可以使用 UnregisterTouchWindow 函数将一个窗口标记为不再需要触控输入。

如果启用 TWF_WANTPALM，则在将来自触控输入的数据包发送到您的应用程序之前，将缓存这些数据包并执行防止手掌误触功能。启用 TWF_WANTPALM 在您使用笔输入时最为有用。

示例

BOOL InitInstance(HINSTANCE hInstance, int nCmdShow)

{

HWND hWnd;

hWnd = CreateWindow(szWindowClass, szTitle, WS_OVERLAPPEDWINDOW,

CW_USEDEFAULT, 0, CW_USEDEFAULT, 0, NULL, NULL, hInstance, NULL);

RegisterTouchWindow(hWnd, 0);

if (!hWnd)

{

return FALSE;

}

ShowWindow(hWnd, nCmdShow);

UpdateWindow(hWnd);

return TRUE;

}

要求

最低支持的客户端　Windows 7

最低支持的服务器　Windows Server 2008 R2

标头　Winuser.h (包括Windows.h)

库　User32.lib

DLL　User32.dll

另请参见

函数

UnregisterTouchWindow