IInkRecognitionAlternate::AlternatesWithConstantPropertyValues メソッド (msinkaut.h)

[アーティクル]
08/25/2023

このメソッドが呼び出される IInkRecognitionAlternate オブジェクトの除算である IInkRecognitionAlternates コレクションを取得します。

構文

HRESULT AlternatesWithConstantPropertyValues(
  [in]          BSTR                      PropertyType,
  [out, retval] IInkRecognitionAlternates **AlternatesWithConstantPropertyValues
);

パラメーター

[in] PropertyType

プロパティを識別する文字列値を指定します。使用できるプロパティの一覧については、「 RecognitionProperty」を参照してください。

BSTR データ型の詳細については、「 COM ライブラリの使用」を参照してください。

[out, retval] AlternatesWithConstantPropertyValues

このメソッドが戻るときに、このメソッドが呼び出される代替の除算で構成される IInkRecognitionAlternates コレクションが格納されます。コレクション内の各 IInkRecognitionAlternate オブジェクトには、 propertyType パラメーターと同じプロパティ値を持つ隣接する認識セグメントが含まれています。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

リターンコード	説明
S_OK	正常終了しました。
E_POINTER	パラメーターに無効なポインターが含まれていました。
E_INVALIDARG	認識範囲が無効です。
E_INK_EXCEPTION	処理中に例外が発生しました。
E_OUTOFMEMORY	操作を完了するためにメモリを割り当てることができません。

注釈

コレクション内の各代替には、メソッドに渡されるプロパティと同じプロパティ値を持つ隣接する認識セグメントが含まれています。

たとえば、元の代替を次のように除算する代替を返すことができます。

信頼度境界のレベルは、認識結果の強い、中間、または不適切です。
線の境界。
認識セグメントの境界。

プロパティの種類の完全な一覧については、「 RecognitionProperty」を参照してください。

メモ認識エンジンは、認識セグメントへのストロークのセグメント化を決定します。スペースなどの一部の認識セグメントは、空の InkStrokes コレクションに対応している場合があります。

メモ認識エンジンは、認識セグメントの順序を決定します。したがって、隣接する認識セグメントは、インクが描画された順序に基づくか、または位置に基づいて、左から右に配置されているか、上から下に配置されているかなどです。

ConfidenceAlternates プロパティは AlternatesWithConstantPropertyValues メソッドの代替手段です。ConfidenceLevel は、返される認識代替コレクション内の代替を区切る RecognitionProperty です。

LineAlternates プロパティは AlternatesWithConstantPropertyValues メソッドの代替手段です。LineNumber は、返される認識代替コレクション内の代替を区切る RecognitionProperty です。

メモAlternatesWithConstantPropertyValues メソッド、LineAlternates プロパティ、および IInkRecognitionAlternate オブジェクト関数の ConfidenceAlternates プロパティは、IInkRecognitionResult オブジェクトの AlternatesFromSelection メソッドとは異なります。 AlternatesFromSelection は、認識結果の要求されたセグメントの代替のコレクションを返します。

要件

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