Kelas TouchpadGesturesController

[Beberapa informasi berkaitan dengan produk pra-rilis yang mungkin dimodifikasi secara substansial sebelum dirilis secara komersial. Microsoft tidak memberikan jaminan, tersurat maupun tersirat, sehubungan dengan informasi yang diberikan di sini.]

Memungkinkan aplikasi mendaftar untuk gerakan touchpad global yang melibatkan tiga kontak atau lebih, menyediakan handler mereka sendiri alih-alih perilaku sistem default.

Ketukan dan gesek yang melibatkan tiga kontak atau lebih dianggap sebagai gerakan global. Sistem pertama-tama akan memeriksa pengontrol apa pun yang terdaftar oleh proses latar depan ketika gerakan touchpad global dilakukan. Jika tidak ada yang ditemukan yang diaktifkan dan mendukung gerakan, maka gerakan akan dirutekan ke handler sistem sendiri. Pengontrol dalam proses latar belakang diabaikan.

Namespace: Windows. UI. Input

Members

Metode statis

ApakahDidukung

static Boolean IsSupported();

Mengembalikan apakah fungsionalitas TouchpadGesturesController didukung pada sistem.

CreateForProcess

static TouchpadGesturesController CreateForProcess();

Membuat TouchpadGesturesController untuk proses terkait. Beberapa pengontrol dapat dibuat untuk proses tertentu, tetapi jika beberapa pengontrol diaktifkan dan mendeklarasikan dukungan untuk gerakan yang sama, hanya satu yang akan menerima peristiwa terkait.

Pengontrol membuat jendela pada utas tempatnya dibuat dan oleh karena itu mengharuskan utas memiliki pompa pesan. Semua peristiwa pengontrol akan dinaikkan pada utas ini, meskipun dapat dikonfigurasi dari utas apa pun. Jendela pengontrol ditandai sebagai berkemampuan touchpad melalui RegisterTouchpadCapableWindow — lihat dokumentasinya tentang bagaimana utas terpengaruh.

Karakteristik

Enabled

Boolean Enabled;

Mendapatkan atau mengatur apakah pengontrol diaktifkan. Jika dinonaktifkan, itu tidak akan dianggap oleh sistem sebagai target yang valid untuk gerakan perutean.

SupportedGestures

TouchpadGlobalGestureKinds SupportedGestures;

Mendapatkan atau mengatur gerakan yang didukung oleh pengontrol. Sistem hanya akan merutekan gerakan ke pengontrol jika telah mendeklarasikan dukungan untuk mereka. Manipulasi mengacu pada input touchpad tempat jari telah bergerak (misalnya, menggesekkan di touchpad), sedangkan tindakan disebabkan oleh jari stasioner (misalnya, mengetuk atau menekan tombol permukaan touchpad tanpa bergerak).

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;

Peristiwa ini dipicu untuk gerakan gaya "manipulasi". Mereka bekerja identik dengan bagaimana input pointer biasanya akan mengalir ke aplikasi - setiap jari akan memicu PointerPressed, diikuti oleh nol atau lebih PointerMoved, disimpulkan oleh PointerReleased.

Nota

Input pointer untuk touchpad memiliki beberapa perbedaan jika dibandingkan dengan jenis perangkat pointer lainnya. Lihat keterangan untuk GetPointerTouchpadInfo untuk informasi selengkapnya.

Nota

Meskipun diizinkan untuk menggunakan API Win32 seperti GetPointerInfo untuk mengkueri informasi tentang input pointer saat menangani salah satu peristiwa ini, SkipPointerFrameMessages tidak boleh dipanggil. TouchpadGesturesController melakukan pemrosesan pada input selain memicu peristiwa dan melewatkan pesan pointer dapat menyebabkan pemrosesannya bertingkah tidak benar.

GlobalActionPerformed

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

Dipicu untuk gerakan gaya "tindakan".

  • [X]FingerTap: Dipicu oleh pengguna yang melakukan ketukan multi-jari pada touchpad.
  • [X]FingerPress: Dipicu oleh pengguna menekan tombol permukaan touchpad dengan beberapa jari.
  • [X]FingerRelease: Dipicu oleh pengguna yang merilis tombol permukaan touchpad setelah peristiwa di atas.

TouchpadGlobalGestureKinds

[flags]
enum TouchpadGlobalGestureKinds
{
    None                        = 0x0,
    ThreeFingerManipulations    = 0x1,
    FourFingerManipulations     = 0x2,
    FiveFingerManipulations     = 0x4,
    ThreeFingerActions          = 0x8,
    FourFingerActions           = 0x10,
    FiveFingerActions           = 0x20,
};
Nilai Meaning
Tidak ada (0x0) Tidak ada gerakan.
ThreeFingerManipulations (0x1) Gerakan gesek/seret tiga jari.
FourFingerManipulations (0x2) Gerakan gesek/seret empat jari.
FiveFingerManipulations (0x4) Gerakan gesek/seret lima jari.
ThreeFingerActions (0x8) Ketuk tiga jari dan tekan gerakan tombol.
FourFingerActions (0x10) Ketuk empat jari dan tekan gerakan tombol.
FiveFingerActions (0x20) Ketuk lima jari dan tekan gerakan tombol.

TouchpadGlobalAction

enum TouchpadGlobalAction
{
    ThreeFingerTap,
    FourFingerTap,
    FiveFingerTap,
    ThreeFingerPress,
    FourFingerPress,
    FiveFingerPress,
    ThreeFingerRelease,
    FourFingerRelease,
    FiveFingerRelease,
};
Nilai Meaning
ThreeFingerTap Ketuk tiga jari pada touchpad.
FourFingerTap Ketuk empat jari pada touchpad.
FiveFingerTap Ketuk lima jari pada touchpad.
ThreeFingerPress Tekan tiga jari pada tombol permukaan touchpad.
FourFingerPress Tekan empat jari pada tombol permukaan touchpad.
FiveFingerPress Tekan lima jari pada tombol permukaan touchpad.
ThreeFingerRelease Lepaskan setelah menekan tiga jari.
FourFingerRelease Lepaskan setelah tekan empat jari.
FiveFingerRelease Lepaskan setelah tekan lima jari.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 11
Namespace Windows. UI. Input
Kontrak API Windows. Foundation.UniversalApiContract (versi 19)
IID ITouchpadGesturesController: 28c13cdd-e068-549f-89c6-1a440c6fc327, ITouchpadGesturesControllerStatics: 207ef171-1a73-51cd-a694-8840e09dbafa, ITouchpadGlobalActionEventArgs: 6edad206-e4e3-5f39-9d13-8575e8e2a12b

Baca juga

  • Last updated on