Compass.GetCurrentReading Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает текущее считывание компаса.
public:
virtual CompassReading ^ GetCurrentReading() = GetCurrentReading;
CompassReading GetCurrentReading();
public CompassReading GetCurrentReading();
function getCurrentReading()
Public Function GetCurrentReading () As CompassReading
Возвращаемое значение
Текущее считывание компаса.
Примеры
В следующем примере показано, как приложение UWP, созданное с помощью XAML и C#, извлекает текущий заголовок для компаса по умолчанию.
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";
}
}
}
Комментарии
Приложение может использовать этот метод для опроса датчика для текущего чтения в качестве альтернативы регистрации обработчика событий ReadingChanged . Это будет предпочтительным вариантом для приложения, которое обновляет свой пользовательский интерфейс с определенной частотой кадров. Независимо от того, выполняется ли опрос один или несколько раз, приложение должно установить нужный ReportInterval. Это информирует драйвер датчика о том, что ресурсы должны быть выделены для удовлетворения последующих запросов опроса.
Возвращаемое значение является магнитным заголовком, указанным в градусах.
Точность этого значения зависит от возможностей компаса.
Прежде чем использовать возвращаемое из этого метода значение, приложение должно сначала проверка, что значение не равно NULL. (Если значение равно NULL и вы пытаетесь получить его, Windows создаст исключение.)