用途
本技能面向在 .NET MAUI 项目中使用 Syncfusion .NET MAUI Button（SfButton）控件的开发场景。SfButton 是一个自定义按钮控件，在标准 MAUI 按钮的基础上扩展了高级 UI 定制能力，适合需要统一按钮外观、状态反馈或图标化按钮的界面开发。
主要能力
根据资料，SfButton 具备以下特性：
- 灵活样式：支持轮廓（outline）、扁平（flat）、圆形（circle）或图标按钮类型。
- 丰富内容：支持图标、背景图片和自定义视图。
- 视觉状态：内置对悬停、按下、选中和禁用状态的支持。
- 无障碍：支持 RTL（从右到左）和键盘导航。
- 易于集成：可通过 XAML 或 C# 实现。
使用方式
技能内容按主题组织为若干参考文档，并给出建议的阅读时机：
- 入门（references/getting-started.md）：安装、初始设置、首次实现。包括 NuGet 包安装（Syncfusion.Maui.Toolkit）、在 MauiProgram.cs 中注册 Handler、在 XAML 和 C# 中实现基础按钮、使用 ImageSource 与 ShowIcon 添加按钮图标、使用 BackgroundImageSource 设置背景图片，以及最小可运行示例。
- 自定义与样式（references/customization.md）：外观定制、按钮样式、布局控制。包括文本定制（颜色、大小、字体、对齐）、背景色与边框样式、圆角与内边距调整、尺寸控制（宽高）、图片宽度与定位、对齐选项（水平、垂直）以及完整样式示例。
- 视觉状态（references/visual-states.md）：基于状态的样式、悬停效果、切换按钮、交互反馈。包括视觉状态概览（Normal、Hovered、Pressed、Checked、Disabled）、实现 VisualStateManager、使用 IsCheckable 创建可勾选/切换按钮、为各状态自定义外观、状态转换处理以及完整状态管理示例。
- 高级功能（references/advanced-features.md）：RTL 支持、现代效果、自定义内容、事件、迁移。包括从右到左（RTL）语言支持、在按钮内添加自定义内容视图、点击事件处理（Clicked 事件）、高级场景与组合，以及从旧版本迁移。
- 故障排查（references/troubleshooting.md）：问题、错误、异常行为、最佳实践。包括常见问题与解决方案、Handler 注册错误、图片加载问题、布局与尺寸问题、视觉状态不更新，以及平台特定注意事项。
适用场景
当需要完成以下任务时，可使用本技能：在 .NET MAUI 项目中安装和设置 SfButton；创建带文本和图标的基础或自定义按钮；实现视觉状态（正常、悬停、按下、选中、禁用）；为按钮添加背景图片或自定义内容；处理按钮点击事件；创建切换/可勾选按钮；应用 RTL 支持；自定义按钮外观（颜色、字体、边框、内边距）；排查按钮相关问题。
限制
资料未提供具体的版本兼容范围、平台支持矩阵、性能数据或授权与收费信息，这些内容暂未提供。实际使用时应以官方文档和项目环境为准。