Inclinometer class (Windows)

2 out of 2 rated this helpful - Rate this topic

Represents an inclinometer sensor.

This sensor returns pitch, roll, and yaw values that correspond to rotation angles around the x, y, and z axes, respectively.

Syntax

JavaScript

C++


var inclinometer = Windows.Devices.Sensors.Inclinometer;

Attributes

DualApiPartitionAttribute()
MarshalingBehaviorAttribute(Agile)
StaticAttribute(Windows.Devices.Sensors.IInclinometerStatics, NTDDI_WIN8)
ThreadingAttribute(Both)
VersionAttribute(NTDDI_WIN8)

Members

The Inclinometer class has these types of members:

Events
Methods
Properties

Events

The Inclinometer class has these events.

Event	Description
ReadingChanged	Occurs each time the inclinometer reports a new sensor reading.

Methods

The Inclinometer class has these methods. With C#, Visual Basic, and C++, it also inherits methods from the Object class.

Method	Description
GetCurrentReading	Gets the current inclinometer reading.
GetDefault	Returns the default inclinometer.

Properties

The Inclinometer class has these properties.

Property	Access type	Description
MinimumReportInterval	Read-only	Gets the minimum report interval supported by the inclinometer.
ReportInterval	Read/write	Gets or sets the current report interval for the inclinometer.

Remarks

The following example demonstrates how a Windows Store app built with XAML and C# uses the GetDefault method to establish a connection to an inclinometer. If no integrated inclinometer is found, the method will return a null value.


_inclinometer = Inclinometer.GetDefault();

The following example demonstrates how a Windows Store app built with XAML registers a ReadingChanged event handler.


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

        Window.Current.VisibilityChanged += new WindowVisibilityChangedEventHandler(VisibilityChanged);
        _inclinometer.ReadingChanged += new TypedEventHandler<Inclinometer, InclinometerReadingChangedEventArgs>(ReadingChanged);

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

The following example shows the ReadingChanged event handler.


async private void ReadingChanged(object sender, InclinometerReadingChangedEventArgs e)
{
    await Dispatcher.RunAsync(CoreDispatcherPriority.Normal, () =>
    {
        InclinometerReading reading = e.Reading;
        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);
    });
}

Requirements

Minimum supported client	Windows 8 [Windows Store apps, desktop apps]
Minimum supported server	Windows Server 2012 [Windows Store apps, desktop apps]
Minimum supported phone	Windows Phone 8
Namespace	Windows.Devices.Sensors Windows::Devices::Sensors [C++]
Metadata	Windows.winmd

Inclinometer class