C# ToolTipk控件的用法（附带实例）

ToolTip 可以翻译为提示说明，图标为：


当鼠标光标放在该控件上时，会出现小矩形弹出窗口显示控件的简短说明，这个工具图标的位置可以参考下图：


这个不是应用在窗体 (Form) 上的工具，而是供控件使用的幕后工具。和 ImageList 一样，创建 ToolTip 对象成功后，此对象也不在窗体内显示，而在窗体的下方显示，可以参考上图右侧。

C# ToolTip常用属性

ToolTip 的许多属性和其他控件的相同，可以在属性窗口设定，或是使用程序代码设定。比较不一样的是，创建 ToolTip 工具后，原先窗体的控件会增加 ToolTip 属性，用户可以在此输入该控件的提示说明。

下列是 ToolTip 控件几个常用的属性：

ToolTip属性名称	说明
Active	是否有作用，默认是 true。如果是 false，则此工具没有作用。如果要将其设定为 false，则程序如下所示： toolTip1.Active = false
AutomaticDelay	可以应用在 AutoPopDelay 和 InitialDelay 中，设定自动延迟时间显示 ToolTip 文字。单位是毫秒，1000 等于 1 秒。
AutoPopDelay	可以设定显示提示说明文字的时间长度。
InitialDelay	设定光标指向控件的时间必须满足一定的长度，才会显示提示说明文字。
IsBalloon	气球样式窗口显示，默认是 false，表示提示文字是用小矩形窗口显示。如果设为 true，提示文字是用气球样式窗口显示。
ReshowDelay	当光标从一个控件移到另一个控件，显示后面提示文字所花费的时间，单位是毫秒。
ToolTipTitle	提示信息的标题。

C# ToolTip常用方法

使用 SetToolTip() 方法可以为特定控件创建提示说明，语法如下：

toolTip1.SetToolTip(控件, 提示说明文字);

【实例 1】提示说明文字在显示按钮 (btnShow) 和 pictureBox1 中的应用。

using System;
using System.Drawing;
using System.Windows.Forms;

namespace ch
{
    public partial class Form1 : Form
    {
        public Form1()
        {
            InitializeComponent();
        }

        // 窗体加载事件
        private void Form1_Load(object sender, EventArgs e)
        {
            // 为按钮设置提示信息
            toolTip1.SetToolTip(btnShow, "执行显示图像");
            // 为图片框设置提示信息
            toolTip1.SetToolTip(pictureBox1, "图像位置");
            // 设置提示框的标题
            toolTip1.ToolTipTitle = "我的提示讯息";
        }

        // 显示按钮点击事件
        private void btnShow_Click(object sender, EventArgs e)
        {
            // 加载图像并显示
            pictureBox1.Image = new Bitmap("school.jpg");
            // 设置图像显示模式为拉伸
            pictureBox1.SizeMode = PictureBoxSizeMode.StretchImage;
        }
    }
}

执行结果为：