Inclinometer.GetCurrentReading メソッド

定義

名前空間:

Windows.Devices.Sensors

現在の傾斜計の読み取り値を取得します。

public:
 virtual InclinometerReading ^ GetCurrentReading() = GetCurrentReading;

InclinometerReading GetCurrentReading();

public InclinometerReading GetCurrentReading();

function getCurrentReading()

Public Function GetCurrentReading () As InclinometerReading

戻り値

InclinometerReading

現在の傾斜計の読み取り。

例

次の例では、XAML と C# を使用して構築された UWP アプリが既定の傾斜計の現在の読み取り値を取得する方法を示します。

private void DisplayCurrentReading(object sender, object args)
{
    InclinometerReading reading = _inclinometer.GetCurrentReading();
    if (reading != null)
    {
        ScenarioOutput_X.Text = String.Format("{0,5:0.00}", reading.PitchDegrees);
        ScenarioOutput_Y.Text = String.Format("{0,5:0.00}", reading.RollDegrees);
        ScenarioOutput_Z.Text = String.Format("{0,5:0.00}", reading.YawDegrees);
    }
}

注釈

アプリケーションでは、このメソッドを使用して、 ReadingChanged イベント ハンドラーを登録する代わりに、現在の読み取り用のセンサーをポーリングできます。 これは、特定のフレーム レートでユーザー インターフェイスを更新するアプリケーションの推奨される代替手段です。 ポーリングが 1 回か複数回かにかかわらず、アプリケーションは目的の ReportInterval を確立する必要があります。 これにより、後続のポーリング要求を満たすためにリソースを割り当てる必要があることをセンサー ドライバーに通知します

このメソッドの戻り値を使用する前に、アプリケーションは最初に値が null ではないことをチェックする必要があります。 (値が null で取得しようとすると、Windows によって例外が生成されます)。