RecognitionAlternate.AlternatesWithConstantPropertyValues メソッド

[アーティクル]
10/28/2008

このメソッドが呼び出される RecognitionAlternate オブジェクトの分割で構成される RecognitionAlternates コレクションを返します。

名前空間 : Microsoft.Ink
アセンブリ : Microsoft.Ink (Microsoft.Ink.dll 内)

構文

'宣言
Public Function AlternatesWithConstantPropertyValues ( _
    g As Guid _
) As RecognitionAlternates
'使用
Dim instance As RecognitionAlternate
Dim g As Guid
Dim returnValue As RecognitionAlternates

returnValue = instance.AlternatesWithConstantPropertyValues(g)

public RecognitionAlternates AlternatesWithConstantPropertyValues(
    Guid g
)

public:
RecognitionAlternates^ AlternatesWithConstantPropertyValues(
    Guid g
)

public RecognitionAlternates AlternatesWithConstantPropertyValues(
    Guid g
)

public function AlternatesWithConstantPropertyValues(
    g : Guid
) : RecognitionAlternates

パラメータ

g
型 : System.Guid
コレクションでそれぞれが RecognitionAlternate を返す RecognitionProperty 型の Guid 識別子は、同じ定数値を持ちます。

戻り値

型 : Microsoft.Ink.RecognitionAlternates
このメソッドが呼び出される RecognitionAlternate オブジェクトの分割で構成される RecognitionAlternates コレクションを返します。

解説

RecognitionAlternates コレクションの各 RecognitionAlternate オブジェクトは、メソッドに渡される g プロパティに対して同じプロパティ値を持つ、隣接した認識セグメントを含みます。

たとえば、元の代替候補を次の基準によって分割する代替候補を返すことができます。

認識結果の信頼性レベルの境界 (strong、intermediate、poor のいずれか)。
行境界。
認識セグメント境界。

プロパティ型の完全な一覧については、RecognitionProperty オブジェクトを参照してください。

メモ :
認識エンジンは、認識セグメントに入れるストロークの区切りを決定します。スペースなどの一部の認識セグメントが、空の Strokes コレクションに対応する場合があります。

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

ConfidenceLevel プロパティが、返される RecognitionAlternates コレクションの代替候補を区別する RecognitionProperty である場合、ConfidenceAlternates プロパティは、AlternatesWithConstantPropertyValues メソッドの代替になります。

LineNumber プロパティが、返される RecognitionAlternates コレクションの代替候補を区別する RecognitionProperty である場合、LineAlternates プロパティは、AlternatesWithConstantPropertyValues メソッドの代替になります。

メモ :
AlternatesWithConstantPropertyValues メソッド、LineAlternates プロパティ、および RecognitionAlternate オブジェクトの ConfidenceAlternates プロパティは、RecognitionResult オブジェクトの GetAlternatesFromSelection メソッドとは機能が異なります。GetAlternatesFromSelection メソッドは、認識結果の要求されたセグメントの RecognitionAlternates コレクションを返します。

AlternatesWithConstantPropertyValues メソッド、LineAlternates プロパティ、および RecognitionAlternate オブジェクトの ConfidenceAlternates プロパティは、RecognitionResult オブジェクトの GetAlternatesFromSelection メソッドとは機能が異なります。GetAlternatesFromSelection メソッドは、認識結果の要求されたセグメントの RecognitionAlternates コレクションを返します。