在 Developer Express 控件和任何其他控件中, ToolTipController 组件提供了对工具提示的外观和行为的集中管理。 工具提示控件器的这一功能通过 ToolTipController 类封装。 本主题提供了关于 ToolTipController 组件的一般信息,并列出了影响工具提示外观的主要设置。
工具提示控制器
ToolTipController 提供了允许定制工具提示外观和行为的属性。 为了激活工具提示管理,ToolTipController 组件必须绑定到控件上。 因此如果多个控件被绑定到相同的 ToolTipController,那么它们将有相同的外观与感觉、行为。
注意 |
---|
DevExpress 控件不一定要绑定到 ToolTipController 组件。 如果它们没有绑定到 ToolTipController,那么这些控件的工具提示通过静态的 Default ToolTipController 接管。 请参阅下面的小节来获得更多信息。 |
通常工具提示的内容(标题、文本和图标)由显示工具提示的控件确定。 但是,对于任何控件和控件元素,ToolTipController 公开了动态定制工具提示内容与外观的事件。
下表列出了在 ToolTipController 类中声明的主要属性和事件:
属性,事件 | 说明 |
---|---|
ToolTipController.Appearance | 指定工具提示的外观设置。 |
ToolTipController.AppearanceTitle | 包含工具提示标题的外观设置。 |
ToolTipController.AutoPopDelay | 工具提示显示的时间间隔长度。 |
ToolTipController.IconSize | 指定工具提示内部图标的大小。 |
ToolTipController.InitialDelay | 在把指针放置到可视化元素上之后,工具提示被显示之前的时间期限。 |
ToolTipController.Rounded | 指定工具提示的边角是否被处理为圆角。 |
ToolTipController.RoundRadius | 指定工具提示圆角的半径。 |
ToolTipController.ShowBeak | 指定工具提示的标注尖嘴是否显示。 |
ToolTipController.ShowShadow | 指定是否显示工具提示的阴影。 |
ToolTipController.ToolTipLocation | 指定工具提示的位置。 |
ToolTipController.BeforeShow | 在工具提示在屏幕上显示前,让你能定制工具提示的文本和设置。 |
ToolTipController.CalcSize | 让你能指定工具提示窗口的位置和大小。 |
ToolTipController.CustomDraw | 让你能定制工具提示区域的绘制。 |
默认的工具提示控制器
为了激活工具提示的定制和管理,不一定要把 ToolTipController 组件放置到窗体上并把它绑定到控件。 你可以改用 Default ToolTipController 组件,在缺省时用来管理任意控件的工具提示。 在代码中,Default ToolTipController 可以通过静态的 ToolTipController.DefaultController 属性进行访问。 要在设计时刻访问它, 需要把 DefaultToolTipController 组件放置到窗体上。
你可以定制这些设置,并订阅 Default ToolTipController 的事件,这与使用常规 ToolTipController 组件的方式是相同的。
提供了 ToolTipController 属性的 DevExpress 控件和组件的注意事项: 如果此属性被设置为 ToolTipController 类型的一个实例,那么该控件的工具提示将被已指派的 ToolTipController 接管,而不是默认的 Default ToolTipController。
工具提示控制器的使用方案
下表列出了为控件定制工具提示的共同方案。
任务 | 方案 |
---|---|
为应用程序模型内的所有控件的工具提示提供集中管理。 | 使用 Default ToolTipController。 |
为不同的控件定制不同的工具提示。 |
- 把不同的 ToolTipController 组件指派到不同的控件。 Default ToolTipController 可以用于管理那些没有设置 ToolTipController 属性的控件的工具提示。
- 为所有控件使用单个 ToolTipController 组件,并接管它的事件来动态定制工具提示。 |