syncfusion-maui-checkbox

在 .NET MAUI 中实现复选框

Syncfusion .NET MAUI CheckBox（SfCheckBox）是一种选择控件，允许用户从一组选项中选择一个或多个选项。它支持三种状态（选中、未选中、未确定）、丰富的视觉自定义选项，以及事件驱动的状态管理。

何时使用此技能

当用户需要进行以下操作时，请使用此技能：

• 在 .NET MAUI 应用程序中实现复选框控件
• 添加选择控件，用于单选或多选场景
• 创建支持未确定状态的三态复选框
• 自定义复选框外观（颜色、形状、大小、文本）
• 处理复选框事件（StateChanged、StateChanging）
• 使用 VisualStateManager 应用视觉状态
• 构建复选框组，用于多选场景（例如设置、表单、筛选器）
• 实现父子复选框层级结构，并支持全选功能
• 创建条款和条件接受界面
• 使用 MAUI 样式添加无障碍选择控件

组件概述

SfCheckBox 控件提供：

• 三态支持：选中、未选中和未确定状态
• 视觉自定义：颜色、圆角半径、描边粗细、勾选标记颜色
• 文本自定义：字体、颜色、对齐方式、换行模式
• 事件处理：StateChanged 和 StateChanging 事件
• 视觉状态管理器：为每种状态自定义外观
• 动画控制：启用或禁用状态更改动画

文档和导航指南

入门和安装

📄 阅读： references/getting-started.md

阅读时机：用户首次设置 SfCheckBox、需要安装步骤或想查看基本实现示例时。

涵盖主题：

• 安装 Syncfusion.Maui.Buttons NuGet 包
• 注册 Syncfusion 处理程序（ConfigureSyncfusionCore）
• 基本 CheckBox 实现（XAML 和 C#）
• 设置复选框标题文本
• 了解三种状态（选中、未选中、未确定）
• 单个复选框场景（服务条款、协议）
• 多个复选框组（多选选项）
• 使用父子关系实现中间状态
• 全选复选框模式

视觉自定义

📄 阅读： references/visual-customization.md

阅读时机：用户想要自定义复选框外观、更改颜色、调整大小、修改文本样式或控制动画时。

涵盖主题：

• 形状自定义（使用 CornerRadius 设置圆角复选框）
• 状态颜色（CheckedColor、UncheckedColor）
• 描边粗细自定义
• 标题文本外观（TextColor、FontFamily、FontSize、FontAttributes、HorizontalTextAlignment）
• 勾选标记颜色自定义
• LineBreakMode 选项（换行或截断文本）
• 大小自定义（ControlSize 属性）
• 字体自动缩放（FontAutoScalingEnabled）
• 动画控制（EnabledAnimation）
• 复选框与文本之间的内容间距

事件和状态管理

📄 阅读： references/events.md

阅读时机：用户需要响应复选框状态更改、验证选择，或在切换复选框时实现自定义逻辑时。

涵盖主题：

• StateChanged 事件和 StateChangedEventArgs
• StateChanging 事件（状态更改前可取消）
• XAML 和 C# 中的事件处理模式
• 以编程方式更改状态
• 事件驱动的 UI 更新
• 使用 Cancel 属性阻止状态更改
• 协调多个复选框状态

使用 VisualStateManager 设置视觉状态

📄 阅读： references/visual-states.md

阅读时机：用户想使用 VisualStateManager 为选中、未选中或不确定状态设置不同的视觉外观。

涵盖主题：

• SfCheckBox 的 Visual State Manager 概述
• 三种视觉状态（Checked、Unchecked、Intermediate）
• 使用 VisualStateGroups 的 XAML 实现
• 使用 VisualState setters 的 C# 实现
• 为每种状态自定义属性
• 各状态的完整示例