本示例展示如何使用工具提示控制器,为 XtraGrid 控件和一个标准的 CheckBox 控件所显示的工具提示的外观提供集中管理。 假设在窗体中已经包含这些控件。
首先放置一个 ToolTipController 组件到窗体中。 修改此组件的工具提示设置,如下图所示:
然后你需要把这个工具提示控制器绑定到 XtraGrid 控件。 Developer Express 控件和组件可以通过它们的 ToolTipController 属性绑定到工具提示控制器。 这个属性在控件、容器控件和容器组件的基础类中声明。 一旦工具提示控制器被指派到控件,就可以对控件的工具提示的外观和行为进行控制。 那些 ToolTipController 属性没有初始化的 Developer Express 控件的工具提示设置,由静态的 ToolTipController.DefaultController 属性控制。
因此,可使用 XtraGrid 控件的 BaseControl.ToolTipController 属性来绑定工具提示控制器:
下面的插图展示了为那些文本被省略的网格单元格而显示的工具提示。 该提示使用了已指派的 ToolTipController 的设置。
标准的复选框不支持 DevExpress.Utils.IToolTipControlClient 接口,但是它也可以显示由工具提示控制器管理的工具提示。 当 ToolTipController 组件被放置到窗体上时, 那些不支持 DevExpress.Utils.IToolTipControlClient 接口的控件的 ToolTip 属性被自动公布。 使用此属性来为复选框指定工具提示文本,如下图所示。
下一幅插图显示了为复选框激活的工具提示。
上述所有步骤都可以被程序化执行:
C# | 复制代码 |
---|---|
using DevExpress.Utils; // Create and initialize the tooltip controller. ToolTipController tooltipController = new ToolTipController(); tooltipController.Rounded = true; tooltipController.ShowBeak = true; // Bind the created tooltip controller to the XtraGrid control. gridControl1.ToolTipController = tooltipController; // Specify the hint for the check box. tooltipController.SetToolTip(checkBox1, "Show cell hints"); |
Visual Basic | 复制代码 |
---|---|
Imports DevExpress.Utils ' Create and initialize the tooltip controller. Dim tooltipController As ToolTipController = New ToolTipController() tooltipController.Rounded = true tooltipController.ShowBeak = true ' Bind the created tooltip controller to the XtraGrid control. GridControl1.ToolTipController = tooltipController ' Specify the hint for the check box. tooltipController.SetToolTip(CheckBox1, "Show cell hints") |