LightSensor.GetCurrentReading Metodo

Definizione

Spazio dei nomi:

Windows.Devices.Sensors

Ottiene la lettura corrente del sensore di luce ambientale.

public:
 virtual LightSensorReading ^ GetCurrentReading() = GetCurrentReading;

LightSensorReading GetCurrentReading();

public LightSensorReading GetCurrentReading();

function getCurrentReading()

Public Function GetCurrentReading () As LightSensorReading

Restituisce

LightSensorReading

Lettura corrente del sensore di luce ambientale.

Esempio

Nell'esempio seguente viene illustrato come un'app UWP compilata con XAML e C# recupera la lettura corrente per il sensore di luce predefinito.

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);
    }
}

Commenti

Un'applicazione può usare questo metodo per eseguire il polling del sensore per la lettura corrente come alternativa alla registrazione di un gestore eventi ReadingChanged . Si tratta dell'alternativa preferita per un'applicazione che aggiorna l'interfaccia utente a una frequenza di frame specifica. Indipendentemente dal polling una o più volte, l'applicazione deve stabilire un reportInterval desiderato. In questo modo viene informato il driver del sensore che le risorse devono essere allocate per soddisfare le richieste di polling successive

Prima di usare il valore restituito da questo metodo, l'applicazione deve prima verificare che il valore non sia Null. Se il valore è Null e si tenta di recuperarlo, Windows genererà un'eccezione.