动态填充AutoCompleteBox与RichTextBox的使用解析

### 动态填充 AutoCompleteBox 与 RichTextBox 的使用解析 #### 1. 动态填充 AutoCompleteBox 在使用 AutoCompleteBox 时，通常会使用 `ItemsSource` 属性来填充建议列表。但当需要从其他地方获取信息，或者列表过大不适合一次性加载时，就需要采用不同的方法，即实时设置 `ItemsSource`。 ##### 1.1 基本设置 要实现实时填充，需将 `FilterMode` 属性设置为 `None`，并处理 `Populating` 事件。示例代码如下： ```xml <input:AutoCompleteBox x:Name="acbProducts" FilterMode="None" Populating="acbProducts_Populating" ></input:AutoCompleteBox> ``` ##### 1.2 处理 Populating 事件的两种方式 当 `Populating` 事件触发时，有两种选择： - **立即设置 ItemsSource**：如果建议列表就在手边或能快速生成，可立即设置 `ItemsSource`，建议列表会立即显示在下拉列表中。 - **启动异步进程**：在很多情况下，获取建议列表可能是一个耗时的步骤，如进行一系列计算或查询 Web 服务。此时需要启动异步进程。在 `Populating` 事件处理程序中，需将 `PopulatingEventArgs.Cancel` 设置为 `true` 以取消正常处理，然后启动异步操作。示例代码如下： ```csharp private void acbProducts_Populating(object sender, PopulatingEventArgs e) { // 表示任务正在异步执行 e.Cancel = true; // 创建 Web 服务对象 ProductAutoCompleteClient service = new ProductAutoCompleteClient(); // 为完成事件附加事件处理程序 service.GetProductMatchesCompleted += GetProductMatchesCompleted; // 调用 Web 服务（异步） service.GetProductMatchesAsync(e.Parameter); } ``` ##### 1.3 Web 服务端代码 在 Web 服务器上，`GetProductMatches()` 方法运行并检索匹配项： ```csharp public string[] GetProductMatches(string inputText) { // 获取产品（例如，从服务器端数据库） Product[] products = GetProducts(); // 创建匹配项集合 List<string> productMatches = new List<string>(); foreach (Product product in products) { // 检查是否匹配 if ((product.ProductName.StartsWith(inputText)) || (product.ProductCode.Contains(inputText))) { productMatches.Add(product.ProductName); } } // 返回匹配项列表 return productMatches.ToArray(); } ``` ##### 1.4 异步操作完成后的处理 当异步操作完成并收到结果时，需填充 `ItemsSource` 属性，并调用 `PopulateComplete()` 方法通知 AutoCompleteBox 新数据已到达。示例代码如下： ```csharp private void GetProductMatchesCompleted(object sender, GetProductMatchesCompletedEventArgs e) { // 检查 Web 服务错误 if (e.Error != null) { lblStatus.Text = e.Error.Message; return; } // 设置建议列表 acbProducts.ItemsSource = e.Result; // 通知控件数据已到达 acbProducts.PopulateComplete(); } ``` ##### 1.5 调整属性 在填充 AutoCompleteBox 时，可调整两个属性： - **MinimumPrefixLength**：确定在 AutoCompleteBox 给出建议之前必须输入的文本长度。默认情况下，输入第一个字母后就会提供建议。若想等待输入三个字母，可将 `MinimumPrefixLength` 设置为 3。 - **MinimumPopupDelay**：可强制 AutoCompleteBox 在用户最后一次按键后等待一定时间再显示建议，避免对慢速 Web 服务进行大量重叠调用。 #### 2. RichTextBox 的使用 RichTextBox 是一个支持丰富格式的可编辑文本框控件，与普通的 TextBox 不同，它允许对单个部分（如单个单词或整个段落）进行不同字体和颜色的格式化，还支持图像、链接和内联元素。 ##### 2.1 文本元素模型 在理解 RichTextBox 之前，需要了解其使用的文本元素模型。RichTextBox 包含一个文档，由文本元素集合表示，这些元素分为两个关键分支： - **块元素**：有两个块元素类，即 `Paragraph` 和 `Section`。`Paragraph` 可以包含文本和内联元素的组合，`Section` 可以包含一组段落（或一组 `Section`），但必须通过编程方式创建，不能在 XAML 中使用。 - **内联元素**：嵌套在块元素（或另一个内联元素）中，包括用于格式化文本的元素（`Bold`、`Italic`、`Underline`、`Run`）、硬换行元素（`LineBreak`）、添加超链接的元素（`Hyperlink`）和嵌入其他控件的元素（`InlineUIContainer`）。`Span` 容器可将多个内联元素组合在一起。 以下是一个包含预填充内容的 RichTextBox 示例： ```xml <RichTextBox Margin="5" x:Name="richText"> <Paragraph Foreground="DarkRed" FontFamily="Trebuchet MS" FontSize="22" FontWeight="Bold" TextAlignment="Center">Chapter I</Paragraph> <Paragraph> <Bold><Italic><Run FontSize="12">The Period</Run></Italic></Bold> </Paragraph> <Paragraph> It was the best of times, it was the worst of times, it was the age of ... <LineBreak></LineBreak> </Paragraph> <Paragraph> There were a king with a large jaw and a queen with a plain face, on the ... </Paragraph> </RichTextBox> ``` ##### 2.2 文本元素的格式化 有两种主要的格式化方法： - **使用文本元素类的属性**：大多数属性继承自基类 `TextElement`。可设置的属性如下表所示： | 属性名 | 描述 | | ---- | ---- | | Foreground | 接受用于绘制前景文本的画笔，不能为单个文本元素设置背景，但可使用 `RichTextBox.Background` 属性为整个文档设置背景。 | | FontFamily, FontSize, FontStretch, FontStyle, FontWeight | 允许配置用于显示文本的字体。 | | TextAlignment | 设置嵌套文本内容的水平对齐方式（可以是 Left、Right、Center 或 Justify，通常内容是两端对齐）。 | | TextDecorations | 允许在文本下方添加线条，此属性仅适用于内联对象。 | - **使用嵌套元素自动应用格式化**：如 `Bold`、`Italic` 或 `Underline`。实际上，这种方法是第一种方法的子集，因为使用格式化元素只是使用具有相同格式的 `Run` 或 `Span` 的便捷方式。 ##### 2.3 编程操作文本元素 可以通过编程方式探索和创建文档。RichTextBox 内容的入口点是 `Bl