ViewConfiguration.GetScaledMinimumFlingVelocity(Int32, Axis, Int32) メソッド

定義

名前空間:: Android.Views

アセンブリ:: Mono.Android.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

入力sourceおよび特定のモーションイベントaxisから、inputDeviceIdの ID を持つInputDeviceによって生成されたモーションのフリングを開始する速度の最小値。

[Android.Runtime.Register("getScaledMinimumFlingVelocity", "(III)I", "GetGetScaledMinimumFlingVelocity_IIIHandler", ApiSince=34)]
public virtual int GetScaledMinimumFlingVelocity(int inputDeviceId, Android.Views.Axis axis, int source);

[<Android.Runtime.Register("getScaledMinimumFlingVelocity", "(III)I", "GetGetScaledMinimumFlingVelocity_IIIHandler", ApiSince=34)>]
abstract member GetScaledMinimumFlingVelocity : int * Android.Views.Axis * int -> int
override this.GetScaledMinimumFlingVelocity : int * Android.Views.Axis * int -> int

パラメーター

inputDeviceId: Int32

フリングをトリガーするモーションを生成した InputDevice の ID。

axis: Axis

フリングをトリガーするモーションが発生した軸。この軸は、指定された入力デバイスソースから指定された入力デバイスによって報告できる有効な軸である必要があります。

source: Int32

フリングを引き起こすモーションの入力ソース。このソースは、ID がinputDeviceIdInputDeviceの有効なソースである必要があります。

返品

Int32

フリングをトリガーする最小速度 (ピクセル/秒)。

属性: RegisterAttribute

注釈

この方法を利用して、入力デバイスによって生成されたモーションの最小フレー速度を取得する前に、入力デバイスによって生成されたモーションイベントの速度をピクセル/秒にスケーリングします。

たとえば、InputDevice#SOURCE_ROTARY_ENCODERから生成された垂直速度MotionEvent#AXIS_SCROLL追跡した場合、VelocityTrackerから返される速度は、モーションイベントで軸の値が報告された単位になります。この速度をここで指定した最小フレー速度と比較する前に、トラッカーからの MotionEvent#AXIS_SCROLL 速度が "秒あたりの単位" で計算されていることを確認します (速度計算を "1 秒あたり" に調整するには、 VelocityTracker#computeCurrentVelocity(int)、 VelocityTracker#computeCurrentVelocity(int, float) を参照)、 #getScaledVerticalScrollFactor を使用してこの速度値を "ピクセル/秒" に変更します。

指定された inputDeviceId が無効な場合、または ID が指定された入力デバイスが指定されたモーションイベントソースや軸をサポートしていない場合、このメソッドは Integer.MAX_VALUEを返します。

<h3>このメソッド呼び出しの正しい引数を使用する</h3>

<b>inputDeviceId</b>: MotionEventに応答してこのメソッドを呼び出す場合は、 MotionEvent#getDeviceId()を使用して取得できるイベントによって報告されるデバイス ID を使用します。それ以外の場合は、 InputDevice#getId()または InputManager インスタンスから取得した有効な ID を使用します (InputManager#getInputDeviceIds() はすべての有効な入力デバイス ID を提供します)。

<b>axis</b>: MotionEvent は複数の軸のデータを報告でき、各軸は異なるポインターに対して複数のデータポイントを持つことができます。速度を取得した軸 (VelocityTracker を使用すると、特定の軸の速度を計算できます。速度を計算した軸を使用します)。 InputDevice#getMotionRanges()を使用して、InputDeviceのすべてのInputDevice.MotionRangeを取得し、そこからデバイスのすべての有効な軸を派生させることができます。

<b>source</b>: MotionEventに応答してこのメソッドを呼び出す場合は、MotionEvent#getSource()を使用します。それ以外の場合は、 InputDeviceの有効なソースを使用します。 InputDevice#getMotionRanges()を使用して、InputDeviceのすべてのInputDevice.MotionRangeを取得し、そこからデバイスのすべての有効なソースを派生させることができます。

このメソッドは、複数の入力デバイス ID に対する呼び出しを最適化するため、複数の入力デバイスを処理する場合は、メソッドの戻り値をキャッシュする必要はありません。

Javaドキュメント。

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

適用対象