通过

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，则当识别器未能将手写内容与任何词条相匹配时，将不会返回任何内容。如果 CoerceToFactoid 设置为 false，则识别器会提供匹配的结果，但返回的字符串可能是字典和单词列表中都没有的字符串。

下表总结了这些属性设置的各种组合可能得到的返回值：

Factoid

CoerceToFactoid

可能的返回值

不含 (!IS_PHRASELIST) 或“WORDLIST”

false

单词列表或字典中的某个值，或者某个未列出的结果。

包含 (!IS_PHRASELIST) 或“WORDLIST”

false

单词列表中的某个值，或者某个未列出的结果。

包含“(!IS_PHRASELIST)”或“WORDLIST”

true

单词列表中的某个值，或者没有任何内容。

如果将某个字符串添加到单词列表中，同时也会隐式添加该字符串的大写版本。例如，添加“hello”时将隐式添加“Hello”和“HELLO”。

若要返回提示的单词列表，请使用 GetWordlist。

分析期间，如果应用于笔画的墨迹识别器不支持单词列表，那么墨迹分析器将会生成 AnalysisWarning，并且其 WarningCode 属性设置为 Microsoft.Ink.AnalysisWarningCode 值 WordlistNotSupported。

示例

此示例为 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

另请参见

参考

AnalysisHintNode 类

AnalysisHintNode 成员

Microsoft.Ink 命名空间