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 ドット/インチ (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します。と WM_SYSKEYDOWN (キーの組み合わせを Alt-Tab または Alt-Esc 処理する場合)。これは、シングルスレッドアパートメントモデルアプリケーションの問題です。

要件


サポートされている最小のクライアント	Windows XP タブレット PC エディション [デスクトップアプリのみ]
サポートされている最小のサーバー	サポートなし
対象プラットフォーム	Windows
ヘッダー	msinkaut.h
Library	InkObj.dll

Share via

IInkTablet::GetPropertyMetrics メソッド (msinkaut.h)

構文

パラメーター

戻り値

解説

要件

関連項目

フィードバック

フィードバック

その他のリソース