RegisterTouchWindow 함수(winuser.h)

  • 아티클

창을 터치 가능으로 등록합니다.

구문

BOOL RegisterTouchWindow(
  [in] HWND  hwnd,
  [in] ULONG ulFlags
);

매개 변수

[in] hwnd

등록할 창의 핸들입니다. 호출 스레드가 지정된 창을 소유하지 않으면 함수가 ERROR_ACCESS_DENIED 실패합니다.

[in] ulFlags

선택적 수정을 지정하는 비트 플래그 집합입니다. 이 필드에는 0 또는 다음 값 중 하나가 포함될 수 있습니다.

값 의미
TWF_FINETOUCH
 hWnd가 비코일식 터치 입력을 선호한다고 지정합니다.
TWF_WANTPALM
 이 플래그를 설정하면 손바닥 거부가 비활성화되어 WM_TOUCH 메시지 가져오기 지연이 줄어듭니다. 이는 사용자가 애플리케이션을 터치할 때 가능한 한 빨리 응답을 원하는 경우에 유용합니다.

기본적으로 손바닥 검색이 사용하도록 설정되고 일부 WM_TOUCH 메시지가 애플리케이션으로 전송되지 않습니다. 손바닥 접촉에서 WM_TOUCH 메시지를 수신 하지 않으려는 경우에 유용합니다.

반환 값

함수가 성공하면 반환 값이 0이 아닙니다.

함수가 실패하면 반환 값은 0입니다. 확장된 오류 정보를 얻으려면 GetLastError 함수를 사용합니다.

설명

참고RegisterTouchWindow 는 터치 입력에 사용할 모든 창에서 호출되어야 합니다. 즉, 여러 창이 있는 애플리케이션이 있는 경우 터치 기능을 사용하는 해당 애플리케이션의 모든 창에서 RegisterTouchWindow 를 호출해야 합니다. 또한 애플리케이션은 한정자 플래그를 변경하려는 경우 동일한 창에 대해 RegisterTouchWindow 를 여러 번 호출할 수 있습니다. UnregisterTouchWindow 함수를 사용하여 창을 더 이상 터치 입력이 필요하지 않은 것으로 표시할 수 있습니다.
 
TWF_WANTPALM 사용하도록 설정되면 터치 입력의 패킷이 버퍼링되지 않으며 패킷이 애플리케이션으로 전송되기 전에 손바닥 검색이 수행되지 않습니다. TWF_WANTPALM 사용하도록 설정하는 것은 WM_TOUCH메시지를 처리 할 때 대기 시간을 최소화하려는 경우에 가장 유용합니다.

예제


BOOL InitInstance(HINSTANCE hInstance, int nCmdShow)
{
   HWND hWnd;

   hInst = hInstance; // Store instance handle in the global variable.

   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 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 winuser.h(Windows.h 포함)
라이브러리 User32.lib
DLL User32.dll

참조

함수

UnregisterTouchWindow