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

Статья
08/25/2023

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

Синтаксис

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	Во время обработки произошло исключение.

Примечание Доступ к этому свойству в определенных обработчиках сообщений может привести к повторному вводу базовой функции, что приведет к непредвиденным результатам. Избегайте повторного вызова при обработке любого из следующих сообщений: 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