IAgentCharacterEx::SetHelpModeOn

[Microsoft 代理从 Windows 7 开始已弃用,可能在后续版本的 Windows 中不可用。]

HRESULT SetHelpModeOn(
   long bHelpModeOn  // help mode setting
);

为字符设置上下文相关帮助模式。

  • 返回指示操作成功的S_OK。

bHelpModeOn

帮助模式标志。 如果此参数为 True,则 Microsoft 代理将打开字符的“帮助”模式。

将此属性设置为 True 时,当鼠标指针移动到字符或字符的弹出菜单上时,鼠标指针将更改为上下文相关的帮助图像。 当用户单击或拖动字符或单击字符弹出菜单中的某个项目时,服务器将触发 IAgentNotifySinkEx::HelpComplete 事件并退出帮助模式。

在“帮助”模式下,服务器不会发送 ClickDragStartDragCompleteCommand 事件,除非 GetAutoPopupMenu 属性返回 True。 在这种情况下,服务器将发送 Click 事件 (不会退出帮助模式) ,但仅针对鼠标右键,以便显示弹出菜单。

此属性仅适用于客户端应用程序对 字符的使用;设置不会影响客户端应用程序的字符或其他字符的其他客户端。

另请参阅

IAgentCharacterEx::GetHelpModeOnIAgentNotifySinkEx::HelpComplete