Estrutura GESTURECONFIG (winuser.h)

Obtém e define a configuração para habilitar mensagens de gesto e o tipo dessa configuração.

Sintaxe

typedef struct tagGESTURECONFIG {
  DWORD dwID;
  DWORD dwWant;
  DWORD dwBlock;
} GESTURECONFIG, *PGESTURECONFIG;

Membros

dwID

O identificador para o tipo de configuração que terá mensagens habilitadas ou desabilitadas. Para obter mais informações, consulte Comentários.

dwWant

As mensagens a serem habilitadas.

dwBlock

As mensagens a serem desabilitadas.

Comentários

É impossível desabilitar o movimento panorâmico de dois dedos e manter o movimento panorâmico de um único dedo. Você deve definir os bits want para GC_PAN antes de defini-los para GC_PAN_WITH_SINGLE_FINGER_HORIZONTALLY ou GC_PAN_WITH_SINGLE_FINGER_VERTICALLY.

Um vetor de inércia será incluído na mensagem GID_PAN com o sinalizador GF_END se a inércia tiver sido desabilitada por uma chamada para SetGestureConfig.

Quando você passa essa estrutura, o membro dwID contém informações para um conjunto de gestos. Isso determina o que os outros sinalizadores significarão. Se você definir sinalizadores para mensagens de painel, eles serão diferentes daqueles sinalizadores definidos para mensagens de rotação.

A tabela a seguir indica os vários identificadores para gestos compatíveis com o membro dwID da estrutura GESTURECONFIG . Observe que definir dwID como 0 indica que os sinalizadores de configuração de gesto global estão definidos.

Nome	Valor	Descrição
GID_ZOOM	3	Indica as configurações para o gesto de zoom.
GID_PAN	4	Indica o gesto do painel.
GID_ROTATE	5	Indica o gesto de rotação.
GID_TWOFINGERTAP	6	Indica o gesto de toque de dois dedos.
GID_PRESSANDTAP	7	Indica o gesto de pressionar e tocar.

 

Os sinalizadores a seguir são usados quando dwID é definido como 0.

Nome	Valor	Descrição
GC_ALLGESTURES	0x00000001	Indica todos os gestos.

 

Os sinalizadores a seguir são usados quando dwID é definido como GID_ZOOM.

Nome	Valor	Descrição
GC_ZOOM	0x00000001	Indica o gesto de zoom.

 

Os sinalizadores a seguir são usados quando dwID é definido como GID_PAN.

Nome	Valor	Descrição
GC_PAN	0x00000001	Indica todos os gestos de painel.
GC_PAN_WITH_SINGLE_FINGER_VERTICALLY	0x00000002	Indica painéis verticais com um dedo.
GC_PAN_WITH_SINGLE_FINGER_HORIZONTALLY	0x00000004	Indica painéis horizontais com um dedo.
GC_PAN_WITH_GUTTER	0x00000008	Limita o movimento perpendicular à direção primária até que um limite seja atingido para sair da sarjeta.
GC_PAN_WITH_INERTIA	0x00000010	Indica o movimento panorâmico com inércia para diminuir suavemente quando os gestos da panela param.

 

Nota Definir os sinalizadores de GID_PAN em SetGestureConfig afetará o manipulador de gestos padrão para movimento panorâmico. Você não deve ter dwWant e dwBlock definidos para os mesmos sinalizadores; isso resultará em um comportamento inesperado. Consulte Gestos de Toque do Windows para obter mais informações sobre o movimento panorâmico e o suporte a movimento panorâmico herdado; consulte SetGestureConfig para obter exemplos de gestos de habilitação e bloqueio.

 

Os sinalizadores a seguir são usados quando dwID é definido como GID_ROTATE.

Nome	Valor	Descrição
GC_ROTATE	0x00000001	Indica o gesto de rotação.

 

Os sinalizadores a seguir são usados quando dwID é definido como GID_TWOFINGERTAP.

Nome	Valor	Descrição
GC_TWOFINGERTAP	0x00000001	Indica o gesto de toque de dois dedos.

 

Os sinalizadores a seguir são usados quando dwID é definido como GID_PRESSANDTAP.

Nome	Valor	Descrição
GC_PRESSANDTAP	0x00000001	Indica o gesto de pressionar e tocar.

 

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]
Cabeçalho	winuser.h (inclua Windows.h)

Confira também

GetGestureConfig

SetGestureConfig

Estruturas