Kelas PhysicalGestureRecognizer

[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.]

Melakukan pengenalan gerakan pada input pointer yang disalurkan ke dalamnya, dengan output yang dikembalikan dalam unit relatif terhadap perangkat, bukan piksel independen tampilan yang dikembalikan oleh GestureRecognizer. Unit output ini lebih cocok untuk input touchpad sehingga gerakan dapat dikenali relatif terhadap touchpad itu sendiri daripada ke layar.

Setelah input pointer disalurkan ke recognizer, input menjadi aktif. Ini tetap aktif sampai interaksi input selesai - baik dengan memberi makan input keberangkatan untuk semua kontak atau dengan menyelesaikannya secara paksa melalui CompleteGesture().

Semua API berfungsi identik dengan rekan-rekan mereka di GestureRecognizer. Satu-satunya perbedaan adalah ruang koordinat output yang dikenali yang diekspos melalui peristiwa gerakan.

Namespace: Windows. UI. Input

Members

Constructor

PhysicalGestureRecognizer();

Mengembalikan instans baru runtimeclass PhysicalGestureRecognizer .

Karakteristik

IsActive

Boolean IsActive { get; }

Mengembalikan apakah interaksi input masih diproses.

GestureSettings

Windows.UI.Input.GestureSettings GestureSettings;

Mendapatkan atau mengatur gerakan yang dikonfigurasi untuk pengenalan. PhysicalGestureRecognizer mendukung subset gerakan berikut:

  • Tekan
  • Tahan
  • ManipulationTranslate[Rails][X,Y]
  • ManipulationRotate
  • ManipulasiScale
  • ManipulasiMultipleFingerPanning

Input touchpad tidak akan pernah dikenali sebagai Ketuk atau Tahan, karena input touchpad hanya diterima dalam skenario di mana gerakan tersebut tidak lagi dapat dilakukan.

TapMinContactCount

UInt32 TapMinContactCount;

Mendapatkan atau mengatur jumlah minimum kontak yang diperlukan agar ketukan dikenali.

TapMaxContactCount

UInt32 TapMaxContactCount;

Mendapatkan atau mengatur jumlah maksimum kontak yang diperlukan agar ketukan dikenali.

HoldMinContactCount

UInt32 HoldMinContactCount;

Mendapatkan atau mengatur jumlah minimum kontak yang diperlukan agar penangguhan dikenali.

HoldMaxContactCount

UInt32 HoldMaxContactCount;

Mendapatkan atau mengatur jumlah maksimum kontak yang diperlukan agar penangguhan dikenali.

HoldRadius

Single HoldRadius;

Mendapatkan atau mengatur radius tempat kontak harus tetap berada dari lokasi aslinya agar ketukan atau penangguh dapat dikenali.

HoldStartDelay

Windows.Foundation.TimeSpan HoldStartDelay;

Mendapatkan atau mengatur jumlah waktu kontak harus tetap tidak berfungsi sebelum penangguhan dikenali. Jika durasi kontak kurang dari nilai ini saat berangkat, dan belum melakukan perjalanan lebih jauh dari HoldRadius, ketukan akan dikenali.

TranslationMinContactCount

UInt32 TranslationMinContactCount;

Mendapatkan atau mengatur jumlah minimum kontak yang diperlukan agar terjemahan dikenali.

TranslationMaxContactCount

UInt32 TranslationMaxContactCount;

Mendapatkan atau mengatur jumlah maksimum kontak yang diperlukan agar terjemahan dikenali.

Metode

ProcessDownEvent, ProcessMoveEvents, ProcessUpEvent

void ProcessDownEvent(Windows.UI.Input.PointerPoint value);
void ProcessMoveEvents(IVector<Windows.UI.Input.PointerPoint> value);
void ProcessUpEvent(Windows.UI.Input.PointerPoint value);

Memberi umpan input pointer yang ditentukan ke PhysicalGestureRecognizer untuk pengenalan gerakan.

Penyelesaian

void CompleteGesture();

Menyelesaikan interaksi saat ini sehingga input berikutnya diperlakukan sebagai gerakan baru. Jika gerakan saat ini sedang berlangsung, peristiwa untuk penyelesaiannya akan dipicu.

Events

ManipulasiDimulai

event Windows.Foundation.TypedEventHandler<
    PhysicalGestureRecognizer,
    Windows.UI.Input.ManipulationStartedEventArgs> ManipulationStarted;

Dipicu ketika PhysicalGestureRecognizer mulai mengenali manipulasi.

ManipulationUpdated

event Windows.Foundation.TypedEventHandler<
    PhysicalGestureRecognizer,
    Windows.UI.Input.ManipulationUpdatedEventArgs> ManipulationUpdated;

Dipicu ketika PhysicalGestureRecognizer menerima input yang diperbarui selama manipulasi.

ManipulationCompleted

event Windows.Foundation.TypedEventHandler<
    PhysicalGestureRecognizer,
    Windows.UI.Input.ManipulationCompletedEventArgs> ManipulationCompleted;

Dipicu ketika PhysicalGestureRecognizer selesai mengenali manipulasi.

Mengetuk

event Windows.Foundation.TypedEventHandler<
    PhysicalGestureRecognizer,
    Windows.UI.Input.TappedEventArgs> Tapped;

Dipicu saat PhysicalGestureRecognizer mengenali ketukan.

Holding

event Windows.Foundation.TypedEventHandler<
    PhysicalGestureRecognizer,
    Windows.UI.Input.HoldingEventArgs> Holding;

Dipicu ketika PhysicalGestureRecognizer mengenali gerakan penangguhan.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 11
Namespace Windows. UI. Input
Kontrak API Windows. Foundation.UniversalApiContract (versi 19)
IID IPhysicalGestureRecognizer: 79a29f4d-32a6-5aa5-a999-42b0b420c66d

Baca juga

  • Last updated on