View.RequestPointerCapture Methode

[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

Attribute

RegisterAttribute

Hinweise

Fordert den Zeigererfassungsmodus an.

Wenn das Fenster Zeigeraufnahmen enthält, wird das Mauszeigersymbol ausgeblendet und ändert seine Position nicht. Das Aktivieren der Zeigererfassung ändert das Verhalten von Eingabegeräten auf folgende Weise: <ul><li-Ereignisse>von einer Maus werden mit der Quelle InputDevice#SOURCE_MOUSE_RELATIVEübermittelt, und relative Positionsänderungen sind über MotionEvent#getX und MotionEvent#getYverfügbar.</li>

<li>Events von einem Touchpad oder Trackpad werden mit der Quelle InputDevice#SOURCE_TOUCHPADgeliefert, wobei die absolute Position der einzelnen Zeiger auf dem Touchpad durch MotionEvent#getX(int) und , und MotionEvent#getY(int)ihre relativen Bewegungen gespeichert MotionEvent#AXIS_RELATIVE_XMotionEvent#AXIS_RELATIVE_Ywerden.</li>

<Li-Ereignisse>anderer Gerätetypen, z. B. Touchscreens, sind nicht betroffen.</li></ul>

Wenn sich die Zeigererfassung ändert, können verbundene Maus- und Trackpadgeräte neu konfiguriert werden, und ihre Eigenschaften (z. B. ihre Quellen oder Bewegungsbereiche) können sich ändern. Verwenden Sie eine android.hardware.input.InputManager.InputDeviceListener Benachrichtigung, um benachrichtigt zu werden, wenn sich ein Gerät ändert (was nach dem Aktivieren oder Deaktivieren der Zeigererfassung auftreten kann), und verwenden Sie InputDevice#getDevice(int) die Aktualisierung InputDevice.

Ereignisse, die über die Zeigererfassung erfasst werden, werden an den Festgelegten OnCapturedPointerListener#onCapturedPointer(View, MotionEvent) und OnCapturedPointerListener andernfalls an .#onCapturedPointerEvent(MotionEvent)

Wenn das Fenster bereits Zeigererfassung hat, führt dieser Aufruf nichts aus.

Die Aufnahme kann durch #releasePointerCapture()losgelassen werden oder wird automatisch verloren gehen, wenn das Fenster den Fokus verliert.

Java Dokumentation für android.view.View.requestPointerCapture().

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.