InkAnalyzer.GetAlternates メソッド (ContextNodeCollection)

2008-10-28

指定した ContextNodeCollection 内のノードの分析代替候補を最大 10 個返します。

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

構文

'宣言
Public Function GetAlternates ( _
    nodes As ContextNodeCollection _
) As AnalysisAlternateCollection
'使用
Dim instance As InkAnalyzer
Dim nodes As ContextNodeCollection
Dim returnValue As AnalysisAlternateCollection

returnValue = instance.GetAlternates(nodes)

public AnalysisAlternateCollection GetAlternates(
    ContextNodeCollection nodes
)

public:
AnalysisAlternateCollection^ GetAlternates(
    ContextNodeCollection^ nodes
)

public AnalysisAlternateCollection GetAlternates(
    ContextNodeCollection nodes
)

public function GetAlternates(
    nodes : ContextNodeCollection
) : AnalysisAlternateCollection

パラメータ

nodes
型 : Microsoft.Ink.ContextNodeCollection
分析代替候補を取得するノード。

戻り値

型 : Microsoft.Ink.AnalysisAlternateCollection
nodes の最大 10 個の上位代替候補。

解説

最上位の代替候補が、コレクションの最初の代替候補として返されます。10 個を超える代替候補がある場合、最初の 10 個だけが返されます。

nodes 内の ContextNode オブジェクトは、ドキュメントの隣接する領域を表している必要はありません。

nodes 内の分析のヒントごとに、InkAnalyzer は最上位の代替候補のみ返します。

例

この例では、InkAnalyzer、theInkAnalyzer に関連付けられた ContextNodeCollection、theContextNodes の上位 10 個までの代替候補を取得します。次に、代替候補の認識された文字列を System.Collections.Specialized.StringCollection、theAlternateStrings に追加します。

' Get analysis alternates for the context node collection and add the
' recognized strings to a string collection.
theAlternateCollection = Me.theInkAnalyzer.GetAlternates(theContextNodes)
theAlternateStrings.Clear()
Dim theAlternate As Microsoft.Ink.AnalysisAlternate
For Each theAlternate In theAlternateCollection
    theAlternateStrings.Add(theAlternate.RecognizedString)
Next theAlternate

// Get analysis alternates for the context node collection and add the
// recognized strings to a string collection.
theAlternateCollection = this.theInkAnalyzer.GetAlternates(theContextNodes);
theAlternateStrings.Clear();
foreach (Microsoft.Ink.AnalysisAlternate theAlternate
    in theAlternateCollection)
{
    theAlternateStrings.Add(theAlternate.RecognizedString);
}