View.RequestPointerCapture Methode
Definition
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.
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
Hinweise
Fordert den Zeigererfassungsmodus an.
Wenn das Fenster über eine Zeigererfassung verfügt, 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#getY
verfügbar.</Li>
<Li-Ereignisse>von einem Touchpad oder Trackpad werden mit der Quelle InputDevice#SOURCE_TOUCHPAD
übermittelt, wobei die absolute Position der einzelnen Zeiger auf dem Touchpad über MotionEvent#getX(int)
und MotionEvent#getY(int)
verfügbar ist und ihre relativen Bewegungen in MotionEvent#AXIS_RELATIVE_X
und MotionEvent#AXIS_RELATIVE_Y
gespeichert werden.</Li>
<Li-Ereignisse>von anderen Gerätetypen, z. B. Touchscreens, sind nicht betroffen.</li></ul>
Wenn der Zeiger Änderungen erfasst, können verbundene Maus- und Trackpadgeräte neu konfiguriert werden, und ihre Eigenschaften (z. B. quellen oder Bewegungsbereiche) können sich ändern. Verwenden Sie , android.hardware.input.InputManager.InputDeviceListener
um benachrichtigt zu werden, wenn sich ein Gerät ändert (dies kann nach dem Aktivieren oder Deaktivieren der Zeigererfassung geschehen), und verwenden Sie , InputDevice#getDevice(int)
um die aktualisierte InputDevice
abzurufen.
Ereignisse, die über zeiger capture erfasst werden, werden an OnCapturedPointerListener#onCapturedPointer(View, MotionEvent)
gesendet, wenn festgelegt OnCapturedPointerListener
ist, und andernfalls an #onCapturedPointerEvent(MotionEvent)
.
Wenn das Fenster bereits über die Zeigererfassung verfügt, bewirkt dieser Aufruf nichts.
Die Aufzeichnung wird möglicherweise über #releasePointerCapture()
freigegeben oder geht automatisch verloren, wenn das Fenster den Fokus verliert.
Java-Dokumentation für android.view.View.requestPointerCapture()
.
Teile dieser Seite sind Änderungen, die auf Arbeiten basieren, die vom Android Open Source Project erstellt und freigegeben wurden und gemäß den In Attribution License beschriebenen Begriffen verwendet werden.