Compartilhar via

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

  • Artigo

Permite que o contêiner insira seus grupos de menus no menu composto exibido quando um namespace estendido está sendo exibido ou usado.

Sintaxe

HRESULT InsertMenusSB(
  HMENU                hmenuShared,
  LPOLEMENUGROUPWIDTHS lpMenuWidths
);

Parâmetros

hmenuShared

Tipo: HMENU

Um identificador para um menu vazio.

lpMenuWidths

Tipo: LPOLEMENUGROUPWIDTHS

O endereço de uma matriz OLEMENUGROUPWIDTHS de seis valores LONG . O contêiner preenche os elementos 0, 2 e 4 para refletir o número de elementos de menu fornecidos nos grupos de menus Arquivo, Exibição e Janela.

Retornar valor

Tipo: HRESULT

Retorna S_OK se tiver êxito ou um valor de erro definido por COM caso contrário.

Comentários

Esse método é semelhante ao método IOleInPlaceFrame::InsertMenus . O Windows Explorer coloca menus suspensos Arquivo e Edição no grupo de menus Arquivo, menus Exibir e Ferramentas no grupo de menus Contêiner e um menu Ajuda no grupo de menus Janela. Cada menu suspenso terá um identificador exclusivo, FCIDM_MENU_FILE/EDITAR/EXIBIR/FERRAMENTAS/AJUDA. O modo de exibição tem permissão para inserir itens de menu nesses submenus por seus identificadores, que é diferente do mecanismo de ativação in-loco do OLE. Os identificadores de comando para menus que a exibição insere no submenu do Windows Explorer ou em seu próprio submenu devem estar entre FCIDM_SHVIEWFIRST e FCIDM_SHVIEWLAST.

Observações para aplicativos de chamada

Esse método é chamado por extensões de namespace quando elas estão sendo ativadas pela primeira vez para que possam inserir seus menus na interface do usuário no nível do quadro.

O aplicativo objeto solicita que o contêiner adicione seus menus ao menu especificado no parâmetro hmenuShared e defina as contagens de grupo na matriz OLEMENUGROUPWIDTHS apontada pelo parâmetro lpMenuWidths . Em seguida, o aplicativo de objeto adiciona seus próprios menus e contagens. Os objetos podem chamar o método IOleInPlaceFrame::InsertMenus quantas vezes forem necessárias para compilar os menus compostos. O contêiner deve usar o identificador de menu inicial associado ao menu composto para todos os itens nos menus suspensos.

Observações aos implementadores

Para implementações de IShellBrowser , os identificadores de menu devem estar no intervalo de FCIDM_BROWSERFIRST para FCIDM_BROWSERLAST.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shobjidl_core.h (inclua Shobjidl.h)
DLL Shell32.dll (versão 4.0 ou posterior)