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
タブレットがこのプロパティについて報告する最小値 (論理単位)。 たとえば、x 値を 0 から 9000 に報告するタブレットの論理最小値は 0 です。
[out] Maximum
タブレットがこのプロパティについて報告する論理単位の最大値。 たとえば、x 値を 0 から 9000 に報告するタブレットでは、論理最大値は 9000 になります。
[out] Units
インチや度など、プロパティの物理単位。 プロパティ ユニットの一覧については、 TabletPropertyMetricUnit 列挙型に関するページを参照してください。
[out] Resolution
units メンバーの解像度または増分値を指定します。 たとえば、400 ドット/インチ (dpi) を報告するタブレットの解像度の値は 400 です。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
| リターン コード | 説明 |
|---|---|
|
正常終了しました。 |
|
タブレットは、指定されたプロパティをサポートしていません。 |
|
未指定のエラーが発生しました。 |
|
パラメーターに無効なポインターが含まれていました。 |
|
GUID 形式が無効です。 |
|
不明なプロパティ文字列。 |
|
処理中に例外が発生しました。 |
解説
メトリックを取得するプロパティには、パケットが生成された時間やタブレット表面のペン先の下向き圧力が含まれる場合があります。
メトリックを取得できるプロパティの完全な一覧については、 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 |
関連項目
GetPacketDescriptionPropertyMetrics メソッド
GetPacketValuesByProperty メソッド