AnalysisHintNode.SetWordlist 方法
變更這個分析提示的單字清單。單字清單會對可能符合手寫之詞彙的來源字典進行增補或置換。
命名空間： 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，辨識器會在比對手寫的片語或詞彙失敗的情況下傳回 nothing。如果 CoerceToFactoid 是設定為 false，辨識器會順利比對出結果，但可能傳回字典或單字清單中不存在的字串。
下表摘要列出指定這些屬性不同設定組合的情況下可能的傳回值。
個人小檔案 |
CoerceToFactoid |
可能的傳回值 |
|---|---|---|
不包含 (!IS_PHRASELIST) 或 "WORDLIST" |
false |
來自單字清單或字典的值，或是未列出的結果。 |
包含 (!IS_PHRASELIST) 或 "WORDLIST" |
false |
來自單字清單的值，或是未列出的結果。 |
包含 "(!IS_PHRASELIST)" 或 "WORDLIST" |
true |
來自單字清單的值，或是 nothing。 |
如果將字串加入至單字清單，也會隱含加入其大寫版本。例如，加入 "hello" 會隱含加入 "Hello" 和 "HELLO"。
若要傳回提示的單字清單，請使用 GetWordlist。
在分析期間，如果套用於筆劃的筆墨分析器不支單字清單，則筆墨分析器會透過將它的 WarningCode 屬性設定為 WordlistNotSupported 的 Microsoft.Ink.AnalysisWarningCode 值來產生 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