Accelerometer.GetCurrentReading Methode

  • Referenz

Definition

Namespace:
Windows.Devices.Sensors
Bearbeiten

Ruft den aktuellen Beschleunigungsmesser-Wert ab.

public:
 virtual AccelerometerReading ^ GetCurrentReading() = GetCurrentReading;
AccelerometerReading GetCurrentReading();
public AccelerometerReading GetCurrentReading();
function getCurrentReading()
Public Function GetCurrentReading () As AccelerometerReading

Gibt zurück

AccelerometerReading

Diese Methode hat keine Parameter.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie eine mit XAML und C# erstellte UWP-App den aktuellen Wert für die drei Achsen des Standard-Beschleunigungsmessers abruft.

private void DisplayCurrentReading(object sender, object args)
{
    AccelerometerReading reading = _accelerometer.GetCurrentReading();
    if (reading != null)
    {
        ScenarioOutput_X.Text = String.Format("{0,5:0.00}", reading.AccelerationX);
        ScenarioOutput_Y.Text = String.Format("{0,5:0.00}", reading.AccelerationY);
        ScenarioOutput_Z.Text = String.Format("{0,5:0.00}", reading.AccelerationZ);
    }
}

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.

Wenn der Sensor für die Unterstützung der Batchübermittlung konfiguriert ist, löscht diese Methode den aktuellen Batch und startet einen neuen Latenzzeitraum. Weitere Informationen zum Batching von Sensoren finden Sie unter Sensoren.

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

Gilt für:

Weitere Informationen