GetGestureConfig 함수(winuser.h)

창에서 Windows Touch 제스처 메시지가 전송되는 구성을 검색합니다.

구문

BOOL GetGestureConfig(
  [in]      HWND           hwnd,
  [in]      DWORD          dwReserved,
  [in]      DWORD          dwFlags,
  [in]      PUINT          pcIDs,
  [in, out] PGESTURECONFIG pGestureConfig,
  [in]      UINT           cbSize
);

매개 변수

[in] hwnd

제스처 구성을 가져올 창에 대한 핸들입니다.

[in] dwReserved

이 값은 예약되어 있으며 0으로 설정해야 합니다.

[in] dwFlags

제스처 구성을 검색하는 옵션을 나타내는 제스처 명령 플래그 값입니다. 추가 정보 및 지원되는 값은 비고를 참조하세요.

[in] pcIDs

pGestureConfig 버퍼에 있는 제스처 구성 구조 수의 크기입니다.

[in, out] pGestureConfig

제스처 구성을 지정하는 제스처 구성 구조의 배열입니다.

[in] cbSize

제스처 구성(GESTURECONFIG) 구조체의 크기입니다.

반환 값

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

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

설명

cbSize 매개 변수 이외의 값을 sizeof(GESTURECONFIG) 전달하면 이 함수에 대한 호출이 실패하고 GetLastError는 ERROR_INVALID_PARAMETER(10진수 87)를 반환합니다.

다음 표에서는 제스처 구성 값을 나열합니다.

Name	값	Description
GCF_INCLUDE_ANCESTORS	0x00000001	지정된 경우 GetGestureConfig 는 지정된 창과 해당 부모 창 체인에 대한 통합 구성을 반환합니다.

 

예제

    GESTURECONFIG gc[3];    
    UINT uiGcs = 3;

    ZeroMemory(&gc, sizeof(gc));
    gc[0].dwID  = GID_ZOOM;
    gc[1].dwID  = GID_ROTATE;
    gc[2].dwID  = GID_PAN;
    BOOL bResult = GetGestureConfig(hWnd, 0, 0, &uiGcs, gc, sizeof(GESTURECONFIG));        
    if (!bResult){                
        DWORD err = GetLastError();                                       
    }    

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 R2 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	winuser.h(Windows.h 포함)
라이브러리	User32.lib
DLL	User32.dll
API 세트	ext-ms-win-ntuser-misc-l1-2-0(Windows 8.1 도입)

참조

함수

GESTURECONFIG

제스처에 대한 프로그래밍 가이드