Поделиться через


Метод IInkTablet::GetPropertyMetrics (msinkaut.h)

Извлекает данные метрик для указанного свойства.

Синтаксис

HRESULT GetPropertyMetrics(
  [in]  BSTR                     propertyName,
  [out] long                     *Minimum,
  [out] long                     *Maximum,
  [out] TabletPropertyMetricUnit *Units,
  [out] float                    *Resolution
);

Параметры

[in] propertyName

Свойство, для которого требуется определить метрики.

Дополнительные сведения о типе данных BSTR см. в разделе Использование библиотеки COM.

[out] Minimum

Минимальное значение в логических единицах, которое планшет сообщает для этого свойства. Например, планшет, сообщающий значения X от 0 до 9000, имеет логический минимум 0.

[out] Maximum

Максимальное значение (в логических единицах), которое планшет сообщает для этого свойства. Например, планшет, сообщающий значения X от 0 до 9000, будет иметь логический максимум 9000.

[out] Units

Физические единицы свойства, например дюймы или градусы. Список единиц свойств см. в разделе Тип перечисления TabletPropertyMetricUnit .

[out] Resolution

Задает разрешение или значение приращения для элемента units . Например, планшет, сообщающий о 400 точках на дюйм (точек на дюйм), имеет значение разрешения 400.

Возвращаемое значение

Этот метод может возвращать одно из этих значений.

Код возврата Описание
S_OK
Успешно.
TPC_E_UNKNOWN_PROPERTY
Планшет не поддерживает указанное свойство.
E_FAIL
Произошла неизвестная ошибка.
E_POINTER
Параметр содержал недопустимый указатель.
CO_E_CLASSSTRING
Недопустимый формат GUID.
E_INVALIDARG
Неизвестная строка свойства.
E_INK_EXCEPTION
Во время обработки произошло исключение.

Комментарии

Свойства, для которых вы извлекаете метрики, могут включать время создания пакета или давление понижающего наконечника пера на поверхности планшета.

Полный список свойств, для которых можно получить метрики, см. в разделе Константы PacketProperty .

Примечание Доступ к этому свойству в определенных обработчиках сообщений может привести к повторному вводу базовой функции, что приведет к непредвиденным результатам. Избегайте повторного вызова при обработке любого из следующих сообщений: WM_ACTIVATE, WM_ACTIVATEAPP, WMNCACTIVATE, WM_PAINT; WM_SYSCOMMAND, если для wParam задано значение SC_HOTKEY или SC_TASKLIST; и WM_SYSKEYDOWN (при обработке сочетаний клавиш Alt-Tab или Alt-Esc). Это проблема с однопоточными приложениями модели подразделения.
 

Требования

   
Минимальная версия клиента Windows XP Tablet PC Edition [только классические приложения]
Минимальная версия сервера Ни одна версия не поддерживается
Целевая платформа Windows
Header msinkaut.h
Библиотека InkObj.dll

См. также раздел

Метод GetPacketDescriptionPropertyMetrics

Метод GetPacketValuesByProperty

Интерфейс IInkTablet

Метод SetPacketValuesByProperty

Перечисление TabletPropertyMetricUnit