Язык

View.RequestPointerCapture Метод

Определение

Пространство имен:
Android.Views
Сборка:
Mono.Android.dll

Перегрузки

Имя. Описание
RequestPointerCapture()

Запрашивает режим записи указателя.
RequestPointerCapture(Int32)

Запрашивает запись указателя в указанном режиме.

RequestPointerCapture()

Запрашивает режим записи указателя.

[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
Атрибуты
RegisterAttribute

Комментарии

Запрашивает режим записи указателя.

Когда окно имеет запись указателя, значок указателя мыши исчезнет и не изменит его положение. Включение записи указателя изменит поведение устройств ввода следующим образом: <события ul><li>от мыши будут доставлены с источникомInputDevice#SOURCE_MOUSE_RELATIVE, а относительные изменения позиции будут доступны через MotionEvent#getX и.MotionEvent#getY</li>

<События li>с сенсорной панели или трек-панели будут доставлены с источником InputDevice#SOURCE_TOUCHPAD, где абсолютная позиция каждого указателя на сенсорной панели будет доступна через MotionEvent#getX(int) и MotionEvent#getY(int), и их относительные движения хранятся в MotionEvent#AXIS_RELATIVE_X и MotionEvent#AXIS_RELATIVE_Y.</li>

<События li>от других типов устройств, таких как сенсорные экраны, не будут затронуты.</li></ul>

При изменении записи указателя подключенные устройства мыши и трекпада могут быть перенастроены, а их свойства (например, источники или диапазоны движения) могут измениться. android.hardware.input.InputManager.InputDeviceListener Используйте уведомление при изменении устройства (которое может произойти после включения или отключения записи указателя) и использования InputDevice#getDevice(int) для получения обновленияInputDevice.

События, захваченные с помощью записи указателя, будут отправляться OnCapturedPointerListener#onCapturedPointer(View, MotionEvent) в том случае, если задано OnCapturedPointerListener значение, а в противном случае — в #onCapturedPointerEvent(MotionEvent).

Если в окне уже есть запись указателя, этот вызов ничего не делает.

Запись может быть выпущена #releasePointerCapture()через или будет потеряна автоматически, когда окно теряет фокус.

Java документации по android.view.View.requestPointerCapture().

Части этой страницы — это изменения на основе работы, созданной и общей Project и используемых в соответствии с условиями, описанными в разделе "".

Применяется к

RequestPointerCapture(Int32)

Запрашивает запись указателя в указанном режиме.

[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

Параметры

mode
Int32

Режим, в котором нужно записать указатель, который определяет способ доставки событий с сенсорной панели. Значение является одним из следующих значений: POINTER_CAPTURE_MODE_UNCAPTURED; POINTER_CAPTURE_MODE_ABSOLUTE; POINTER_CAPTURE_MODE_RELATIVE

Атрибуты
RegisterAttribute

Комментарии

Запрашивает запись указателя в указанном режиме.

Когда окно имеет запись указателя, значок указателя мыши исчезнет и не изменит его положение. Включение записи указателя изменит поведение устройств ввода следующим образом: события с мыши будут доставлены с помощью исходного InputDevice.SOURCE_MOUSE_RELATIVE, а относительные изменения позиции будут доступны через MotionEvent.getX и MotionEvent.getY; События с сенсорной панели (также известной как трекпад) будут доставлены в соответствии с выбранным режимом захвата указателя. Дополнительные сведения см. в POINTER_CAPTURE_MODE_RELATIVE и POINTER_CAPTURE_MODE_ABSOLUTE; События других типов устройств, таких как сенсорные экраны, не будут затронуты.

Кривые баллистических указателей и параметры скорости указателя пользователя не будут применяться в этом режиме.

При изменении записи указателя подключенные устройства мыши и сенсорной панели могут быть перенастроены, а их свойства (например, источники или диапазоны движения) могут измениться. Используйте InputManager.InputDeviceListener, чтобы получать обновленные данные InputDevice(int) при изменении устройства (что может произойти после включения или отключения записи указателя) и используйте inputDevice.getDevice(int).

События, захваченные с помощью записи указателя, будут отправлены в OnCapturedPointerListener.onCapturedPointer(View,MotionEvent), если задан параметр OnCapturedPointerListener, а в противном случае — onCapturedPointerEvent(MotionEvent).

Если в окне уже есть запись указателя в том же режиме, этот вызов ничего не делает. Если у него уже есть запись указателя в другом режиме, он перейдет в новый режим.

Запись может быть выпущена через releasePointerCapture(), или будет потеряна автоматически, когда окно теряет фокус.

Справочник по Android для android.view.View.requestPointerCapture.

Части этой страницы — это изменения на основе работы, созданной и общей Project и используемых в соответствии с условиями, описанными в разделе "".

Применяется к