View.RequestPointerCapture Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Overload
| Nome | Descrizione |
|---|---|
| RequestPointerCapture() |
Richiede la modalità di acquisizione del puntatore. |
| RequestPointerCapture(Int32) |
Richiede l'acquisizione del puntatore nella modalità specificata. |
RequestPointerCapture()
Richiede la modalità di acquisizione del puntatore.
[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
- Attributi
Commenti
Richiede la modalità di acquisizione del puntatore.
Quando la finestra ha l'acquisizione del puntatore, l'icona del puntatore del mouse scomparirà e non cambierà la posizione. L'abilitazione dell'acquisizione del puntatore modificherà il comportamento dei dispositivi di input nei modi seguenti: <ul><li>Events from a mouse will be delivered 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 delivered with the source InputDevice#SOURCE_TOUCHPAD, where the absolute position of each of the pointer on the touchpad will be available through MotionEvent#getX(int) and MotionEvent#getY(int), and their relative movements are stored in MotionEvent#AXIS_RELATIVE_X and MotionEvent#AXIS_RELATIVE_Y.</li>
<gli eventi li>di altri tipi di dispositivi, ad esempio i touchscreen, non saranno interessati.</li></ul>
Quando il puntatore acquisisce modifiche, i dispositivi mouse e trackpad connessi possono essere riconfigurati e le relative proprietà (ad esempio le origini o gli intervalli di movimento) possono cambiare. Usare un android.hardware.input.InputManager.InputDeviceListener oggetto per ricevere una notifica quando un dispositivo cambia (che può verificarsi dopo l'abilitazione o la disabilitazione dell'acquisizione del puntatore) e usare InputDevice#getDevice(int) per ottenere l'aggiornamento InputDevice.
Gli eventi acquisiti tramite l'acquisizione del puntatore verranno inviati a OnCapturedPointerListener#onCapturedPointer(View, MotionEvent) se OnCapturedPointerListener è impostato un oggetto e in caso contrario a #onCapturedPointerEvent(MotionEvent).
Se la finestra dispone già dell'acquisizione del puntatore, questa chiamata non esegue alcuna operazione.
L'acquisizione può essere rilasciata tramite #releasePointerCapture()o verrà persa automaticamente quando la finestra perde lo stato attivo.
per android.view.View.requestPointerCapture().
Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.
Si applica a
RequestPointerCapture(Int32)
Richiede l'acquisizione del puntatore nella modalità specificata.
[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
Parametri
- mode
- Int32
Modalità in cui acquisire il puntatore, che determina il modo in cui vengono recapitati gli eventi dai touchpad. Il valore è uno dei seguenti: POINTER_CAPTURE_MODE_UNCAPTURED; POINTER_CAPTURE_MODE_ABSOLUTE; POINTER_CAPTURE_MODE_RELATIVE
- Attributi
Commenti
Richiede l'acquisizione del puntatore nella modalità specificata.
Quando la finestra ha l'acquisizione del puntatore, l'icona del puntatore del mouse scomparirà e non cambierà la posizione. L'abilitazione dell'acquisizione del puntatore modificherà il comportamento dei dispositivi di input nei modi seguenti: gli eventi da un mouse verranno recapitati con il InputDevice.SOURCE_MOUSE_RELATIVE di origine e le modifiche di posizione relative saranno disponibili tramite MotionEvent.getX e MotionEvent.getY; Gli eventi di un touchpad (noto anche come trackpad) verranno recapitati in base alla modalità di acquisizione del puntatore scelta. Per informazioni dettagliate, vedere POINTER_CAPTURE_MODE_RELATIVE e POINTER_CAPTURE_MODE_ABSOLUTE; Gli eventi di altri tipi di dispositivi, ad esempio touchscreen, non saranno interessati.
Le curve del puntatore e le impostazioni di velocità del puntatore dell'utente non verranno applicate in questa modalità.
Quando il puntatore acquisisce modifiche, i dispositivi mouse e touchpad connessi possono essere riconfigurati e le relative proprietà (ad esempio le origini o gli intervalli di movimento) possono cambiare. Usa inputManager.InputDeviceListener per ricevere una notifica quando un dispositivo cambia (che può verificarsi dopo l'abilitazione o la disabilitazione dell'acquisizione del puntatore) e usa InputDevice.getDevice(int) per ottenere il dispositivo InputDevice aggiornato.
Gli eventi acquisiti tramite l'acquisizione del puntatore verranno inviati a OnCapturedPointerListener.onCapturedPointer(View,MotionEvent) se è impostato un OnCapturedPointerListener e in caso contrario su onCapturedPointerEvent(MotionEvent).
Se la finestra dispone già dell'acquisizione del puntatore nella stessa modalità, questa chiamata non esegue alcuna operazione. Se ha già l'acquisizione del puntatore in una modalità diversa, passerà alla nuova modalità.
L'acquisizione può essere rilasciata tramite releasePointerCapture() o verrà persa automaticamente quando la finestra perde lo stato attivo.
Informazioni di riferimento su Android per android.view.View.requestPointerCapture.
Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.