View.RequestPointerCapture メソッド

定義

名前空間:

Android.Views

アセンブリ:

Mono.Android.dll

ポインター キャプチャ モードを要求します。

[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#getYを通じてMotionEvent#getX使用できます。</李>

<li>タッチパッドまたはトラックパッドからのイベントは、ソース InputDevice#SOURCE_TOUCHPADと共に配信されます。ここで、タッチパッド上の各ポインターの絶対位置は および MotionEvent#getY(int)を介してMotionEvent#getX(int)使用でき、それらの相対的な動きは および MotionEvent#AXIS_RELATIVE_YにMotionEvent#AXIS_RELATIVE_X格納されます。</李>

<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 ドキュメント。

このページの一部は、によって作成および共有された作業に基づく変更であり、に記載されている条件に従って使用されます。