GetGestureConfig Function
Retrieves the configuration for which Windows Touch gesture messages are sent from a window.
Syntax
BOOL WINAPI GetGestureConfig(
__in HWND hwnd,
__in DWORD dwReserved,
__in DWORD dwFlags,
__in PUINT pcIDs,
__inout PGESTURECONFIG pGestureConfig,
__in UINT cbSize
);
Parameter
hwnd [in]
A handle to the window to get the gesture configuration from.dwReserved [in]
This value is reserved and must be set to 0.dwFlags [in]
A gesture command flag value indicating options for retrieving the gesture configuration. See Remarks for additional information and supported values.pcIDs [in]
The size, in number of gesture configuration structures, that is in the pGestureConfig buffer.pGestureConfig [in, out]
An array of gesture configuration structures that specify the gesture configuration.cbSize [in]
The size of the gesture configuration (GESTURECONFIG) structure.
Rückgabewert
If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero. To get extended error information, use the GetLastError function.
Hinweise
Passing a value other than sizeof(GESTURECONFIG)
for the cbSize parameter will cause calls to this function to fail and GetLastError will return ERROR_INVALID_PARAMETER (87 in decimal).
The following table lists the gesture configuration values:
Name | Value | Description |
---|---|---|
GCF_INCLUDE_ANCESTORS | 0x00000001 | If specified, GetGestureConfig returns consolidated configuration for the specified window and its parent window chain. |
Beispiele
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();
}
Anforderungen
Mindestens unterstützter Client |
Windows 7 |
Mindestens unterstützter Server |
Windows Server 2008 R2 |
Header |
Winuser.h (include Windows.h) |
Bibliothek |
User32.lib |
DLL |
User32.dll |