AnalysisHintNode.SetWordlist 方法
變更目前分析提示的單字清單。單字清單會對可能符合手寫之詞彙的來源字典進行增補或置換。
命名空間： System.Windows.Ink
組件： IAWinFX (在 IAWinFX.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[]
備註
Factoid 和 CoerceToFactoid 屬性會與單字清單互動，修改手寫及詞彙的比對方式。
- 搭配 (!IS_PHRASELIST) 語彙基元設定 Factoid 屬性時，辨識器會比對單字清單中儲存的詞彙。如果未設定語彙基元，辨識器則會比對單字清單和字典中儲存的詞彙。
CoerceToFactoid 屬性會判斷辨識器是否將傳回與字典或單字清單中不相符的詞彙。如果這個屬性是設定為 true，而且手寫的片語和詞彙比對失敗，辨識器會傳回 nothing。如果 CoerceToFactoid 是設定為 false，辨識器會順利比對出結果，但可能傳回字典或單字清單中不存在的字串。
下表摘要列出指定這些屬性不同設定組合的情況下可能的傳回值。
個人小檔案 |
CoerceToFactoid |
可能的傳回值 |
|---|---|---|
不包含 (!IS_PHRASELIST) 或 "WORDLIST" |
false |
來自單字清單或字典的值，或是未列出的結果。 |
包含 (!IS_PHRASELIST) 或 "WORDLIST" |
false |
來自單字清單的值，或是未列出的結果。 |
包含 "(!IS_PHRASELIST)" 或 "WORDLIST" |
true |
來自單字清單的值，或是 nothing。 |
如果將字串加入至單字清單，也會隱含加入其大寫版本。例如，加入 "hello" 會隱含加入 "Hello" 和 "HELLO"。
若要傳回提示的單字清單，請使用 GetWordlist。
在分析期間，如果套用於筆劃的筆墨分析器不支單字清單，則筆墨分析器會產生 AnalysisWarning，而其 WarningCode() 屬性會設定為 System.Windows.Ink.AnalysisWarningCode 值 WordlistNotSupported。
範例
這個範例會為 InkAnalyzer (名為 theInkAnalyzerWithHint) 建立 AnalysisHintNode (名為 theAnalysisHint)，並且讓 theAnalysisHint 成為全域提示。然後將單字清單加入至提示，再設定提示的名稱。
' Add a new, global analysis hint to theInkAnalyzerWithHint.
Dim theAnalysisHint As AnalysisHintNode = Me.theInkAnalyzerWithHint.CreateAnalysisHint()
theAnalysisHint.Location.MakeInfinite()
theAnalysisHint.SetWordlist(Me.theWordList)
theAnalysisHint.Name = "Wordlist"
// Add a new, global analysis hint to theInkAnalyzerWithHint.
AnalysisHintNode theAnalysisHint =
this.theInkAnalyzerWithHint.CreateAnalysisHint();
theAnalysisHint.Location.MakeInfinite();
theAnalysisHint.SetWordlist(this.theWordList);
theAnalysisHint.Name = "Wordlist";
平台
Windows Vista
.NET Framework 和 .NET Compact Framework 並不支援各種平台的所有版本。如需支援平台版本的相關資訊，請參閱 .NET Framework 系統需求。
版本資訊
.NET Framework
支援版本：3.0