InkAnalyzer.GetAlternates メソッド (ContextNodeCollection, Int32)

2008-10-28

ContextNodeCollection に格納されているノードの分析代替候補を指定した数まで含む AnalysisAlternateCollection を返します。

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

構文

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

returnValue = instance.GetAlternates(nodes, _
    maximumAlternates)

public AnalysisAlternateCollection GetAlternates(
    ContextNodeCollection nodes,
    int maximumAlternates
)

public:
AnalysisAlternateCollection^ GetAlternates(
    ContextNodeCollection^ nodes, 
    int maximumAlternates
)

public AnalysisAlternateCollection GetAlternates(
    ContextNodeCollection nodes,
    int maximumAlternates
)

public function GetAlternates(
    nodes : ContextNodeCollection, 
    maximumAlternates : int
) : AnalysisAlternateCollection

パラメータ

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

maximumAlternates
型 : System.Int32
返される分析代替候補の数。

戻り値

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

解説

最上位の代替候補が、コレクションの最初の代替候補として返されます。

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

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

例

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

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

For Each theAlternate As AnalysisAlternate In theAlternateCollection
    theAlternateStrings.Add(theAlternate.RecognizedString)
Next theAlternate

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