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)

Confira também

Funções

GESTURECONFIG

Guia de programação para gestos