用途
Syncfusion SfToolTip 是面向 Windows Forms 应用的提示(Tooltip)组件,当用户将鼠标悬停在控件上时自动弹出,用于展示上下文信息与悬停文本。它适合需要比系统默认提示更丰富内容的场景,例如多行信息、图片、自定义控件、气球样式提示等。
主要能力
- 多提示项:一个提示中可包含多个 ToolTipItem,每项可单独设置样式。
- 自定义控件:可在提示项中承载任意用户控件(如 PictureBox)。
- 丰富内容:支持文本、图片、渐变背景与分隔线。
- 气球样式:支持带指向控件方向喙(Beak)的气球提示。
- 外观定制:可设置边框颜色与粗细、字体、颜色、对齐、阴影、渐变、分隔线样式等。
- 事件控制:通过 ToolTipShowing 在显示前动态调整外观、位置或取消显示;通过 DrawToolTipItem 自定义绘制。
- 编程控制:可按需显示/隐藏提示,并设置显示位置。
- RTL 支持:支持从右到左布局,用于国际化应用。
使用方式
基本用法是创建 SfToolTip 实例,然后调用 SetToolTip 设置简单文本,或构造 ToolTipInfo 与 ToolTipItem 后调用 SetToolTipInfo 设置结构化内容。可通过 InitialDelay 与 AutoPopDelay 控制显示延迟与停留时长,通过 ToolTipStyle 切换矩形或气球样式,通过 Style 属性定制各项外观。也可调用 Show/Hide 方法以编程方式控制提示。
适用场景
- 表单字段帮助:为输入控件添加说明性提示。
- 按钮操作说明:为工具栏按钮和图标显示操作描述。
- 状态信息:为状态栏项或指示器显示详细状态。
- 用户资料卡:悬停时显示带图片的丰富资料卡。
- 数据校验:在校验控件上显示规则或错误详情。
- 仪表板部件:在图表或部件提示中提供详细指标。
- 禁用控件说明:解释控件为何禁用及何时可用。
- 进度指示:悬停时显示详细进度信息。
- 托盘应用:在系统托盘提示中显示应用状态。
- 多语言支持:结合 RTL 支持显示翻译或补充上下文。
限制与注意事项
资料未提供收费、价格、平台兼容版本等具体信息,暂未提供。使用前需引用 Syncfusion.Core.WinForms.dll 与 Syncfusion.Shared.Base,并通过 NuGet 包 Syncfusion.Core.WinForms 安装。最佳实践建议:提示内容保持简洁;气球样式谨慎使用;避免重复控件标签;根据内容复杂度调整延迟;注意颜色对比度以保证可读性;对频繁悬停的控件避免使用复杂自定义控件;测试 RTL 布局下的显示效果。