Compass.GetCurrentReading Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft den aktuellen Kompasswert ab.
public:
virtual CompassReading ^ GetCurrentReading() = GetCurrentReading;CompassReading GetCurrentReading();public CompassReading GetCurrentReading();function getCurrentReading()Public Function GetCurrentReading () As CompassReadingGibt zurück
Der aktuelle Kompasswert.
Beispiele
Im folgenden Beispiel wird veranschaulicht, wie eine mit XAML und C# erstellte UWP-App die aktuelle Überschrift für den Standardkompass 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";
}
}
}
Hinweise
Eine Anwendung kann diese Methode verwenden, um den Sensor für den aktuellen Lesevorgang abzufragen, als Alternative zum Registrieren eines ReadingChanged-Ereignishandlers . Dies wäre die bevorzugte Alternative für eine Anwendung, die ihre Benutzeroberfläche mit einer bestimmten Bildfrequenz aktualisiert. Unabhängig davon, ob sie einmal oder mehrmals abruft, muss die Anwendung einen gewünschten ReportInterval einrichten. Dadurch wird der Sensortreiber darüber informiert, dass Ressourcen zugewiesen werden sollten, um nachfolgende Abrufanforderungen zu erfüllen.
Der zurückgegebene Wert ist eine magnetische Überschrift, die in Grad angegeben ist.
Die Genauigkeit dieses Werts hängt von den Fähigkeiten des Kompasses ab.
Bevor Sie den Rückgabewert dieser Methode verwenden, muss die Anwendung zunächst überprüfen, ob der Wert nicht NULL ist. (Wenn der Wert NULL ist und Sie versuchen, ihn abzurufen, generiert Windows eine Ausnahme.)