Compass.GetCurrentReading Método

Definição

Namespace:

Windows.Devices.Sensors

Obtém a leitura da bússola atual.

public:
 virtual CompassReading ^ GetCurrentReading() = GetCurrentReading;

CompassReading GetCurrentReading();

public CompassReading GetCurrentReading();

function getCurrentReading()

Public Function GetCurrentReading () As CompassReading

Retornos

CompassReading

A leitura da bússola atual.

Exemplos

O exemplo a seguir demonstra como um aplicativo UWP criado com XAML e C# recupera o título atual para a bússola padrão.

private void DisplayCurrentReading(object sender, object args)
{
    CompassReading reading = _compass.GetCurrentReading();
    if (reading != null)
    {
        ScenarioOutput_MagneticNorth.Text = String.Format("{0,5:0.00}", reading.HeadingMagneticNorth);
        if (reading.HeadingTrueNorth != null)
        {
            ScenarioOutput_TrueNorth.Text = String.Format("{0,5:0.00}", reading.HeadingTrueNorth);
        }
        else
        {
            ScenarioOutput_TrueNorth.Text = "No data";
        }
    }
}

Comentários

Um aplicativo pode usar esse método para sondar o sensor para a leitura atual como uma alternativa para registrar 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

O valor retornado é um título magnético especificado em graus.

A precisão desse valor depende dos recursos da bússola.

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.)