InjectTouchpadAction-Funktion

[Einige Informationen beziehen sich auf vorab veröffentlichte Produkte, die vor der kommerziellen Veröffentlichung erheblich geändert werden können. Microsoft übernimmt keine Gewährleistungen, ausdrücklichen oder konkludenten Angaben in Bezug auf die hier bereitgestellten Informationen.]

Fügt die angegebene Aktion unter Verwendung des angegebenen Geräts als Absender ein.

Syntax

WINUSERAPI
BOOL
WINAPI
InjectTouchpadAction(
    HSYNTHETICPOINTERDEVICE hDevice,
    TOUCHPAD_ACTION action);

Parameter

hDevice

Ein Handle auf ein synthetisches Zeigergerät, das zuvor mit CreateSyntheticPointerDevice2 erstellt wurde.

Aktion

Ein Wert aus der TOUCHPAD_ACTION-Aufzählung , die die einjizierte Aktion angibt.

Zurückgegebener Wert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen abzurufen.

TOUCHPAD_ACTION

Stellt die eingefügte Aktion dar.

typedef enum tagTOUCHPAD_ACTION
{
    TA_3FINGER_TAP,
    TA_3FINGER_PRESS,
    TA_3FINGER_RELEASE,
    TA_4FINGER_TAP,
    TA_4FINGER_PRESS,
    TA_4FINGER_RELEASE,
    TA_5FINGER_TAP,
    TA_5FINGER_PRESS,
    TA_5FINGER_RELEASE,
    TA_INERTIA_STOP,
    TA_INERTIA_END,
} TOUCHPAD_ACTION;
Wert Bedeutung
TA_3FINGER_TAP Fügt eine Geste zum Tippen mit drei Fingern ein.
TA_3FINGER_PRESS Fügt eine Geste mit drei Fingern ein.
TA_3FINGER_RELEASE Fügt eine Geste zum Loslassen mit drei Fingern ein.
TA_4FINGER_TAP Fügt eine Geste zum Tippen mit vier Fingern ein.
TA_4FINGER_PRESS Fügt eine Ziehbewegung mit vier Fingern ein.
TA_4FINGER_RELEASE Fügt eine Loslassenbewegung mit vier Fingern ein.
TA_5FINGER_TAP Fügt eine Geste zum Tippen mit fünf Fingern ein.
TA_5FINGER_PRESS Fügt eine Tastenbewegung mit fünf Fingern injiziert.
TA_5FINGER_RELEASE Fügt eine Geste zum Loslassen mit fünf Fingern ein.
TA_INERTIA_STOP Erzeugt eine WM_STOPINERTIA Nachricht im Nachverfolgten Inertia-Fenster.
TA_INERTIA_END Erzeugt eine WM_ENDINERTIA Nachricht im Nachverfolgten Inertia-Fenster.

Bemerkungen

Diese API ist für die Verwendung in Verbindung mit einem injizierten Touchpadgerät konzipiert, das mit der Option SDCO_TOUCHPAD_GESTURE_ONLY erstellt wurde. Wenn das Touchpad nicht nur gestengeschützt ist, erzeugt das System diese Aktionen als Reaktion auf die Verarbeitung der Eingabe des Touchpads.

Die Finger tippen/drücken/loslassen-Aktionen entsprechen den globalen Touchpadgesten. Weitere Informationen dazu, wie diese Gesten behandelt werden, finden Sie unter TouchpadGesturesController .

Die Unträgheitsaktionen erzeugen WM_STOPINERTIA bzw. WM_ENDINERTIA Nachrichten. Weitere Informationen zur Inertia-Behandlung finden Sie unter ReportWindowContentInertia .

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows 11 [nur Desktop-Apps]
Unterstützter Server (Mindestversion) Nicht unterstützt
Header Winuser.h (einschließen Windows.h)
Bibliothek User32.lib
DLL User32.dll (Ordnungszahl 2803)

Siehe auch