Compass.GetCurrentReading Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient la lecture actuelle de la boussole.
public:
virtual CompassReading ^ GetCurrentReading() = GetCurrentReading;
CompassReading GetCurrentReading();
public CompassReading GetCurrentReading();
function getCurrentReading()
Public Function GetCurrentReading () As CompassReading
Retours
Lecture de la boussole actuelle.
Exemples
L’exemple suivant montre comment une application UWP créée avec XAML et C# récupère le titre actuel de la boussole par défaut.
private void DisplayCurrentReading(object sender, object args)
{
CompassReading reading = _compass.GetCurrentReading();
if (reading != null)
{
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";
}
}
}
Remarques
Une application peut utiliser cette méthode pour interroger le capteur sur la lecture actuelle comme alternative à l’inscription d’un gestionnaire d’événements ReadingChanged . Il s’agit de l’alternative préférée pour une application qui met à jour son interface utilisateur à une fréquence d’images spécifique. Qu’il s’agisse d’une interrogation unique ou plusieurs fois, l’application doit établir un ReportInterval souhaité. Cela informe le pilote de capteur que les ressources doivent être allouées pour répondre aux demandes d’interrogation suivantes
La valeur retournée est un titre magnétique spécifié en degrés.
La précision de cette valeur dépend des capacités de la boussole.
Avant d’utiliser la valeur de retour de cette méthode, l’application doit d’abord case activée que la valeur n’est pas null. (Si la valeur est null et que vous tentez de la récupérer, Windows génère une exception.)