SpellCheck.CustomDictionaries 属性
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
获取用于自定义拼写检查的词典文件位置的集合。
public:
property System::Collections::IList ^ CustomDictionaries { System::Collections::IList ^ get(); };
public System.Collections.IList CustomDictionaries { get; }
member this.CustomDictionaries : System.Collections.IList
Public ReadOnly Property CustomDictionaries As IList
属性值
词典文件位置的集合。
示例
以下示例演示如何将两个 RichTextBox自定义字典添加到 。 在 XAML 中添加了第一个自定义字典 (customwords.lex) 。 该文件作为内容文件包含在应用程序中,并复制到输出目录。 若要使用 Uri 元素,必须包含 System 命名空间。
xmlns:sys="clr-namespace:System;assembly=System"
第二个自定义字典 (customwords2.lex) 添加到事件处理程序中 Click 。 该文件作为资源文件包含在内,并编译到名为 WPFCustomDictionary 的应用程序程序集中。
<RichTextBox Margin="38,18,40,0" Name="richTextBox1" Height="45" VerticalAlignment="Top" SpellCheck.IsEnabled="True" >
<SpellCheck.CustomDictionaries>
<!-- customwords.lex is included as a content file-->
<sys:Uri>pack://application:,,,/customwords.lex</sys:Uri>
</SpellCheck.CustomDictionaries>
</RichTextBox>
private void button1_Click(object sender, RoutedEventArgs e)
{
IList dictionaries = SpellCheck.GetCustomDictionaries(richTextBox1);
// customwords2.lex is included as a resource file
dictionaries.Add(new Uri(@"pack://application:,,,/WPFCustomDictionary;component/customwords2.lex"));
}
Private Sub button1_Click(ByVal sender As System.Object, ByVal e As System.Windows.RoutedEventArgs)
Dim dictionaries As IList = SpellCheck.GetCustomDictionaries(richTextBox1)
' customwords2.lex is included as a resource file
dictionaries.Add(New Uri("pack://application:,,,/WPFCustomDictionary;component/customwords2.lex"))
End Sub
注解
自定义词典使用词典文件,这些文件是扩展名为 .lex 的文本文件。 词典文件的每一行都包含一个接受为合法拼写的单词。 文件的第一行可以指定字典适用的 LCID) (区域设置标识符。 如果未指定区域设置,字典将应用于所有语言。 有关详细信息,请参阅 区域设置 ID。 以下示例显示了英语词典文件的前几行。
#LID 1033
TextBlock
TextBox
ListBox
若要为 TextBox 或 为派生自 TextBoxBase的任何类指定一个或多个自定义字典,请通过将文件的 URI 添加到 CustomDictionaries 集合来指定词典文件的位置。
注意
使用 Insert 将文件添加到集合会导致 CustomDictionaries 异常。 请改用 Add 和 Remove 来更新集合。
词典文件可以作为安装在本地计算机上的内容文件或编译为本地引用程序集的资源文件包含在应用程序中。 可以使用 pack URI 引用文件。 有关详细信息,请参阅 WPF 中的 Pack URI。
若要启用拼写检查器,请在 SpellCheck.IsEnabled 或派生自 TextBoxBase的任何类上TextBox将 属性true
设置为 。 除默认拼写检查器外, TextBox 还会使用的所有自定义词典。 有关拼写检查器的详细信息,请参阅 SpellCheck。