IAgentCharacterEx::SetHelpModeOn
[Microsoft 代理从 Windows 7 开始已弃用,可能在后续版本的 Windows 中不可用。]
HRESULT SetHelpModeOn(
long bHelpModeOn // help mode setting
);
为字符设置上下文相关帮助模式。
- 返回指示操作成功的S_OK。
-
bHelpModeOn
-
帮助模式标志。 如果此参数为 True,则 Microsoft 代理将打开字符的“帮助”模式。
将此属性设置为 True 时,当鼠标指针移动到字符或字符的弹出菜单上时,鼠标指针将更改为上下文相关的帮助图像。 当用户单击或拖动字符或单击字符弹出菜单中的某个项目时,服务器将触发 IAgentNotifySinkEx::HelpComplete 事件并退出帮助模式。
在“帮助”模式下,服务器不会发送 Click、 DragStart、 DragComplete 和 Command 事件,除非 GetAutoPopupMenu 属性返回 True。 在这种情况下,服务器将发送 Click 事件 (不会退出帮助模式) ,但仅针对鼠标右键,以便显示弹出菜单。
此属性仅适用于客户端应用程序对 字符的使用;设置不会影响客户端应用程序的字符或其他字符的其他客户端。
另请参阅
IAgentCharacterEx::GetHelpModeOn、 IAgentNotifySinkEx::HelpComplete