Compass.GetCurrentReading Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene la lettura corrente della bussola.
public:
virtual CompassReading ^ GetCurrentReading() = GetCurrentReading;
CompassReading GetCurrentReading();
public CompassReading GetCurrentReading();
function getCurrentReading()
Public Function GetCurrentReading () As CompassReading
Restituisce
La lettura corrente della bussola.
Esempio
L'esempio seguente illustra come un'app UWP compilata con XAML e C# recupera l'intestazione corrente per la bussola predefinita.
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";
}
}
}
Commenti
Un'applicazione può usare questo metodo per eseguire il polling del sensore per la lettura corrente come alternativa alla registrazione di un gestore eventi ReadingChanged . Si tratta dell'alternativa preferita per un'applicazione che aggiorna l'interfaccia utente a una frequenza di fotogrammi specifica. Indipendentemente dal fatto che il polling venga eseguito una o più volte, l'applicazione deve stabilire un reportInterval desiderato. In questo modo il driver del sensore informa che le risorse devono essere allocate per soddisfare le richieste di polling successive
Il valore restituito è un titolo magnetico specificato in gradi.
L'accuratezza di questo valore dipende dalle funzionalità della bussola.
Prima di usare il valore restituito da questo metodo, l'applicazione deve prima verificare che il valore non sia Null. Se il valore è Null e si tenta di recuperarlo, Windows genererà un'eccezione.