帮助菜单合并

当容器对象中处于活动状态,将 OLE 文档的协议菜单为 帮助 菜单对象的完全控制。 因此,活动对象,除非用户,容器的帮助主题将不可用。 活动文档包容结构在合并就地菜单的展开规则允许容器和是活动的共享菜单的活动文档。 新规则完成有关组件的不同的约定自己的菜单的内容部分,并且共享菜单如何构造的。

新的规则很简单。 在活动文档中,帮助 菜单有组织的两个顶级菜单项添加如下所示:

Help

Container Help >

Object Help >

例如,在 Word 中,节是活动状态在 Office 活页夹,则 帮助 菜单将显示如下:

Help

Binder Help >

Word Help >

两个菜单项下为所有附加的菜单项的特定访问容器和对象提供给用户的级联菜单。 此处显示的项情况随涉及的容器和对象。更改。

若要构造此合并的 帮助 菜单,对活动文档包容结构修改标准 OLE 文档过程。 根据 OLE 文档,合并的菜单栏可以具有菜单,即 文件编辑容器 (O),Object,窗口帮助的六组,该顺序。 在每组中,可以有零个或多菜单。 组 文件、**容器 (O)**和 窗口 容器属于,并且组 编辑Object,帮助 则属于对象。 当对象执行组合中的菜单,它将创建一个空白的菜单栏和传递到容器。 容器通过调用 IOleInPlaceFrame::InsertMenus,然后插入其菜单。 对象同时传递是六长值的结构 (OLEMENUGROUPWIDTHS)。 在插入菜单后,容器将指示剩余菜单在每个添加到该组,然后返回。 然后在每个对象容器组中插入的菜单,计数请注意菜单。 最后,传递对象合并的菜单栏和每个组中包含数组 (为 OLE) 计数菜单的,返回一不透明的“菜单句柄”说明符。 处理和合并的菜单栏为容器后的对象传递,通过 IOleInPlaceFrame::SetMenu。 这时,容器显示合并的菜单栏并将句柄到 OLE,因此,OLE 可以执行相应菜单调度消息。

在修改过程的活动文档对象,必须先初始化 OLEMENUGROUPWIDTHS 元素为零前请于容器。 然后执行容器的菜单插入有一个例外:容器在 帮助 菜单为最后一项并存储值为 1。一个 OLEMENUGROUPWIDTHS 数组 (例如宽度 [5]) 的最后 (第六项,属于对象的帮助组)。 此 帮助 菜单所述将只为子菜单的一项,“Container Help >”级联菜单。

对象并执行其常规菜单插入代码,但在插入之前其 帮助 菜单,它检查 OLEMENUGROUPWIDTHS 数组的第六项。 如果值为 1,而次菜单的名称为 帮助 (或相应的本地化字符串),则对象插入其 帮助 菜单为容器的 帮助 菜单的子菜单。

对象然后调整 OLEMENUGROUPWIDTHS 元素的第六到零并通过递增第五个元素组成。 此通知 OLE 帮助 菜单容器属于,并应路由与该菜单 (及其子菜单的菜单) 的消息到容器。 为容器的作用,然后转发 WM_INITMENUPOPUPWM_SELECTWM_COMMAND及属于 帮助 菜单的对象的其他菜单关联的消息。 这是实现通过使用 WM_INITMENU 清除标志调用容器的用户是否导航到对象的 帮助 菜单。 容器并注意 WM_MENUSELECT 从任何项的输入或退出对容器不添加自己的 帮助 菜单。 在输入,这意味着用户导航到此菜单对象,因此在“帮助”菜单,容器对象设置标志并使用该的状态的所有 WM_MENUSELECTWM_INITMENUPOPUPWM_COMMAND 消息,、最小值,向对象窗口。(在调用退出,容器清除标志来处理这些消息。)容器应为这些消息使用从对象的 IOleInPlaceActiveObejct::GetWindow 函数返回的窗口作为目标。

如果检测零在 OLEMENUGROUPWIDTHS对象的第六元素,它根据 OLE 文档标准规则进行。 此过程包括将 帮助 的菜单以及一些不参与的容器。

当对象在显示之前调用 IOleInPlaceFrame::SetMenu时,合并的菜单栏,容器 帮助 检查菜单是否有其他的子菜单时,除了外什么容器插入。 如果是这样,在容器合并的菜单栏将其 帮助 的菜单。 如果 帮助 菜单没有一个附加的子菜单时,容器从合并的菜单栏中移除其 帮助 菜单。 此过程包括将 帮助 的菜单以及一些不参与的对象。

最后,当为,时间拆卸菜单上,以及移除其他插入的菜单外,对象移除插入的 帮助 菜单。 当容器中移除其菜单,它将移除其 帮助 菜单以及其插入的其他菜单中。

请参见

概念

活动文档容器