Winforms：把长ToolTip显示为多行

ToolTip在Windows中是一个常用的显示信息的手段。当ToolTip的信息很长的时候，我们最好能够显示为多行。也就是当ToolTip的信息的长度超过某一阈值的时候，最好显示为多行。Windows是提供了这样的API。非常遗憾的是，Winforms到目前为止暂时还不支持多行的ToolTip。如何在Winforms中设置ToolTip的最大长度，是Winforms程序员经常问到的一个问题。

         Windows是通过发送TTM_SETMAXTIPWIDTH消息来设置ToolTip的最大长度的。因此，我们在Winforms中可以先得到一个ToolTip的句柄，然后向该句柄发送消息。这里我们需要做两件事：

1.       得到ToolTip的句柄。由于Handle是ToolTip的一个internal属性，在ToolTip的外部不能直接得到。好在.Net提供了反射机制，我们可以用反射来得到一个ToolTip的句柄。

2.       给ToolTip发送消息。Winforms没有直接提供发送消息的方法，因此我们必须通过P/Invoke调用Windows API SendMessage。

做好了这两方面的准备，我们就可以写出如下的代码：

    internal class Utility

    {

        private const int TTM_SETMAXTIPWIDTH = (0x400 + 24);

 

        [DllImport("User32.dll")]

        private static extern IntPtr SendMessage(HandleRef hwd,

            int msg,

            int wParam,

            int lParam);

 

        // Handle is an internal property of ToolTip,

        // so we need reflection to get a toolTip's Handle

        private static IntPtr GetToolTipHandle(ToolTip toolTip)

        {

            Type type = typeof(ToolTip);

            BindingFlags flags = BindingFlags.GetProperty

                | BindingFlags.NonPublic

                | BindingFlags.Instance;

            Object obj = type.InvokeMember("Handle", flags, null, toolTip, null);

 

            if ((IntPtr)obj == null)

                throw new InvalidProgramException();

 

            return (IntPtr)obj;

        }

 

        // send a TTM_SETMAXTIPWIDTH message to a toolTip,

        // to set its maximum length

        public static void SetToolTipMaxLength(ToolTip toolTip, int maxLength)

        {

            IntPtr toolTipHandle;

            toolTipHandle = GetToolTipHandle(toolTip);

 

            Utility.SendMessage(new HandleRef(toolTip, toolTipHandle),

                TTM_SETMAXTIPWIDTH,

                0,

                maxLength);

        }

    }

接下来我们创建一个Winforms项目来验证我们的办法是不是有效，步骤如下：

1.       创建一个新Winforms项目；

2.       为Form1添加一个按钮，button1，和一个ToolTip，toolTip1；

3.       打开属性窗口；

4.       选择button1，为属性ToolTop on toolTip1设置一个比较长的字符串；

5.       在属性窗口选择事件页面，为button1添加MouseEnter事件处理器；

6.       编辑Button1_MouseEnter的代码如下：

const int maxLength = 200;

private void button1_MouseEnter(object sender, EventArgs e)

{

    Utility.SetToolTipMaxLength(toolTip1, maxLength);

}

7.       编译并运行；

8.       把鼠标停在button1上，我们发现很长的ToolTip已经显示为多行，如下面的截图所示：