CToolTipCtrl
CObject |
└CCmdTarget |
└CWnd |
└CToolTipCtrl |
CToolTipCtrl类封装了一个“工具提示控件”的性能。工具提示控件是一个小的弹出窗口,它用来显示一行描述应用程序中的一个工具的目的的文本。一个“工具”可以是一个窗口,比如说一个子窗口或控件,或者是一个窗口的客户区中的一个应用程序定义的矩形区域。一个工具提示大多数时间是隐藏的,只有在用户将光标放在一个工具上并停留大约半秒时间时,工具提示才显示出来。工具提示显示在光标的附近,当用户点击鼠标按钮或将光标从工具上离开时,工具提示消失。
CToolTipCtrl提供了一些功能,用来控制工具提示的初始时间和持续时间,工具提示周围的边距宽度,工具提示窗口本身的宽度,以及工具提示的背景和文本颜色。一个工具提示控件可以为多个工具提供信息。
CToolTipCtrl类提供了Windows通用工具提示控件的功能。这个控件(也就是这个CToolTipCtrl类)只对运行在Windows 95和Windows NT 3.51或更高版本下的程序来说是可用的。
有关使能CToolTipCtrl的更多信息,参见“Visual C++程序员指南”中的“控件主题”和“使用CToolTipCtrl”。
#include <afxcmn.h>
请参阅:CToolBar
CToolTipCtrl类成员
构造
CToolTipCtrl | 创建一个CToolTipCtrl对象 |
Create | 创建一个工具提示控件并将它与一个CToolTipCtrl对象连接 |
属性
GetText | 获取一个工具提示控件为一个工具维持的文本 |
GetToolInfo | 获取一个工具提示控件维持的关于一个工具的信息 |
SetToolInfo | 设置一个工具提示控件为一个工具维持的文本 |
GetToolCount | 获取由一个工具提示控件支持的工具数 |
GetDelayTime | 获取当前为一个工具提示控件设置的初始,弹出,和再显示持续时间 |
SetDelayTime | 为一个工具提示控件设置初始,弹出,和再显示持续时间 |
GetMargin | 获取当前为一个工具提示窗口设置的上,左,底,和右边距 |
SetMargin | 为一个工具提示窗口设置上,左,底,和右边距 |
GetMaxTipWidth | 获取一个工具提示窗口的最大宽度 |
SetMaxTipWidth | 设置一个工具提示窗口的最大宽度 |
GetTipBkColor | 获取一个工具提示窗口中的背景颜色 |
SetTipBkColor | 设置一个工具提示窗口中的背景颜色 |
GetTipTextColor | 获取一个工具提示窗口中的文本颜色 |
SetTipTextColor | 设置一个工具提示窗口中的文本颜色 |
操作
Activate | 激活工具提示控件或使它成为不活动的 |
AddTool | 向一个工具提示控件注册一个工具 |
DelTool | 从工具提示控件中删除一个工具 |
HitTest | 测试一个点,以确定它是否位于给定工具的边界矩形之内,如果是,返回关于这个工具的信息 |
RelayEvent | 传递一个鼠标消息给工具提示控件处理 |
SetToolRect | 为一个工具设置一个新的边界矩形 |
UpdateTipText | 为一个工具设置工具提示文本 |
Update | 强制当前工具被重画 |
Pop | 从视中删除一个被显示的工具提示窗口 |