IInkTablet：：GetPropertyMetrics 方法 (msinkaut.h)

项目
08/25/2023

检索指定属性的指标数据。

语法

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

parameters

[in] propertyName

要确定其指标的属性。

有关 BSTR 数据类型的详细信息，请参阅使用 COM 库。

[out] Minimum

平板电脑为此属性报告的最小值（以逻辑单位为单位）。例如，在 0 到 9000 范围内报告 x 值的平板电脑的逻辑最小值为 0。

[out] Maximum

平板电脑为此属性报告的最大值（以逻辑单位为单位）。例如，从 0 到 9000 的 x 值报告平板电脑的逻辑最大值为 9000。

[out] Units

属性的物理单位，例如英寸或度。有关属性单位的列表，请参阅 TabletPropertyMetricUnit 枚举类型。

[out] Resolution

指定 units 成员的分辨率或递增值。例如，每英寸 400 点 (dpi) 的平板电脑的分辨率值为 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;如果 wParam 设置为 SC_HOTKEY 或 SC_TASKLIST，WM_SYSCOMMAND;处理 Alt-Tab 或 Alt-Esc 组合键时WM_SYSKEYDOWN () 。这是单线程单元模型应用程序的问题。

要求


最低受支持的客户端	Windows XP Tablet PC Edition [仅限桌面应用]
最低受支持的服务器	无受支持的版本
目标平台	Windows
标头	msinkaut.h
Library	InkObj.dll