View.RequestPointerCapture Método

Definição

Namespace:: Android.Views

Assembly:: Mono.Android.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Sobrecargas

Nome	Description
RequestPointerCapture()	Solicita o modo de captura de ponteiro.
RequestPointerCapture(Int32)	Solicita a captura de ponteiro no modo especificado.

RequestPointerCapture()

Solicita o modo de captura de ponteiro.

[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

Comentários

Solicita o modo de captura de ponteiro.

Quando a janela tiver a captura de ponteiro, o ícone de ponteiro do mouse desaparecerá e não alterará sua posição. Habilitar a captura de ponteiro alterará o comportamento dos dispositivos de entrada das seguintes maneiras: <ul><li>Eventos de um mouse serão entregues com a origem InputDevice#SOURCE_MOUSE_RELATIVE, e as alterações relativas de posição estarão disponíveis por meio MotionEvent#getX e MotionEvent#getY.</li>

< >li Eventos de um touchpad ou trackpad serão entregues com a origemInputDevice#SOURCE_TOUCHPAD, onde a posição absoluta de cada um dos ponteiros no touchpad estará disponível por meio MotionEvent#getX(int) eMotionEvent#getY(int), e seus movimentos relativos são armazenados em MotionEvent#AXIS_RELATIVE_X e MotionEvent#AXIS_RELATIVE_Y.</li>

<os eventos li>de outros tipos de dispositivos, como telas sensíveis ao toque, não serão afetados.</li></ul>

Quando a captura de ponteiro muda, os dispositivos de mouse e trackpad conectados podem ser reconfigurados e suas propriedades (como suas fontes ou intervalos de movimento) podem ser alteradas. Use um android.hardware.input.InputManager.InputDeviceListener para ser notificado quando um dispositivo for alterado (o que pode acontecer depois de habilitar ou desabilitar a captura de ponteiro) e usar InputDevice#getDevice(int) para obter a atualização InputDevice.

Os eventos capturados por meio da captura de ponteiro serão enviados para OnCapturedPointerListener#onCapturedPointer(View, MotionEvent) se um OnCapturedPointerListener estiver definido e, caso contrário, para #onCapturedPointerEvent(MotionEvent).

Se a janela já tiver captura de ponteiro, essa chamada não fará nada.

A captura pode ser liberada por meio #releasePointerCapture()ou será perdida automaticamente quando a janela perder o foco.

Documentação Java para android.view.View.requestPointerCapture().

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usadas de acordo com os termos descritos na Licença de Atribuição Creative Commons 2.5.

Aplica-se a

RequestPointerCapture(Int32)

Solicita a captura de ponteiro no modo especificado.

[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

mode: Int32

O modo no qual capturar o ponteiro, que determina como os eventos de touchpads são entregues. O valor é um dos seguintes: POINTER_CAPTURE_MODE_UNCAPTURED; POINTER_CAPTURE_MODE_ABSOLUTE; POINTER_CAPTURE_MODE_RELATIVE

Atributos: RegisterAttribute

Comentários

Solicita a captura de ponteiro no modo especificado.

Os eventos de um mouse serão entregues com o InputDevice.SOURCE_MOUSE_RELATIVE de origem e as alterações relativas de posição estarão disponíveis por meio de MotionEvent.getX e MotionEvent.getY.

Os eventos de um touchpad (também conhecido como trackpad) serão entregues de acordo com o modo de captura de ponteiro escolhido. Consulte POINTER_CAPTURE_MODE_RELATIVE e POINTER_CAPTURE_MODE_ABSOLUTE para obter detalhes.

Eventos de outros tipos de dispositivos, como telas sensíveis ao toque, não serão afetados.

As curvas de balística do ponteiro e as configurações de velocidade do ponteiro do usuário não serão aplicadas nesse modo.

Quando as alterações de captura de ponteiro, os dispositivos de mouse e touchpad conectados podem ser reconfigurados e suas propriedades (como suas fontes ou intervalos de movimento) podem ser alteradas. Use um InputManager.InputDeviceListener para ser notificado quando um dispositivo for alterado (o que pode acontecer depois de habilitar ou desabilitar a captura de ponteiro) e usar InputDevice.getDevice(int) para obter o InputDevice atualizado.

Os eventos capturados por meio da captura de ponteiro serão enviados para OnCapturedPointerListener.onCapturedPointer(View,MotionEvent) se um OnCapturedPointerListener estiver definido e, de outra forma, para onCapturedPointerEvent(MotionEvent).

Se a janela já tiver a captura de ponteiro no mesmo modo, essa chamada não fará nada. Se ele já tiver a captura de ponteiro em um modo diferente, ele fará a transição para o novo modo.

A captura pode ser liberada por meio do releasePointerCapture() ou será perdida automaticamente quando a janela perder o foco.

Referência do Android para android.view.View.requestPointerCapture.

Aplica-se a