Gyrometer.ReadingChanged Event

Definition

Namespace:

Windows.Devices.Sensors

Occurs each time the gyrometer reports the current sensor reading.

// Register
event_token ReadingChanged(TypedEventHandler<Gyrometer, GyrometerReadingChangedEventArgs const&> const& handler) const;

// Revoke with event_token
void ReadingChanged(event_token const* cookie) const;

// Revoke with event_revoker
Gyrometer::ReadingChanged_revoker ReadingChanged(auto_revoke_t, TypedEventHandler<Gyrometer, GyrometerReadingChangedEventArgs const&> const& handler) const;

public event TypedEventHandler<Gyrometer,GyrometerReadingChangedEventArgs> ReadingChanged;

function onReadingChanged(eventArgs) { /* Your code */ }
gyrometer.addEventListener("readingchanged", onReadingChanged);
gyrometer.removeEventListener("readingchanged", onReadingChanged);
- or -
gyrometer.onreadingchanged = onReadingChanged;

Public Custom Event ReadingChanged As TypedEventHandler(Of Gyrometer, GyrometerReadingChangedEventArgs) 

Event Type

TypedEventHandler<Gyrometer,GyrometerReadingChangedEventArgs>

Examples

The following example demonstrates how a UWP app built with C# and XAML registers its ReadingChanged event handler.

private void ScenarioEnable(object sender, RoutedEventArgs e)
{
    if (_gyrometer != null)
    {
        // Establish the report interval
        _gyrometer.ReportInterval = _desiredReportInterval;

        Window.Current.VisibilityChanged += new WindowVisibilityChangedEventHandler(VisibilityChanged);
        _gyrometer.ReadingChanged += new TypedEventHandler<Gyrometer, GyrometerReadingChangedEventArgs>(ReadingChanged);

        ScenarioEnableButton.IsEnabled = false;
        ScenarioDisableButton.IsEnabled = true;
    }
    else
    {
        rootPage.NotifyUser("No gyrometer found", NotifyType.StatusMessage);
    }
}

The following example shows the ReadingChanged event handler.

async private void ReadingChanged(object sender, GyrometerReadingChangedEventArgs e)
{
    await Dispatcher.RunAsync(CoreDispatcherPriority.Normal, () =>
    {
        GyrometerReading reading = e.Reading;
        ScenarioOutput_X.Text = String.Format("{0,5:0.00}", reading.AngularVelocityX);
        ScenarioOutput_Y.Text = String.Format("{0,5:0.00}", reading.AngularVelocityY);
        ScenarioOutput_Z.Text = String.Format("{0,5:0.00}", reading.AngularVelocityZ);
    });
}

Remarks

An application may register this event handler to obtain sensor readings. The application must establish a desired ReportInterval. This informs the sensor driver that resources should be allocated to satisfy the requirements of the application.

Applications can set the frequency of this event by setting the ReportInterval property.