MFC CToolTipCtrl 类 公共方法:CToolTipCtrl::Update
在 MFC 中,CToolTipCtrl::Update 方法用于更新工具提示控件的文本和相关属性。这个方法允许你在运行时动态地更改工具提示的内容,以适应应用程序的需求。以下是 CToolTipCtrl::Update 方法的声明:void Update( CWnd* pWndCtrl = NULL, LPCTSTR lpszText = NULL);参数说明: pWndCtrl:指定要更新工具提示的控件。如果为 NULL,则更新当前关联的控件。 lpszText:新的工具提示文本。如果为 NULL,则保持原有的文本。示例用法:// 假设有一个 CToolTipCtrl 对象 m_tooltip 和一个按钮控件 IDC_BUTTON1// 在初始化时为按钮设置工具提示m_tooltip.Create(this, TTS_BALLOON);m_tooltip.AddTool(GetDlgItem(IDC_BUTTON1), _T("这是一个按钮"));// 在某个事件中更新工具提示文本CString newText = _T("新的工具提示文本&qu...
MFC CToolTipCtrl 类 公共方法:CToolTipCtrl::SetWindowTheme
CToolTipCtrl::SetWindowTheme 方法是 MFC(Microsoft Foundation Classes)中 CToolTipCtrl 类的一个公共方法,用于设置工具提示控件的视觉主题。这个方法的作用是为工具提示控件指定视觉主题,以改变其外观和行为。它允许你为工具提示控件应用不同的视觉样式,以适应应用程序的整体外观。具体用法如下:BOOL SetWindowTheme( _In_ LPCWSTR pszSubAppName, _In_ LPCWSTR pszSubIdList);参数说明: pszSubAppName:一个以 null 结尾的字符串,用于指定应用主题的子应用程序名。可以为 nullptr。 pszSubIdList:一个以 null 结尾的字符串,用于指定应用主题的子标识符列表。可以为 nullptr。这个方法通常在创建工具提示控件后调用,以便为其应用特定的主题。示例:CToolTipCtrl m_tooltip;// 在工具提示控件创建后,为其设置视觉主题if (m_tooltip.Create(this, TTS_BALLOON))...
MFC CToolTipCtrl 类 公共方法:CToolTipCtrl::SetToolRect
CToolTipCtrl::SetToolRect 是 MFC 中 CToolTipCtrl 类的一个公共方法,用于设置工具提示控件中某个工具的矩形区域。这个方法的原型如下:void SetToolRect(int nIndex, LPRECT lpRect);其中: nIndex 是工具提示中工具的索引,从 0 开始计数。 lpRect 是指向 RECT 结构的指针,表示工具的矩形区域。这个方法允许你手动指定工具提示控件中某个工具的显示区域,而不是默认使用与工具相关联的控件的区域。使用示例:// 假设 pToolTip 是 CToolTipCtrl 的一个实例int nIndex = 0; // 工具的索引RECT toolRect = {10, 10, 100, 50}; // 自定义的矩形区域pToolTip.SetToolRect(nIndex, &toolRect);在这个示例中,工具提示控件会在指定的矩形区域内显示与索引为 nIndex 的工具相关的信息。
MFC CToolTipCtrl 类 公共方法:CToolTipCtrl::SetTitle
在 MFC(Microsoft Foundation Classes)中,CToolTipCtrl::SetTitle 并不是 CToolTipCtrl 类的一个公共方法。通常,CToolTipCtrl 主要用于显示简单的文本信息而不是标题。如果你需要在工具提示中显示标题,通常是通过在显示的文本中包含标题的方式来实现,而不是通过专门的方法。你可以在调用 AddTool 方法时,将标题和内容合并到文本中。示例:CString tooltipText = _T("Title: This is the content");m_toolTipCtrl.AddTool(GetDlgItem(IDC_MY_CONTROL), tooltipText);在这个示例中,tooltipText 包含标题和内容,通过 AddTool 方法将其关联到相应的控件上。
MFC CToolTipCtrl 类 公共方法:CToolTipCtrl::SetTipTextColor
在 MFC(Microsoft Foundation Classes)中,CToolTipCtrl::SetTipTextColor 是一个公共方法,用于设置工具提示控件的文本颜色。方法的声明如下:void SetTipTextColor(COLORREF clr); clr:表示要设置的文本颜色,是一个 COLORREF 类型的颜色值。通过调用这个方法,你可以更改工具提示控件的文本颜色。示例:COLORREF textColor = RGB(0, 0, 255); // 蓝色m_toolTipCtrl.SetTipTextColor(textColor);在这个示例中,设置了工具提示控件的文本颜色为蓝色。你可以根据实际需求选择合适的颜色值。
MFC CToolTipCtrl 类 公共方法:CToolTipCtrl::SetTipBkColor
在 MFC(Microsoft Foundation Classes)中,CToolTipCtrl::SetTipBkColor 是一个公共方法,用于设置工具提示控件的背景颜色。方法的声明如下:void SetTipBkColor(COLORREF clr); clr:表示要设置的背景颜色,是一个 COLORREF 类型的颜色值。通过调用这个方法,你可以更改工具提示控件的背景颜色。示例:COLORREF backgroundColor = RGB(255, 255, 0); // 黄色m_toolTipCtrl.SetTipBkColor(backgroundColor);在这个示例中,设置了工具提示控件的背景颜色为黄色。你可以根据实际需求选择合适的颜色值。
MFC CToolTipCtrl 类 公共方法:CToolTipCtrl::SetMaxTipWidth
在 MFC(Microsoft Foundation Classes)中,CToolTipCtrl::SetMaxTipWidth 是一个公共方法,用于设置工具提示控件中提示文本的最大宽度。方法的声明如下:void SetMaxTipWidth(int iWidth); iWidth:表示要设置的最大宽度值,单位是像素。通过调用这个方法,你可以限制工具提示控件中提示文本的最大宽度,以确保提示文本不会过宽。示例:m_toolTipCtrl.SetMaxTipWidth(200); // 设置最大宽度为 200 像素在这个示例中,设置了工具提示控件的提示文本最大宽度为 200 像素。你可以根据实际需求调整这个值。
MFC CToolTipCtrl 类 公共方法:CToolTipCtrl::SetMargin
在 MFC(Microsoft Foundation Classes)中,CToolTipCtrl::SetMargin 是一个公共方法,用于设置工具提示控件的边距。方法的声明如下:void SetMargin(CRect& rect); rect:一个 CRect 对象,表示要设置的边距值。CRect 包含了左、上、右、下四个边距的数值。通过调用这个方法,你可以设置工具提示控件中文本与控件边界之间的空白边距。示例:CRect margins(5, 5, 5, 5); // 设置左、上、右、下边距均为 5 像素m_toolTipCtrl.SetMargin(margins);在这个示例中,设置了工具提示控件的边距为 5 像素。你可以根据实际需求调整这些值,以便适应界面布局。
MFC CToolTipCtrl 类 公共方法:CToolTipCtrl::SetDelayTime
在 MFC(Microsoft Foundation Classes)中,CToolTipCtrl::SetDelayTime 是一个公共方法,用于设置工具提示控件的延迟时间。方法的声明如下:BOOL SetDelayTime(DWORD dwDuration, int iTime, int iTimeAuto); dwDuration:表示要设置的延迟时间的类型,可以是以下之一: - TTDT_AUTOMATIC:自动显示的延迟时间。 - TTDT_AUTOPOP:自动弹出延迟时间。 - TTDT_INITIAL:初始显示的延迟时间。 iTime:指定延迟时间的值,单位是毫秒。这个值用于初始显示和自动显示的延迟时间。 iTimeAuto:指定自动弹出的延迟时间值,单位同样是毫秒。通过调用这个方法,你可以设置工具提示控件在不同阶段的延迟时间,以满足特定的显示和隐藏需求。示例:m_toolTipCtrl.SetDelayTime(TTDT_INITIAL, 500); // 设置初始显示的延迟时间为 500 毫秒m_toolTipCtrl.SetDelayTime(TTDT_AU...
MFC CToolTipCtrl 类 公共方法:CToolTipCtrl::RelayEvent
在 MFC(Microsoft Foundation Classes)中,CToolTipCtrl::RelayEvent 是一个公共方法,用于将特定的事件传递给工具提示控件,以便它能够处理这些事件并作出相应的显示或隐藏操作。方法的声明如下:void RelayEvent(LPMSG lpMsg); lpMsg:指向 MSG 结构的指针,表示要传递的消息。通过调用这个方法,你可以将消息传递给工具提示控件,让它能够响应鼠标或键盘事件等。这在需要手动管理工具提示显示和隐藏的情况下可能很有用。示例:MSG msg;// 初始化 msg,例如从消息队列中获取一条消息m_toolTipCtrl.RelayEvent(&msg);这样,工具提示控件就能够处理这个消息,并根据需要显示或隐藏工具提示。这个方法通常用于在特定条件下手动触发工具提示的显示。
MFC CToolTipCtrl 类 公共方法:CToolTipCtrl::HitTest
在 MFC(Microsoft Foundation Classes)中,CToolTipCtrl::HitTest 是一个公共方法,用于执行鼠标命中测试,确定给定的点是否在工具提示控件的某个工具上。方法的声明如下:int HitTest(CPoint point, CWnd* pWnd); point:一个 CPoint 对象,表示要进行命中测试的点的坐标。 pWnd:指定与工具提示关联的窗口控件。这个方法返回一个整数,表示命中测试的结果。如果命中测试成功,返回值为工具的ID;如果没有命中任何工具,返回值为 -1。示例:CPoint mousePoint; // 鼠标点击的坐标::GetCursorPos(&mousePoint); // 获取全局鼠标坐标ScreenToClient(&mousePoint); // 转换为客户区坐标int toolID = m_toolTipCtrl.HitTest(mousePoint, this);if (toolID != -1) { // 鼠标点击命中了某个工具,toolID 是工具的ID} else { // ...
MFC CToolTipCtrl 类 公共方法:CToolTipCtrl::GetToolInfo
在 MFC(Microsoft Foundation Classes)中,CToolTipCtrl::GetToolInfo 是一个公共方法,用于获取与工具提示控件中的特定工具相关联的信息。方法的声明如下:BOOL GetToolInfo(TOOLINFO& ToolInfo, CWnd* pWnd, UINT_PTR nIDTool) const; ToolInfo:一个 TOOLINFO 结构的引用,用于接收与指定工具相关的信息。 pWnd:指定与工具提示关联的窗口控件。 nIDTool:指定与工具提示关联的控件ID。TOOLINFO 结构定义如下:typedef struct tagTOOLINFO { UINT cbSize; UINT uFlags; HWND hwnd; UINT_PTR uId; RECT rect; HINSTANCE hinst; LPSTR lpszText; LPARAM lParam;#if (_WIN32_IE >= 0x0300) void* lpReserved;#endi...
MFC CToolTipCtrl 类 公共方法:CToolTipCtrl::GetToolCount
在 MFC(Microsoft Foundation Classes)中,CToolTipCtrl::GetToolCount 是一个公共方法,用于获取工具提示控件中当前关联的工具的数量。方法的声明如下:int GetToolCount() const;这个方法返回一个整数,表示工具提示控件当前关联的工具数量。你可以调用这个方法来获取工具提示控件中有多少个工具已经被关联。示例:int toolCount = m_toolTipCtrl.GetToolCount();在这里,toolCount 变量将包含工具提示控件当前关联的工具的数量。这可以用于检查工具提示控件是否有工具被成功关联。
MFC CToolTipCtrl 类 公共方法:CToolTipCtrl::GetTipTextColor
在 MFC(Microsoft Foundation Classes)中,CToolTipCtrl::GetTipTextColor 是一个公共方法,用于获取工具提示控件的文本颜色。方法的声明如下:COLORREF GetTipTextColor() const;这个方法返回 COLORREF 类型的颜色值,表示当前工具提示控件的文本颜色。你可以调用该方法以获取工具提示的文本颜色,然后根据需要使用这个颜色值。示例:COLORREF tipTextColor = m_toolTipCtrl.GetTipTextColor();在这里,tipTextColor 变量将包含工具提示控件的文本颜色。你可以根据这个颜色值进行其他操作,例如在绘制自定义工具提示时使用相同的文本颜色。
MFC CToolTipCtrl 类 公共方法:CToolTipCtrl::GetTipBkColor
在 MFC(Microsoft Foundation Classes)中,CToolTipCtrl::GetTipBkColor 是一个公共方法,用于获取工具提示控件的背景颜色。方法的声明如下:COLORREF GetTipBkColor() const;这个方法返回 COLORREF 类型的颜色值,表示当前工具提示控件的背景颜色。你可以调用该方法以获取工具提示的背景颜色,然后根据需要使用这个颜色值。示例:COLORREF tipBkColor = m_toolTipCtrl.GetTipBkColor();在这里,tipBkColor 变量将包含工具提示控件的背景颜色。你可以根据这个颜色值进行其他操作,例如在绘制自定义工具提示时使用相同的背景颜色。
MFC CToolTipCtrl 类 公共方法:CToolTipCtrl::GetText
在MFC(Microsoft Foundation Classes)中,CToolTipCtrl::GetText 是一个公共方法,用于获取工具提示控件当前显示的文本内容。方法的声明如下:int GetText(LPTSTR lpszText, CWnd* pWnd, UINT_PTR nIDTool = 0) const; lpszText:指向缓冲区的指针,用于接收工具提示的文本内容。 pWnd:指定与工具提示关联的窗口控件。 nIDTool:指定与工具提示关联的控件ID。调用示例:CString strToolTipText;int nTextLength = m_toolTipCtrl.GetText(strToolTipText.GetBuffer(MAX_TIP_LENGTH), this, IDC_MY_CONTROL);strToolTipText.ReleaseBuffer(nTextLength);这里,MAX_TIP_LENGTH 应该是你提供的缓冲区的最大长度。这个方法返回实际复制到缓冲区的字符数,你可以使用这个值来确保不超出缓冲区的范围。
MFC CToolTipCtrl 类 公共方法:CToolTipCtrl::GetMargin
CToolTipCtrl::GetMargin 是 MFC(Microsoft Foundation Classes)中 CToolTipCtrl 类的一个公共方法,用于获取工具提示的边距设置。具体而言,这个方法用于获取工具提示控件中文本与控件边界之间的空白边距。通过调用 GetMargin 方法,你可以获得水平和垂直方向上的边距值。方法的声明如下:BOOL GetMargin(LPRECT lpRectMargin);其中,lpRectMargin 参数是一个指向 RECT 结构的指针,用于接收边距值。RECT 结构包含四个整数成员,分别表示左、上、右、下边距。你可以通过调用该方法并传递一个 RECT 结构的指针来获取边距值。例如:RECT rectMargin;BOOL bResult = m_toolTipCtrl.GetMargin(&rectMargin);if (bResult){ int nLeftMargin = rectMargin.left; int nTopMargin = rectMargin.top; int nRightMargin...
MFC CToolTipCtrl 类 公共方法:CToolTipCtrl::GetDelayTime
CToolTipCtrl::GetDelayTime 是 MFC(Microsoft Foundation Classes)中 CToolTipCtrl 类的一个公共方法,用于获取工具提示的延迟时间设置。具体而言,这个方法用于获取工具提示控件在显示前的延迟时间。延迟时间指的是用户将鼠标悬停在某个控件上时,工具提示控件开始显示之前的时间间隔。通过调用 GetDelayTime 方法,你可以获得这个延迟时间的设置值。方法的声明如下:UINT GetDelayTime(DWORD dwDuration);其中,dwDuration 参数是一个标志,表示不同的延迟时间类型,可以是以下之一: TTDT_AUTOMATIC:自动显示的延迟时间。 TTDT_AUTOPOP:自动弹出延迟时间。 TTDT_INITIAL:初始显示的延迟时间。你可以通过调用该方法并传递相应的标志来获取对应类型的延迟时间值。例如:UINT nInitialDelay = m_toolTipCtrl.GetDelayTime(TTDT_INITIAL);UINT nAutoPopDelay = m_toolTipCtrl.G...
MFC CToolTipCtrl 类 公共方法:CToolTipCtrl::GetCurrentTool
CToolTipCtrl::GetCurrentTool 是 MFC(Microsoft Foundation Classes)中 CToolTipCtrl 类的一个公共方法。这个方法用于获取当前工具(tool)的标识符和工具提示文本。以下是该方法的基本语法:BOOL GetCurrentTool( LPSTR lpszToolText, int cchToolText, LPRECT lpRect) const;参数说明: lpszToolText: 用于接收工具提示文本的缓冲区。 cchToolText: 缓冲区的大小,以字符为单位。 lpRect: 用于接收工具的矩形区域的 RECT 结构。该方法返回一个布尔值,表示是否成功获取了当前工具的信息。如果成功,返回 TRUE;否则返回 FALSE。例如,你可以这样使用该方法:CToolTipCtrl tooltipCtrl; // 假设已经创建了 CToolTipCtrl 对象char szToolText[256];RECT toolRect;BOOL bResult = tooltipCtrl.GetCurrentTo...
MFC CToolTipCtrl 类 公共方法:CToolTipCtrl::DelTool
CToolTipCtrl 类的 DelTool 方法用于从工具提示控件中删除指定的工具提示。以下是 CToolTipCtrl::DelTool 方法的简要说明:void DelTool( CWnd* pWnd, UINT nIDTool); pWnd:指定要删除工具提示的窗口控件。 nIDTool:指定要删除的工具提示的标识符。以下是一个简单的示例,演示如何使用 DelTool 方法删除工具提示:// 假设 m_toolTip 是 CToolTipCtrl 对象CButton* pButton = reinterpret_cast<CButton*>(GetDlgItem(IDC_MY_BUTTON));m_toolTip.DelTool(pButton, 0); // 删除按钮的工具提示上述代码中,我们使用 DelTool 方法从工具提示控件中删除与窗口上的按钮关联的工具提示。请注意,具体的 MFC 版本可能提供了不同的功能和方法,因此建议查阅相应版本的 MFC 文档以获取更准确和详细的信息。