View.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
특성

설명

포인터 캡처 모드를 요청합니다.

창에 포인터 캡처가 있으면 마우스 포인터 아이콘이 사라지고 위치가 변경되지 않습니다. 포인터 캡처를 사용하도록 설정하면 다음과 같은 방법으로 <입력 디바이스의 동작이 변경됩니다. 마우스의 ul><li>이벤트는 원본InputDevice#SOURCE_MOUSE_RELATIVE과 함께 전달되고 상대 위치 변경 내용은 및 MotionEvent#getY을 통해 MotionEvent#getX 사용할 수 있습니다.</리튬>

<li>터치 패드 또는 트랙 패드의 이벤트는 소스 InputDevice#SOURCE_TOUCHPAD와 함께 전달됩니다. 여기서 터치 패드의 각 포인터의 절대 위치는 및 를 MotionEvent#getY(int)통해 MotionEvent#getX(int) 사용할 수 있으며 상대 움직임은 및 MotionEvent#AXIS_RELATIVE_YMotionEvent#AXIS_RELATIVE_X 저장됩니다.</리튬>

<li>터치 스크린과 같은 다른 유형의 디바이스의 이벤트는 영향을 받지 않습니다.</li></ul>

포인터 캡처가 변경되면 연결된 마우스 및 트랙패드 디바이스를 다시 구성할 수 있으며 해당 속성(예: 원본 또는 동작 범위)이 변경될 수 있습니다. android.hardware.input.InputManager.InputDeviceListener 를 사용하여 디바이스가 변경될 때(포인터 캡처를 사용하거나 사용하지 않도록 설정한 후 발생할 수 있음) 알림을 받고 를 사용하여 InputDevice#getDevice(int) 업데이트InputDevice된 를 가져옵니다.

포인터 캡처를 통해 캡처된 이벤트는 가 설정된 경우 OnCapturedPointerListenerOnCapturedPointerListener#onCapturedPointer(View, MotionEvent) 디스패치되고, 그렇지 않으면 로 #onCapturedPointerEvent(MotionEvent)디스패치됩니다.

창에 이미 포인터 캡처가 있는 경우 이 호출은 아무 작업도 수행하지 않습니다.

캡처는 를 통해 #releasePointerCapture()해제되거나 창에 포커스가 끊어지면 자동으로 손실됩니다.

에 대한 Java 설명서입니다 android.view.View.requestPointerCapture().

이 페이지의 일부는 만들고 공유하며 에 설명된 용어에 따라 사용되는 작업을 기반으로 수정됩니다.

적용 대상