Função GetGestureConfig (winuser.h)
Recupera a configuração para a qual as mensagens de gesto do Windows Touch são enviadas de uma janela.
Sintaxe
BOOL GetGestureConfig(
[in] HWND hwnd,
[in] DWORD dwReserved,
[in] DWORD dwFlags,
[in] PUINT pcIDs,
[in, out] PGESTURECONFIG pGestureConfig,
[in] UINT cbSize
);
Parâmetros
[in] hwnd
Um identificador para a janela da qual obter a configuração de gesto.
[in] dwReserved
Esse valor é reservado e deve ser definido como 0.
[in] dwFlags
Um valor de sinalizador de comando de gesto que indica opções para recuperar a configuração de gesto. Consulte Comentários para obter informações adicionais e valores com suporte.
[in] pcIDs
O tamanho, em número de estruturas de configuração de gestos, que está no buffer pGestureConfig .
[in, out] pGestureConfig
Uma matriz de estruturas de configuração de gestos que especificam a configuração de gesto.
[in] cbSize
O tamanho da estrutura de configuração de gesto (GESTURECONFIG).
Valor retornado
Se a função for bem-sucedida, o valor retornado será diferente de zero.
Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, use a função GetLastError .
Comentários
Passar um valor diferente do sizeof(GESTURECONFIG) parâmetro cbSize fará com que as chamadas para essa função falhem e GetLastError retornará ERROR_INVALID_PARAMETER (87 em decimal).
A tabela a seguir lista os valores de configuração de gesto:
| Nome | Valor | Descrição |
|---|---|---|
| GCF_INCLUDE_ANCESTORS | 0x00000001 | Se especificado, GetGestureConfig retornará a configuração consolidada para a janela especificada e sua cadeia de janelas pai. |
Exemplos
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();
}
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 7 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 R2 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | winuser.h (inclua Windows.h) |
| Biblioteca | User32.lib |
| DLL | User32.dll |
| Conjunto de APIs | ext-ms-win-ntuser-misc-l1-2-0 (introduzido em Windows 8.1) |