View.RequestPointerCapture Metode

Definisi

Meminta mode pengambilan pointer.

[Android.Runtime.Register("requestPointerCapture", "()V", "GetRequestPointerCaptureHandler", ApiSince=26)]
public virtual void RequestPointerCapture();
[<Android.Runtime.Register("requestPointerCapture", "()V", "GetRequestPointerCaptureHandler", ApiSince=26)>]
abstract member RequestPointerCapture : unit -> unit
override this.RequestPointerCapture : unit -> unit
Atribut

Keterangan

Meminta mode pengambilan pointer.

Ketika jendela memiliki pengambilan penunjuk, ikon penunjuk mouse akan hilang dan tidak akan mengubah posisinya. Mengaktifkan penangkapan pointer akan mengubah perilaku perangkat input dengan cara berikut: <Peristiwa ul><li>dari mouse akan dikirimkan dengan sumber InputDevice#SOURCE_MOUSE_RELATIVE, dan perubahan posisi relatif akan tersedia melalui MotionEvent#getX dan .MotionEvent#getY</li>

<Peristiwa li>dari touchpad atau trackpad akan dikirimkan dengan sumber InputDevice#SOURCE_TOUCHPAD, di mana posisi absolut masing-masing pointer di touchpad akan tersedia melalui MotionEvent#getX(int) dan MotionEvent#getY(int), dan gerakan relatif mereka disimpan di MotionEvent#AXIS_RELATIVE_X dan MotionEvent#AXIS_RELATIVE_Y.</li>

<li>Peristiwa dari jenis perangkat lain, seperti layar sentuh, tidak akan terpengaruh.</li></ul>

Saat penunjuk mengambil perubahan, perangkat mouse dan trackpad yang terhubung dapat dikonfigurasi ulang, dan propertinya (seperti sumber atau rentang gerakannya) dapat berubah. android.hardware.input.InputManager.InputDeviceListener Gunakan untuk diberi tahu ketika perangkat berubah (yang mungkin terjadi setelah mengaktifkan atau menonaktifkan pengambilan pointer), dan gunakan InputDevice#getDevice(int) untuk mendapatkan pembaruan InputDevice.

Peristiwa yang diambil melalui pengambilan pointer akan dikirim ke OnCapturedPointerListener#onCapturedPointer(View, MotionEvent) jika OnCapturedPointerListener diatur, dan sebaliknya ke #onCapturedPointerEvent(MotionEvent).

Jika jendela sudah memiliki pengambilan pointer, panggilan ini tidak melakukan apa-apa.

Pengambilan dapat dilepaskan melalui #releasePointerCapture(), atau akan hilang secara otomatis ketika jendela kehilangan fokus.

Java dokumentasi untuk android.view.View.requestPointerCapture().

Bagian dari halaman ini adalah modifikasi berdasarkan pekerjaan yang dibuat dan dibagikan oleh Android Open Source Project dan digunakan sesuai dengan istilah yang dijelaskan dalam Lisensi Creative Commons 2.5 Lisensi Atribusi.

Berlaku untuk