用途
本技能用于在 .NET MAUI 应用中实现 Syncfusion .NET MAUI Popup（SfPopup）控件，以显示提示消息、自定义视图和模态对话框，并提供丰富的定位与自定义选项。
主要能力
SfPopup 是一个多用途布局控件，具备以下能力：
- 灵活定位：居中、绝对坐标、相对于任意视图、全屏。
- 可定制布局：页眉、正文和页脚，支持模板与自定义样式。
- 外观模式：单按钮或双按钮页脚布局。
- 模态支持：在弹窗关闭前阻止背景交互。
- 动画：内置缩放、淡入淡出和滑动动画。
- 自动尺寸调整：根据内容尺寸自动调整。
- MVVM 支持：完整的数据绑定和命令支持。
使用方式
技能文档按主题组织，包含以下参考文件：
- 入门与安装（references/getting-started.md）：NuGet 包安装（Syncfusion.Maui.Toolkit）、在 MauiProgram.cs 中注册处理器、基本弹窗初始化（XAML 和 C#）、显示与关闭弹窗、首个弹窗实现、原生嵌入（Android/iOS）。
- 定位选项（references/positioning.md）：使用 IsOpen 或 Show() 居中定位、按 x/y 坐标绝对定位、相对于任意视图定位、带偏移量的绝对相对定位、全屏模式、MVVM 定位模式、定时自动关闭、在操作栏上方定位、使用 ShowAsync() 返回结果。
- 布局自定义（references/layout-customization.md）：外观模式（OneButton、TwoButton）、显示/隐藏页眉、页脚、关闭按钮、自定义页眉模板、自定义页脚模板、自定义内容模板、页眉和页脚高度、按钮文本自定义、Message 属性、禁用覆盖层背景。
- 尺寸与动画（references/sizing-and-animations.md）：宽度和高度配置、自动尺寸模式（Height、Width、Both、None）、全屏弹窗模式、动画类型（Zoom、Fade、SlideOnLeft、SlideOnRight、SlideOnTop、SlideOnBottom）、动画时长与缓动、自定义动画效果。
- 事件与模态行为（references/events-and-modal.md）：弹窗生命周期事件（Opening、Opened、Closing、Closed）、事件参数与取消、模态模式配置、覆盖层交互设置、点击覆盖层关闭行为、接受和拒绝按钮事件。
- 样式与外观（references/styling-and-appearance.md）：页眉样式、页脚样式、消息/内容样式、边框自定义、覆盖层背景样式、模糊效果、背景样式、阴影效果、样式示例。
- 高级集成与示例（references/advanced-integration.md）：在弹窗中显示 ListView、DataGrid 单元格点击集成、Switch 控件绑定示例、带命令的 MVVM 模式、本地化支持、从旧版本迁移、最佳实践与模式。
适用场景
在以下情况使用本技能：
- 在 .NET MAUI 应用中显示提示消息、确认或通知。
- 显示需要用户交互的模态对话框。
- 创建带自定义页眉、页脚和内容的弹窗。
- 将弹窗定位到特定位置（居中、绝对、相对于视图）。
- 显示信息覆盖层而无需导航到新页面。
- 实现工具提示、上下文菜单或浮出内容。
- 显示加载指示器或进度对话框。
- 创建全屏模态体验。
- 在弹窗中显示自定义视图（ListView、DataGrid、表单）。
- 通过按钮回调处理接受/拒绝用户操作。
限制
资料未提供关于收费、价格、平台兼容性细节或具体效果保证的信息。