LightSensor.GetCurrentReading Método

Definição

Namespace:

Windows.Devices.Sensors

Obtém a leitura atual do sensor de luz ambiente.

public:
 virtual LightSensorReading ^ GetCurrentReading() = GetCurrentReading;

LightSensorReading GetCurrentReading();

public LightSensorReading GetCurrentReading();

function getCurrentReading()

Public Function GetCurrentReading () As LightSensorReading

Retornos

LightSensorReading

A leitura atual do sensor de luz ambiente.

Exemplos

O exemplo a seguir demonstra como um aplicativo UWP criado com XAML e C# recupera a leitura atual do sensor de luz padrão.

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

Comentários

Um aplicativo pode usar esse método para sondar o sensor para a leitura atual como uma alternativa ao registro de um manipulador de eventos ReadingChanged . Essa seria a alternativa preferencial para um aplicativo que atualiza sua interface do usuário a uma taxa de quadros específica. Seja sondando uma ou muitas vezes, o aplicativo deve estabelecer um ReportInterval desejado. Isso informa ao driver do sensor que os recursos devem ser alocados para atender às solicitações de sondagem subsequentes

Antes de usar o valor retornado desse método, o aplicativo deve primeiro marcar que o valor não é nulo. (Se o valor for nulo e você tentar recuperá-lo, o Windows gerará uma exceção.)