Compass Class

Représente un capteur de boussole.

Ce capteur retourne un titre nord géographique et éventuellement nord magnétique. (Ce dernier dépend des fonctions du capteur.)

Syntaxe


public ref class Compass sealed 

Attributs

[DualApiPartition()]
[MarshalingBehavior(Agile)]
[Threading(Both)]
[Version(0x06020000)]

Membres

CompassClasse possède ces types de membres :

Événements

CompassClasse possède ces événements.

ÉvénementDescription
ReadingChanged Occurs each time the compass reports a new sensor reading.

 

Méthodes

The Compass Classe a les méthodes suivantes. Avec C#, Visual Basic et C++, elle hérite également des méthodes de Object Classe.

MéthodeDescription
GetCurrentReading Gets the current compass reading.
GetDefault Returns the default compass.

 

Propriétés

Le CompassClasse a les propriétés suivantes.

PropriétéType d'accèsDescription

MinimumReportInterval

En lecture seuleGets the minimum report interval supported by the compass.

ReportInterval

Lecture/écritureGets or sets the current report interval for the compass.

 

Remarques

L'exemple suivant montre comment une application du Windows Store conçue avec XAML et C# utilise la méthode GetDefault pour établir une connexion avec une boussole. Si aucune boussole intégrée n'est trouvée, la méthode retourne une valeur null.


_compass = Compass.GetDefault();


L'exemple suivant montre comment une application Windows Store conçue avec XAML enregistre un gestionnaire d'événements ReadingChanged.


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

        Window.Current.VisibilityChanged += new WindowVisibilityChangedEventHandler(VisibilityChanged);
        _compass.ReadingChanged += new TypedEventHandler<Compass, CompassReadingChangedEventArgs>(ReadingChanged);

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


L'exemple suivant présente le gestionnaire d'événements ReadingChanged.


async private void ReadingChanged(object sender, CompassReadingChangedEventArgs e)
{
    await Dispatcher.RunAsync(CoreDispatcherPriority.Normal, () =>
    {
        CompassReading reading = e.Reading;
        ScenarioOutput_MagneticNorth.Text = String.Format("{0,5:0.00}", reading.HeadingMagneticNorth);
        if (reading.HeadingTrueNorth != null)
        {
            ScenarioOutput_TrueNorth.Text = String.Format("{0,5:0.00}", reading.HeadingTrueNorth);
        }
        else
        {
            ScenarioOutput_TrueNorth.Text = "No data";
        }
    });
}


Conditions requises

Client minimal pris en charge

Windows 8 [Applications Windows Store, applications de bureau]

Serveur minimal pris en charge

Aucun pris en charge [Applications Windows Store, applications de bureau]

Téléphone minimal pris en charge

Windows Phone 8

Espace de noms

Windows.Devices.Sensors
Windows::Devices::Sensors [C++]

Métadonnées

Windows.winmd

Voir aussi

Compass, Démarrage rapide
Compass, exemple

 

 

Afficher:
© 2014 Microsoft