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 도입) |