弹出菜单支持

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

Microsoft 代理包含一个弹出菜单 (也称为每个字符的上下文菜单) 。 当用户右键单击字符时,服务器会自动显示此弹出菜单。 可以通过定义 Commands 集合将客户端应用程序 的命令 添加到菜单。 对于定义的集合中的每个命令,可以指定 CaptionVisible 属性。 Caption 是当 Visible 属性设置为 True 时显示在菜单中的文本。 还可以使用 Enabled 属性将菜单中的命令显示为“已禁用”,使用 HelpContextID 支持属性的帮助支持。 通过在标题文本设置的文本字符之前添加一个和 (&) 来定义菜单文本的访问键。

服务器自动将用于打开语音命令窗口和隐藏字符以及该字符的其他客户端的 命令 标题添加到菜单命令,使用户能够在客户端之间切换。 服务器会自动在其菜单条目与客户端定义的菜单项之间添加分隔符。 仅当菜单中有要分隔的项时,才会显示分隔符。

若要从菜单中删除命令,请使用 Remove 方法。 请注意,菜单项在菜单显示时不会更改。 如果添加或删除命令或更改其属性,则当用户重新显示菜单时,菜单将显示更改。

如果希望为字符提供自己的弹出菜单服务,可以使用 AutoPopupMenu 属性关闭右键单击操作的服务器处理。 然后,可以使用 Click 事件通知创建自己的菜单处理行为。

当用户从字符的弹出菜单或语音命令窗口选择命令时,服务器会触发关联客户端的 Command 事件,并使用 UserInput 对象传回输入的参数。

服务器还为角色的任务栏图标提供弹出菜单。 当字符可见时,右键单击此菜单将显示与通过右键单击字符显示的命令相同的命令。 但是,当字符处于隐藏状态时,仅包含服务器提供的命令。