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 事件處理常式。 這是以特定畫面播放速率更新其使用者介面之應用程式的慣用替代方案。 無論輪詢一次或多次，應用程式都必須建立所需的 ReportInterval。 這會通知感應器驅動程式應該配置資源以滿足後續輪詢要求

使用此方法的傳回值之前，應用程式必須先檢查該值不是 Null。 (如果值為 null 且您嘗試擷取該值，Windows 將會產生 exception.)