IOleInPlaceFrame::InsertMenus method (oleidl.h)

Article
02/22/2024

Enables the container to insert menu groups into the composite menu to be used during the in-place session.

Syntax

HRESULT InsertMenus(
  [in]      HMENU                hmenuShared,
  [in, out] LPOLEMENUGROUPWIDTHS lpMenuWidths
);

Parameters

[in] hmenuShared

A handle to an empty menu.

[in, out] lpMenuWidths

A pointer to an OLEMENUGROUPWIDTHS array with six elements. The container fills in elements 0, 2, and 4 to reflect the number of menu elements it provided in the File, View, and Window menu groups.

Return value

This method returns S_OK on success. Other possible return values include the following.

Return code	Description
E_UNEXPECTED	An unexpected error has occurred.

Remarks

Notes to Callers

This method is called by object applications when they are first being activated. They call it to insert their menus into the frame-level user interface.

The object application asks the container to add its menus to the menu specified in hmenuShared and to set the group counts in the OLEMENUGROUPWIDTHS array pointed to by lpMenuWidths. The object application then adds its own menus and counts. Objects can call IOleInPlaceFrame::InsertMenus as many times as necessary to build up the composite menus. The container should use the initial menu handle associated with the composite menu for all menu items in the drop-down menus.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	oleidl.h

Share via