Partager via


Inclinometer Classe

Définition

Représente un capteur d’inclinomètre qui fournit des valeurs de tangage, de roulis et de lacet correspondant aux angles de rotation autour des axes x, y et z, respectivement.

public ref class Inclinometer sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Inclinometer final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class Inclinometer
Public NotInheritable Class Inclinometer
Héritage
Object Platform::Object IInspectable Inclinometer
Attributs

Configuration requise pour Windows

Famille d’appareils
Windows 10 (introduit dans 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Exemples

Pour obtenir un exemple d’implémentation, consultez l’exemple https://github.com/Microsoft/Windows-universal-samples/tree/master/Samples/Inclinometerinclinomètre .

Remarques

Les données du capteur sont fournies par rapport au système de coordonnées fixes du capteur de l’appareil et sont indépendantes de l’orientation de l’affichage. Pour les applications qui s’appuient sur des données de capteur pour le contrôle d’entrée ou pour manipuler des éléments à l’écran, le développeur doit prendre en compte l’orientation actuelle de l’affichage et compenser les données de manière appropriée. Pour plus d’informations sur le système de coordonnées du capteur, consultez Données du capteur et orientation de l’affichage.

L’exemple suivant montre comment une application UWP créée avec XAML et C# utilise la méthode GetDefault pour établir une connexion à un inclinomètre. Si aucun inclinomètre intégré n’est trouvé, la méthode retourne une valeur null.

_inclinometer = Inclinometer.GetDefault();

L’exemple suivant montre comment une application UWP créée avec XAML inscrit un gestionnaire d’événements ReadingChanged .

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);
    }
}

L’exemple suivant montre le gestionnaire d’événements ReadingChanged .

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);
    });
}

Historique des versions

Version de Windows Version du SDK Valeur ajoutée
1607 14393 GetDefault(SensorReadingType)
1709 16299 FromIdAsync
1709 16299 GetDeviceSelector
1709 16299 MaxBatchSize
1709 16299 ReportLatency
2004 19041 ReportThreshold

Propriétés

DeviceId

Obtient l’identificateur de l’appareil.

MaxBatchSize

Obtient le nombre maximal d’événements pouvant être traités par lot par le capteur.

MinimumReportInterval

Obtient l’intervalle de rapport minimal pris en charge par l’inclinomètre.

ReadingTransform

Obtient ou définit la transformation qui doit être appliquée aux données du capteur. Les transformations à appliquer sont liées à l’orientation d’affichage avec laquelle aligner les données du capteur.

ReadingType

Obtient le type de lecture du capteur.

ReportInterval

Obtient ou définit l’intervalle de rapport actuel pour l’inclinomètre.

ReportLatency

Obtient ou définit le délai entre les lots d’informations du capteur.

ReportThreshold

Obtient l’InclinometerDataThreshold pour le capteur gyromètre.

Méthodes

FromIdAsync(String)

Obtient de manière asynchrone le capteur à partir de son identificateur.

GetCurrentReading()

Obtient la lecture actuelle de l’inclinomètre.

GetDefault()

Retourne l’inclinomètre par défaut pour les lectures absolues.

GetDefault(SensorReadingType)

Retourne l’inclinomètre par défaut basé sur SensorReadingType.

GetDefaultForRelativeReadings()

Retourne l’inclinomètre par défaut pour les lectures relatives.

GetDeviceSelector(SensorReadingType)

Obtient le sélecteur d’appareil.

Événements

ReadingChanged

Se produit chaque fois que l’inclinomètre signale une nouvelle lecture de capteur.

S’applique à

Voir aussi