TouchpadGesturesController, klasa

[Niektóre informacje odnoszą się do wstępnie wydanego produktu, który może zostać znacząco zmodyfikowany przed jego wydaniem komercyjnym. Microsoft nie udziela żadnych gwarancji, wyraźnych ani domniemanych, w odniesieniu do informacji podanych tutaj.]

Umożliwia aplikacji rejestrowanie globalnych gestów touchpad obejmujących co najmniej trzy kontakty, zapewniając własną procedurę obsługi zamiast domyślnego zachowania systemu.

Naciśnięcia i przesunięcia obejmujące trzy lub więcej kontaktów są uważane za gesty globalne. System najpierw sprawdzi wszystkie kontrolery zarejestrowane przez proces pierwszego planu po wykonaniu globalnego gestu touchpad. Jeśli żaden nie zostanie znaleziony, który jest włączony i obsługuje gest, gest zostanie skierowany do własnego programu obsługi systemu. Kontrolery w procesach w tle są ignorowane.

Namespace: Windows. Interfejsu użytkownika. Wejście

Członkowie

Metody statyczne

IsSupported

static Boolean IsSupported();

Zwraca, czy funkcja TouchpadGesturesController jest obsługiwana w systemie.

CreateForProcess

static TouchpadGesturesController CreateForProcess();

Tworzy element TouchpadGesturesController dla skojarzonego procesu. Dla danego procesu można utworzyć wiele kontrolerów, ale jeśli wiele kontrolerów jest włączonych i deklaruje obsługę tego samego gestu, tylko jeden z nich otrzyma skojarzone zdarzenia.

Kontroler tworzy okno w wątku, na którym jest tworzony, i dlatego wymaga, aby wątek miał pompę komunikatów. Wszystkie zdarzenia kontrolera zostaną zgłoszone w tym wątku, chociaż można je skonfigurować z dowolnego wątku. Okno kontrolera jest oznaczone jako obsługujące touchpad za pośrednictwem funkcji RegisterTouchpadCapableWindow — zapoznaj się z jego dokumentacją dotyczącą wpływu wątku.

Właściwości

Enabled

Boolean Enabled;

Pobiera lub ustawia, czy kontroler jest włączony. W przypadku wyłączenia system nie będzie traktowany jako prawidłowy element docelowy dla gestów rozsyłania.

SupportedGestures

TouchpadGlobalGestureKinds SupportedGestures;

Pobiera lub ustawia gesty obsługiwane przez kontroler. System będzie kierować gesty tylko do kontrolera, jeśli zadeklarował obsługę dla nich. Manipulacje odnoszą się do danych wejściowych touchpad, w których palce zostały przesunięte (na przykład przesuwanie w poprzek touchpadu), natomiast akcje są spowodowane przez stacjonarne palce (na przykład naciśnięcie lub naciśnięcie przycisku powierzchni touchpad bez poruszania się).

Events

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;

Te zdarzenia są wyzwalane dla gestów stylu "manipulowania". Działają one identycznie, jak dane wejściowe wskaźnika zwykle przepływają do aplikacji — każdy palec wyzwoli wskaźnikPressed, a następnie zero lub więcej wskaźnikówMoved, zakończony przez PointerReleased.

GlobalActionPerformed

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

Wyzwalane dla gestów stylu "akcja".

• [X]FingerTap: wyzwolony przez użytkownika wykonującego naciśnięcie wielu palców na panelu dotykowym.
• [X]FingerPress: wyzwolony przez użytkownika naciskającego w dół przycisk powierzchni touchpada z wieloma palcami.
• [X]FingerRelease: wyzwolony przez użytkownika zwalniającego przycisk surface tabletu touchpad po powyższym zdarzeniu.

Powiązane wyliczenia

TouchpadGlobalGestureKinds

[flags]
enum TouchpadGlobalGestureKinds
{
    None                        = 0x0,
    ThreeFingerManipulations    = 0x1,
    FourFingerManipulations     = 0x2,
    FiveFingerManipulations     = 0x4,
    ThreeFingerActions          = 0x8,
    FourFingerActions           = 0x10,
    FiveFingerActions           = 0x20,
};

TouchpadGlobalAction

enum TouchpadGlobalAction
{
    ThreeFingerTap,
    FourFingerTap,
    FiveFingerTap,
    ThreeFingerPress,
    FourFingerPress,
    FiveFingerPress,
    ThreeFingerRelease,
    FourFingerRelease,
    FiveFingerRelease,
};

Wymagania

Zobacz także

• PhysicalGestureRecognizer
• RegisterTouchpadCapableWindow
• InjectTouchpadAction
• Precyzyjny przewodnik programowania touchpad
• Precyzja — dokumentacja touchpadu