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

平板電腦報告此屬性的最小值，以邏輯單位為單位。例如，從 0 到 9000 的平板電腦，其邏輯最小值為 0。

[out] Maximum

平板電腦報告此屬性的最大值，以邏輯單位為單位。例如，從 0 到 9000 的平板電腦，其邏輯最大值為 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_ACTI加值稅E、WM_ACTI加值稅EAPP、WMNCACTI加值稅E、WM_PAINT;WM_SYSCOMMAND 如果 wParam 設定為 SC_HOTKEY 或 SC_TASKLIST;和 WM_SYSKEYDOWN (處理 Alt-Tab 或 Alt-Esc 按鍵組合時) 。這是單一執行緒 Apartment 模型應用程式的問題。

需求


最低支援的用戶端	Windows XP Tablet PC Edition [僅限傳統型應用程式]
最低支援的伺服器	都不支援
目標平台	Windows
標頭	msinkaut.h
程式庫	InkObj.dll