InkAnalyzer.GetAlternates メソッド (ContextNodeCollection)

2008-10-28

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

名前空間 : System.Windows.Ink
アセンブリ : IAWinFX (IAWinFX.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
型 : System.Windows.Ink.ContextNodeCollection

戻り値

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

解説

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

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

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

例

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

' Get analysis alternates for the context node collection and add the
' recognized strings to a string collection.
theAlternateCollection = Me.theInkAnalyzer.GetAlternates(theContextNodes)
theAlternateStrings.Clear()

For Each theAlternate As AnalysisAlternate 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 (AnalysisAlternate theAlternate
    in theAlternateCollection)
{
    theAlternateStrings.Add(theAlternate.RecognizedString);
}