LightSensor.GetCurrentReading メソッド

定義

名前空間:

Windows.Devices.Sensors

現在のアンビエント ライト センサーの読み取り値を取得します。

public:
 virtual LightSensorReading ^ GetCurrentReading() = GetCurrentReading;

LightSensorReading GetCurrentReading();

public LightSensorReading GetCurrentReading();

function getCurrentReading()

Public Function GetCurrentReading () As LightSensorReading

戻り値

LightSensorReading

現在の周囲光センサーの読み取り。

例

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

private void DisplayCurrentReading(object sender, object args)
{
    LightSensorReading reading = _sensor.GetCurrentReading();
    if (reading != null)
    {
        ScenarioOutput_LUX.Text = String.Format("{0,5:0.00}", reading.IlluminanceInLux);
    }
}

注釈

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

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