GetCurrentReading | getCurrentReading - Methode

Compass.GetCurrentReading | getCurrentReading Method

Ruft den aktuellen Messwerte des Kompasses ab.

Syntax


var compassReading = compass.getCurrentReading();

Parameter

Methode besitzt keine Parameter.

Rückgabewert

Typ: CompassReading

Der aktuelle Kompassmesswert.

Hinweise

Eine Anwendung kann diese Methode verwenden, um den Sensor für den aktuellen Wert als Alternative zur Registrierung eines ReadingChanged-Ereignishandlers abzurufen. Dies wäre die bevorzugte Alternative für eine Anwendung, dessen Benutzeroberfläche zu bestimmten Frameraten aktualisiert wird. Die Anwendung muss ein gewünschtes ReportInterval einrichten, ganz gleich, ob einmal oder mehrmals abgerufen wird. Dies informiert den Sensortreiber darüber, dass Ressourcen zugeordnet werden sollten, um nachfolgende Abrufanforderungen zu erfüllen

Der zurückgegebene Wert ist ein in Grad angegebene Kompasskurs.

Die Genauigkeit dieses Werts ist von den Funktionen des Kompasses abhängig.

Vor der Verwendung des Rückgabewerts dieser Methode muss die Anwendung zunächst prüfen, ob der Wert nicht NULL ist. (Wenn der Wert NULL ist und Sie versuchen, ihn abzurufen, wird eine Ausnahme generiert.)

Das folgende Beispiel zeigt, wie eine mit XAML und C# erstellte Windows Store-App die aktuelle Überschrift für den standardmäßigen Kompass abruft.


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


Das folgende Beispiel zeigt, wie eine mit JavaScript erstellte Windows Store-App für Windows die aktuelle Überschrift für den standardmäßigen Kompass abruft.


function getCurrentReading() {
    var reading = compass.getCurrentReading();
    if (reading) {
        document.getElementById("readingOutputMagneticNorth").innerHTML = reading.headingMagneticNorth.toFixed(2);
        if (reading.headingTrueNorth) {
            document.getElementById("readingOutputTrueNorth").innerHTML = reading.headingTrueNorth.toFixed(2);
        } else {
            document.getElementById("readingOutputTrueNorth").innerHTML = "no data";
        }
    }
}


Anforderungen

Mindestens unterstützter Client

Windows 8

Mindestens unterstützter Server

Keine unterstützt

Mindestens unterstütztes Telefon

Windows Phone 8

Namespace

Windows.Devices.Sensors
Windows::Devices::Sensors [C++]

Metadaten

Windows.winmd

Siehe auch

Compass

 

 

Anzeigen:
© 2017 Microsoft