Inclinometer.GetCurrentReading Methode

Definition

Namespace:

Windows.Devices.Sensors

Ruft den aktuellen Neigungsmesserwert ab.

public:
 virtual InclinometerReading ^ GetCurrentReading() = GetCurrentReading;

InclinometerReading GetCurrentReading();

public InclinometerReading GetCurrentReading();

function getCurrentReading()

Public Function GetCurrentReading () As InclinometerReading

Gibt zurück

InclinometerReading

Der aktuelle Neigungsmesser-Wert.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie eine mit XAML und C# erstellte UWP-App den aktuellen Wert für den Standardneigungsmesser abruft.

private void DisplayCurrentReading(object sender, object args)
{
    InclinometerReading reading = _inclinometer.GetCurrentReading();
    if (reading != null)
    {
        ScenarioOutput_X.Text = String.Format("{0,5:0.00}", reading.PitchDegrees);
        ScenarioOutput_Y.Text = String.Format("{0,5:0.00}", reading.RollDegrees);
        ScenarioOutput_Z.Text = String.Format("{0,5:0.00}", reading.YawDegrees);
    }
}

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 zugeordnet werden sollten, um nachfolgende Abrufanforderungen zu erfüllen.

Vor der Verwendung des Rückgabewerts aus dieser Methode 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.)