Classe TouchpadGesturesController

[Algumas informações referem-se ao produto pré-lançado que pode ser substancialmente modificado antes de ser lançado comercialmente. Microsoft não faz garantias, expressas ou implícitas, em relação às informações fornecidas aqui.]

Permite que um aplicativo se registre para gestos globais de touchpad envolvendo três ou mais contatos, fornecendo seu próprio manipulador em vez do comportamento padrão do sistema.

Toques e deslizes envolvendo três ou mais contatos são considerados gestos globais. O sistema primeiro verificará se há controladores registrados pelo processo em primeiro plano quando um gesto de touchpad global é executado. Se nenhum for encontrado habilitado e oferecer suporte ao gesto, o gesto será roteado para o próprio manipulador do sistema. Os controladores em processos em segundo plano são ignorados.

Namespace: Windows. UI. Entrada

Membros

Métodos estáticos

IsSupported

static Boolean IsSupported();

Retorna se a funcionalidade do TouchpadGesturesController tem suporte no sistema.

CreateForProcess

static TouchpadGesturesController CreateForProcess();

Cria um TouchpadGesturesController para o processo associado. Vários controladores podem ser criados para um determinado processo, mas se vários controladores estiverem habilitados e declararem suporte para o mesmo gesto, apenas um receberá os eventos associados.

O controlador cria uma janela no thread no qual ele é criado e, portanto, requer que o thread tenha uma bomba de mensagem. Todos os eventos do controlador serão gerados nesse thread, embora possam ser configurados a partir de qualquer thread. A janela do controlador é marcada como compatível com touchpad por meio de RegisterTouchpadCapableWindow – consulte sua documentação sobre como o thread é afetado.

Propriedades

Habilitado

Boolean Enabled;

Obtém ou define se o controlador está habilitado. Se estiver desabilitado, ele não será considerado pelo sistema como um destino válido para gestos de roteamento.

SupportedGestures

TouchpadGlobalGestureKinds SupportedGestures;

Obtém ou define os gestos compatíveis com o controlador. O sistema só roteará gestos para o controlador se tiver declarado suporte para eles. As manipulações referem-se à entrada touchpad em que os dedos foram movidos (por exemplo, deslizando pelo touchpad), enquanto as ações são causadas por dedos estacionários (por exemplo, tocar ou pressionar o botão de superfície do touchpad sem se mover).

Eventos

PointerPressed, PointerMoved, PointerReleased

event Windows.Foundation.TypedEventHandler<
    TouchpadGesturesController,
    Windows.UI.Core.PointerEventArgs> PointerPressed;

event Windows.Foundation.TypedEventHandler<
    TouchpadGesturesController,
    Windows.UI.Core.PointerEventArgs> PointerMoved;

event Windows.Foundation.TypedEventHandler<
    TouchpadGesturesController,
    Windows.UI.Core.PointerEventArgs> PointerReleased;

Esses eventos são disparados para os gestos de estilo de "manipulação". Eles funcionam de forma idêntica à maneira como a entrada de ponteiro normalmente fluiria para um aplicativo – cada dedo disparará PointerPressed, seguido por zero ou mais PointerMoved, concluído por PointerReleased.

Observação

A entrada de ponteiro para touchpads tem algumas diferenças em comparação com outros tipos de dispositivo de ponteiro. Consulte as observações de GetPointerTouchpadInfo para obter mais informações.

Observação

Embora seja permitido usar APIs do Win32, como GetPointerInfo , para consultar informações sobre a entrada do ponteiro durante o tratamento de um desses eventos, SkipPointerFrameMessages não deve ser chamado. O TouchpadGesturesController executa o processamento na entrada, além de disparar o evento e ignorar as mensagens de ponteiro pode fazer com que seu processamento se comporte incorretamente.

GlobalActionPerformed

event Windows.Foundation.TypedEventHandler<
    TouchpadGesturesController,
    TouchpadGlobalActionEventArgs> GlobalActionPerformed;

Disparado para os gestos de estilo "ação".

  • [X]FingerTap: disparado pelo usuário executando um toque de vários dedos no touchpad.
  • [X]FingerPress: disparado pelo usuário pressionando para baixo no botão de superfície do touchpad com vários dedos.
  • [X]FingerRelease: disparado pelo usuário liberando o botão de superfície do touchpad após o evento acima.

TouchpadGlobalGestureKinds

[flags]
enum TouchpadGlobalGestureKinds
{
    None                        = 0x0,
    ThreeFingerManipulations    = 0x1,
    FourFingerManipulations     = 0x2,
    FiveFingerManipulations     = 0x4,
    ThreeFingerActions          = 0x8,
    FourFingerActions           = 0x10,
    FiveFingerActions           = 0x20,
};
Valor Meaning
Nenhum (0x0) Sem gestos.
ThreeFingerManipulations (0x1) Gestos de deslizar/arrastar de três dedos.
FourFingerManipulations (0x2) Gestos de deslizar/arrastar de quatro dedos.
FiveFingerManipulations (0x4) Gestos de deslizar/arrastar de cinco dedos.
ThreeFingerActions (0x8) Toque de três dedos e pressione gestos de botão.
FourFingerActions (0x10) Toque de quatro dedos e pressione gestos de botão.
FiveFingerActions (0x20) Toque de cinco dedos e pressione gestos de botão.

TouchpadGlobalAction

enum TouchpadGlobalAction
{
    ThreeFingerTap,
    FourFingerTap,
    FiveFingerTap,
    ThreeFingerPress,
    FourFingerPress,
    FiveFingerPress,
    ThreeFingerRelease,
    FourFingerRelease,
    FiveFingerRelease,
};
Valor Meaning
ThreeFingerTap Toque de três dedos no touchpad.
FourFingerTap Toque de quatro dedos no touchpad.
FiveFingerTap Toque de cinco dedos no touchpad.
ThreeFingerPress Pressione três dedos no botão de superfície do touchpad.
FourFingerPress Pressione quatro dedos no botão de superfície do touchpad.
FiveFingerPress Pressione cinco dedos no botão de superfície do touchpad.
ThreeFingerRelease Solte após uma tecla de três dedos.
FourFingerRelease Solte após uma tecla de quatro dedos.
FiveFingerRelease Solte após uma tecla de cinco dedos.

Requisitos

Requisito Valor
Cliente mínimo suportado Windows 11
Namespace Windows. UI. Entrada
Contrato da API Windows. Foundation.UniversalApiContract (versão 19)
Iids ITouchpadGesturesController: 28c13cdd-e068-549f-89c6-1a440c6fc327, ITouchpadGesturesControllerStatics: 207ef171-1a73-51cd-a694-8840e09dbafa, ITouchpadGlobalActionEventArgs: 6edad206-e4e3-5f39-9d13-8575e8e2a12b

Consulte também

  • Last updated on