跳转到主要内容
此对象用于处理用户字典和字典扩展。用户字典是包含某种语言单词词形的字典。字典中的每个词形都有自己的权重；在识别某个单词时，如果出现多个变体，该权重用于确定其优先级。权重可以取一组离散值，范围为 0 到 100。用户字典可关联到 BaseLanguage 对象——该对象表示一种基础识别语言。只有支持标准字典的语言才能有字典扩展。 可以通过 LanguageDatabase 对象的 CreateNewDictionary、OpenExistingDictionary 或 OpenDictionaryExtension 方法获取指向字典对象接口的指针。OpenExistingDictionary 方法可以打开通过 CreateNewDictionary 方法创建的字典。OpenDictionaryExtension 提供对字典扩展接口的访问。
在 Windows 中，Edit 方法会显示字典对话框，用户可在其中编辑字典，并导入任何采用 Windows ANSI 或 Unicode 编码的文本文件 (唯一要求是单词之间必须以空格或其他非字母字符分隔) 。

​
属性

名称类型描述
ApplicationEngine, 只读返回 Engine 对象。
NameBSTR存储字典名称。在 Windows 中，此名称会显示在字典对话框的标题栏中。创建字典对象后，此属性存储字典文件名 (不含路径和扩展名) 。您可以为其指定其他任意值。此属性不会保存到与字典关联的文件中，因此每次编辑字典时都应重新初始化。
WordsCountint, 只读返回字典中的单词数量。

​
方法

名称说明
AddWord向字典中添加一个词。
AddWords向字典中添加一组词。
DeleteAllWords从字典中删除所有词。
DeleteWord从字典中删除一个词。
DeleteWords从字典中删除一组词。
Edit <Note> 适用于 Windows。 </Note>显示供用户编辑字典的字典对话框。
EnumWords返回一个 EnumDictionaryWords 类型的对象，可用于遍历字典中的词。

​
输出参数

此对象是 LanguageDatabase 对象中 CreateNewDictionary、OpenExistingDictionary 和 OpenDictionaryExtension 方法的输出参数。

​
示例

// 此示例代码将创建一个用户字典并将其分配给基础语言
FREngine.IEngine engine;
string dictionaryFileName = "D:\\Sample.amd";
FREngine.IBaseLanguage baseLanguage;
// 创建新字典
ILanguageDatabase languageDatabase = Engine.CreateLanguageDatabase();
IDictionary dictionary = languageDatabase.CreateNewDictionary( dictionaryFileName,
 LanguageIdEnum.LI_EnglishUnitedStates );
dictionary.Name = "SampleUserDictionary";
// 向字典添加单词
dictionary.AddWord( "the", 100 );
dictionary.AddWord( "a", 100 );
dictionary.AddWord( "an", 100 );
// 获取基础语言的字典描述集合，并删除所有项
IDictionaryDescriptions dictionaryDescriptions = baseLanguage.DictionaryDescriptions;
dictionaryDescriptions.DeleteAll();
// 创建用户字典描述并将其添加到集合中
IDictionaryDescription dictionaryDescription = dictionaryDescriptions.AddNew( DictionaryTypeEnum.DT_UserDictionary );
IUserDictionaryDescription userDictionaryDescription = dictionaryDescription.GetAsUserDictionaryDescription();
userDictionaryDescription.FileName = dictionaryFileName;
该对象会在以下适用于 Linux 和 Windows 的代码示例中使用：CustomLanguage。

​
另请参阅

UserDictionaryDescription 使用词典 属性的使用