View.RequestPointerCapture Método

[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

RegisterAttribute

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

<los eventos li>de otros tipos de dispositivos, como pantallas táctiles, no se verán afectados.</li></ul>

Cuando se pueden volver a configurar los cambios de captura del puntero, los dispositivos conectados del mouse y el controlador de seguimiento, y sus propiedades (como sus orígenes o intervalos de movimiento) pueden cambiar. Use para android.hardware.input.InputManager.InputDeviceListener 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ón InputDevice.

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.

Java documentación para android.view.View.requestPointerCapture().

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.

[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

Parámetros

Atributos

RegisterAttribute

Comentarios

Solicita la captura del puntero en el modo especificado.

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 maneras siguientes: Los eventos de un mouse se entregarán con el InputDevice.SOURCE_MOUSE_RELATIVE de origen y los cambios de posición relativa estarán disponibles a través de MotionEvent.getX y MotionEvent.getY; Los eventos de un panel táctil (también conocido como trackpad) se entregarán según el modo de captura del puntero elegido. Consulte POINTER_CAPTURE_MODE_RELATIVE y POINTER_CAPTURE_MODE_ABSOLUTE para obtener más información; Los eventos de otros tipos de dispositivos, como pantallas táctiles, no se verán afectados.

Las curvas balísticas de puntero y la configuración de velocidad del puntero del usuario no se aplicarán en este modo.

Cuando se pueden volver a configurar los cambios de captura del puntero, los dispositivos conectados del mouse y el panel táctil, y sus propiedades (como sus orígenes o intervalos de movimiento) pueden cambiar. Use un inputManager.InputDeviceListener para recibir una notificación cuando un dispositivo cambie (lo que puede ocurrir después de habilitar o deshabilitar la captura del puntero) y use InputDevice.getDevice(int) para obtener el inputDevice actualizado.

Los eventos capturados a través de la captura de puntero se enviarán a OnCapturedPointerListener.onCapturedPointer(View,MotionEvent) si se establece onCapturedPointerListener y, de lo contrario, en onCapturedPointerEvent(MotionEvent).

Si la ventana ya tiene captura de puntero en el mismo modo, esta llamada no hace nada. Si ya tiene captura de puntero en un modo diferente, pasará al nuevo modo.

La captura se puede liberar a través de releasePointerCapture() o se perderá automáticamente cuando la ventana pierda el foco.

Referencia de Android para android.view.View.requestPointerCapture.

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.