View.RequestPointerCapture Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Solicita el modo de captura del puntero.
[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
- Atributos
Comentarios
Solicita el modo de captura del puntero.
Cuando la ventana tiene captura de puntero, el icono del puntero del mouse desaparecerá y no cambiará su posición. La habilitación de la captura de puntero cambiará el comportamiento de los dispositivos de entrada de las siguientes maneras: <ul><li>Events from a mouse will be delivered with the source InputDevice#SOURCE_MOUSE_RELATIVE
y relative position changes will be available through MotionEvent#getX
y MotionEvent#getY
.</Li>
<li>Events from a touchpad or trackpad will be delivered with the source InputDevice#SOURCE_TOUCHPAD
, where the absolute position of each of the pointers on the touchpad will be available through MotionEvent#getX(int)
y MotionEvent#getY(int)
, and their relative movements are stored in MotionEvent#AXIS_RELATIVE_X
and MotionEvent#AXIS_RELATIVE_Y
.</Li>
<li>Eventos de otros tipos de dispositivos, como pantallas táctiles, no se verán afectados.</li></ul>
Cuando el puntero captura los cambios, los dispositivos conectados con mouse y trackpad pueden volver a configurarse y sus propiedades (como sus orígenes o intervalos de movimiento) pueden cambiar. android.hardware.input.InputManager.InputDeviceListener
Use para recibir una notificación cuando un dispositivo cambie (lo que puede ocurrir después de habilitar o deshabilitar la captura de puntero) y use InputDevice#getDevice(int)
para obtener la actualizaciónInputDevice
.
Los eventos capturados a través de la captura de puntero se enviarán a OnCapturedPointerListener#onCapturedPointer(View, MotionEvent)
si se establece y OnCapturedPointerListener
, de lo contrario, a #onCapturedPointerEvent(MotionEvent)
.
Si la ventana ya tiene captura de puntero, esta llamada no hace nada.
La captura se puede liberar a través #releasePointerCapture()
de o se perderá automáticamente cuando la ventana pierda el foco.
Documentación de Java para android.view.View.requestPointerCapture()
.
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código Project y que se usan según los términos Creative Commons 2.5 Attribution License.