Edit

Share via

IsTouchWindow function (winuser.h)

  • Article

Checks whether a specified window is touch-capable and, optionally, retrieves the modifier flags set for the window's touch capability.

Syntax

BOOL IsTouchWindow(
  [in]            HWND   hwnd,
  [out, optional] PULONG pulFlags
);

Parameters

[in] hwnd

The handle of the window. The function fails with ERROR_ACCESS_DENIED if the calling thread is not on the same desktop as the specified window.

[out, optional] pulFlags

The address of the ULONG variable to receive the modifier flags for the specified window's touch capability.

Return value

Returns TRUE if the window supports Windows Touch; returns FALSE if the window does not support Windows Touch.

Remarks

The following table lists the values for the pulFlags output parameter.

Flag Description
TWF_FINETOUCH Specifies that hWnd prefers noncoalesced touch input.
TWF_WANTPALM Clearing this flag disables palm rejection which reduces delays for getting WM_TOUCH messages. This is useful if you want as quick of a response as possible when a user touches your application.

Setting this flag enables palm detection and will prevent some WM_TOUCH messages from being sent to your application. This is useful if you do not want to receive WM_TOUCH messages that are from palm contact.

Requirements

Requirement Value
Minimum supported client Windows 7 [desktop apps only]
Minimum supported server Windows Server 2008 R2 [desktop apps only]
Target Platform Windows
Header winuser.h (include Windows.h)
Library User32.lib
DLL User32.dll
API set ext-ms-win-ntuser-misc-l1-2-0 (introduced in Windows 8.1)

See also

Functions