Compass.GetCurrentReading Metodo

Definizione

Spazio dei nomi:

Windows.Devices.Sensors

Ottiene la lettura corrente della bussola.

public:
 virtual CompassReading ^ GetCurrentReading() = GetCurrentReading;

CompassReading GetCurrentReading();

public CompassReading GetCurrentReading();

function getCurrentReading()

Public Function GetCurrentReading () As CompassReading

Restituisce

CompassReading

La lettura corrente della bussola.

Esempio

L'esempio seguente illustra come un'app UWP compilata con XAML e C# recupera l'intestazione corrente per la bussola predefinita.

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

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 fotogrammi specifica. Indipendentemente dal fatto che il polling venga eseguito una o più volte, l'applicazione deve stabilire un reportInterval desiderato. In questo modo il driver del sensore informa che le risorse devono essere allocate per soddisfare le richieste di polling successive

Il valore restituito è un titolo magnetico specificato in gradi.

L'accuratezza di questo valore dipende dalle funzionalità della bussola.

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.