Compartir a través de

Método IShellBrowser::InsertMenusSB (shobjidl_core.h)

  • Artículo

Permite al contenedor insertar sus grupos de menús en el menú compuesto que se muestra cuando se ve o se usa un espacio de nombres extendido.

Sintaxis

HRESULT InsertMenusSB(
  HMENU                hmenuShared,
  LPOLEMENUGROUPWIDTHS lpMenuWidths
);

Parámetros

hmenuShared

Tipo: HMENU

Identificador de un menú vacío.

lpMenuWidths

Tipo: LPOLEMENUGROUPWIDTHS

Dirección de una matriz OLEMENUGROUPWIDTHS de seis valores LONG . El contenedor rellena los elementos 0, 2 y 4 para reflejar el número de elementos de menú que proporcionó en los grupos de menús Archivo, Vista y Ventana.

Valor devuelto

Tipo: HRESULT

Devuelve S_OK si se ejecuta correctamente o un valor de error definido por COM de otro modo.

Comentarios

Este método es similar al método IOleInPlaceFrame::InsertMenus . El Explorador de Windows coloca los menús desplegables Archivo y Editar en el grupo de menús Archivo, Los menús Ver y Herramientas del grupo de menús Contenedor y un menú Ayuda en el grupo de menús Ventana. Cada menú desplegable tendrá un identificador único, FCIDM_MENU_FILE/EDIT/VIEW/TOOLS/HELP. La vista puede insertar elementos de menú en esos submenús por sus identificadores, que es diferente del mecanismo de activación local de OLE. Los identificadores de comando de los menús que la vista inserta en el submenú del Explorador de Windows o en su propio submenú deben estar entre FCIDM_SHVIEWFIRST y FCIDM_SHVIEWLAST.

Notas a las aplicaciones de llamada

Las extensiones de espacio de nombres llaman a este método cuando se activan por primera vez para que puedan insertar sus menús en la interfaz de usuario de nivel de marco.

La aplicación de objeto pide al contenedor que agregue sus menús al menú especificado en el parámetro hmenuShared y que establezca los recuentos de grupos en la matriz OLEMENUGROUPWIDTHS a la que apunta el parámetro lpMenuWidths . A continuación, la aplicación de objeto agrega sus propios menús y recuentos. Los objetos pueden llamar al método IOleInPlaceFrame::InsertMenus tantas veces como sea necesario para crear los menús compuestos. El contenedor debe usar el identificador de menú inicial asociado al menú compuesto para todos los elementos de los menús desplegables.

Notas para los implementadores

En el caso de las implementaciones de IShellBrowser , los identificadores de menú deben estar en el intervalo de FCIDM_BROWSERFIRST para FCIDM_BROWSERLAST.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shobjidl_core.h (incluya Shobjidl.h)
Archivo DLL Shell32.dll (versión 4.0 o posterior)