共用方式為


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

平板電腦報告此屬性的最小值,以邏輯單位為單位。 例如,從 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

另請參閱

GetPacketDescriptionPropertyMetrics 方法

GetPacketValuesByProperty 方法

IInkTablet 介面

SetPacketValuesByProperty 方法

TabletPropertyMetricUnit 列舉