この分析ヒントの単語リストを変更します。単語リストは、手書きに一致する可能性のある用語のソースとして辞書を補うか、置き換えられます。
名前空間 : Microsoft.Ink
アセンブリ : Microsoft.Ink.Analysis (Microsoft.Ink.Analysis.dll 内)
構文
'宣言
Public Sub SetWordlist ( _
wordlist As String() _
)
'使用
Dim instance As AnalysisHintNode
Dim wordlist As String()
instance.SetWordlist(wordlist)
public void SetWordlist(
string[] wordlist
)
public:
void SetWordlist(
array<String^>^ wordlist
)
public void SetWordlist(
String[] wordlist
)
public function SetWordlist(
wordlist : String[]
)
パラメータ
- wordlist
型 : array<System.String[]
単語リストを追加する文字列配列。または、単語リストを削除する場合は nullnull 参照 (Visual Basic では Nothing)。
解説
Factoid プロパティおよび CoerceToFactoid プロパティと、単語リストは、手書きを用語に一致させる方法を変更するためにやり取りを行います。
Factoid プロパティが (!IS_PHRASELIST) トークンで設定された場合、認識エンジンは辞書ではなく単語リスト内の用語と一致させます。トークンが設定されていない場合、認識エンジンは単語リストと辞書の両方にある用語と一致させます。
CoerceToFactoid プロパティは、辞書または単語リストで一致しなかった単語を認識エンジンが返すかどうかを決定します。このプロパティが true に設定されている場合、手書き句が用語に一致しないと認識エンジンは何も返しません。CoerceToFactoid が false に設定されている場合、認識エンジンは一致した結果を優先しますが、どちらのリストにもない文字列を返すこともできます。
次の表に、これらのプロパティ設定のさまざまな組み合わせで考えられる戻り値の概要を示します。
擬似事実 |
CoerceToFactoid |
戻り値 |
---|---|---|
(!IS_PHRASELIST) または "WORDLIST" が含まれない |
false |
単語リストまたは辞書のいずれかの値。またはリストされていない結果。 |
(!IS_PHRASELIST) または "WORDLIST" が含まれる |
false |
単語リストの値。またはリストされていない結果。 |
"(!IS_PHRASELIST)" または "WORDLIST" が含まれる |
true |
単語リストの値。または戻り値なし。 |
文字列が単語リストに追加される場合、その大文字の文字列も暗黙に追加されます。たとえば、"hello" を追加すると、暗黙に "Hello" と "HELLO" が追加されます。
ヒントの単語リストを返すには、GetWordlist を使用します。
分析時、ストロークに適用されたインク認識エンジンが単語リストをサポートしていない場合、インク アナライザはその WarningCode プロパティが Microsoft.Ink.AnalysisWarningCode 値 WordlistNotSupported に設定された AnalysisWarning を生成します。
例
この例では、InkAnalyzer、theInkAnalyzerWithHint の AnalysisHintNode、theAnalysisHint を作成し、theAnalysisHint をグローバル ヒントにします。次に、単語リストをヒントに追加し、ヒントの名前を設定します。
' Add a new, global analysis hint to theInkAnalyzerWithHint.
Dim theAnalysisHint As Microsoft.Ink.AnalysisHintNode = _
Me.theInkAnalyzerWithHint.CreateAnalysisHint()
theAnalysisHint.Location.MakeInfinite()
theAnalysisHint.SetWordlist(TheForm.theWordList)
theAnalysisHint.Name = "Wordlist"
// Add a new, global analysis hint to theInkAnalyzerWithHint.
Microsoft.Ink.AnalysisHintNode theAnalysisHint =
this.theInkAnalyzerWithHint.CreateAnalysisHint();
theAnalysisHint.Location.MakeInfinite();
theAnalysisHint.SetWordlist(TheForm.theWordList);
theAnalysisHint.Name = "Wordlist";
プラットフォーム
Windows Vista
.NET Framework および .NET Compact Framework では、各プラットフォームのすべてのバージョンはサポートしていません。サポートされているバージョンについては、「.NET Framework システム要件」を参照してください。
バージョン情報
.NET Framework
サポート対象 : 3.0