View.RequestPointerCapture 메서드

정의

네임스페이스:: Android.Views

어셈블리:: Mono.Android.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

오버로드

속성	Description
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#getXMotionEvent#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()해제되거나 창에 포커스가 끊어지면 자동으로 손실될 수 있습니다.

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

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

적용 대상

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.getDevice(int)를 사용하여 업데이트된 InputDevice를 가져옵니다.

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

창에 동일한 모드의 포인터 캡처가 이미 있는 경우 이 호출은 아무 작업도 수행하지 않습니다. 이미 다른 모드에서 포인터 캡처가 있는 경우 새 모드로 전환됩니다.

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

에 대한 android.view.View.requestPointerCaptureAndroid 참조

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

적용 대상