View.RequestPointerCapture Methode

Definition

Namespace:: Android.Views

Assembly:: Mono.Android.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Überlädt

Name	Beschreibung
RequestPointerCapture()	Fordert den Zeigererfassungsmodus an.
RequestPointerCapture(Int32)	Fordert die Zeigererfassung im angegebenen Modus an.

RequestPointerCapture()

Fordert den Zeigererfassungsmodus an.

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

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

Gilt für:

RequestPointerCapture(Int32)

Fordert die Zeigererfassung im angegebenen Modus an.

[Android.Runtime.Register("requestPointerCapture", "(I)V", "GetRequestPointerCapture_IHandler", ApiSince=37)]
public virtual void RequestPointerCapture(int mode);

[<Android.Runtime.Register("requestPointerCapture", "(I)V", "GetRequestPointerCapture_IHandler", ApiSince=37)>]
abstract member RequestPointerCapture : int -> unit
override this.RequestPointerCapture : int -> unit

Parameter

mode: Int32

Der Modus, in dem der Zeiger erfasst werden soll, der bestimmt, wie Ereignisse von Touchpads übermittelt werden. Der Wert ist einer der folgenden: POINTER_CAPTURE_MODE_UNCAPTURED; POINTER_CAPTURE_MODE_ABSOLUTE; POINTER_CAPTURE_MODE_RELATIVE

Attribute: RegisterAttribute

Hinweise

Fordert die Zeigererfassung im angegebenen Modus 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: Ereignisse von einer Maus werden mit der Quelle InputDevice.SOURCE_MOUSE_RELATIVE übermittelt, und relative Positionsänderungen stehen über MotionEvent.getX und MotionEvent.getY zur Verfügung; Ereignisse von einem Touchpad (auch als Trackpad bezeichnet) werden gemäß dem ausgewählten Zeigeraufnahmemodus übermittelt. Einzelheiten finden Sie unter POINTER_CAPTURE_MODE_RELATIVE und POINTER_CAPTURE_MODE_ABSOLUTE; Ereignisse anderer Gerätetypen, z. B. Touchscreens, sind nicht betroffen.

Zeigerballistikkurven und die Zeigergeschwindigkeitseinstellungen des Benutzers werden in diesem Modus nicht angewendet.

Wenn sich die Zeigeraufnahme ändert, können verbundene Maus- und Touchpadgeräte neu konfiguriert werden, und ihre Eigenschaften (z. B. ihre Quellen oder Bewegungsbereiche) können sich ändern. Verwenden Sie einen InputManager.InputDeviceListener, 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), um die aktualisierte InputDevice abzurufen.

Ereignisse, die über die Zeigererfassung erfasst werden, werden an OnCapturedPointerListener.onCapturedPointer(View,MotionEvent) gesendet, wenn ein OnCapturedPointerListener festgelegt ist und andernfalls onCapturedPointerEvent(MotionEvent).

Wenn das Fenster bereits Zeigererfassung im selben Modus hat, führt dieser Aufruf nichts aus. Wenn der Zeiger bereits in einem anderen Modus erfasst wird, wechselt er in den neuen Modus.

Die Aufnahme kann über releasePointerCapture() freigegeben werden oder automatisch verloren gehen, wenn das Fenster den Fokus verliert.

Android-Referenz für android.view.View.requestPointerCapture.

Gilt für: