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. |
| 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) |