View.RequestPointerCapture Méthode

[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

Attributs

RegisterAttribute

Remarques

Demande le mode de capture de pointeur.

Lorsque la fenêtre a une capture de pointeur, l’icône pointeur de la souris disparaît et ne modifie pas sa position. L’activation de la capture de pointeur modifie le comportement des appareils d’entrée de la manière suivante : <ul><li>Events from a mouse will be remise with the source InputDevice#SOURCE_MOUSE_RELATIVE, and relative position changes will be available through MotionEvent#getX and MotionEvent#getY.</li>

<Li>Events from a touchpad or trackpad will be remise with the source InputDevice#SOURCE_TOUCHPAD, where the absolute position of each the pointers on the touchpad will be available through MotionEvent#getX(int) and , and MotionEvent#getY(int)their relative movements are stored in MotionEvent#AXIS_RELATIVE_X and MotionEvent#AXIS_RELATIVE_Y.</li>

<li>Événements provenant d’autres types d’appareils, tels que les écrans tactiles, ne seront pas affectés.</li></ul>

Lorsque le pointeur capture les modifications, les appareils de souris et de pavé tactile connectés peuvent être reconfigurés, et leurs propriétés (telles que leurs sources ou plages de mouvement) peuvent changer. Utilisez une android.hardware.input.InputManager.InputDeviceListener notification pour être averti lorsqu’un appareil change (qui peut se produire après l’activation ou la désactivation de la capture de pointeur) et pour InputDevice#getDevice(int) obtenir la mise à jour InputDevice.

Les événements capturés par le biais de la capture de pointeur sont distribués si OnCapturedPointerListener#onCapturedPointer(View, MotionEvent) un OnCapturedPointerListener élément est défini et dans le cas contraire #onCapturedPointerEvent(MotionEvent).

Si la fenêtre a déjà une capture de pointeur, cet appel ne fait rien.

La capture peut être libérée par le biais #releasePointerCapture()ou sera perdue automatiquement lorsque la fenêtre perd le focus.

Java documentation pour android.view.View.requestPointerCapture().

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.