Método IOleInPlaceFrame::InsertMenus (oleidl.h)

  • Artigo

Permite que o contêiner insira grupos de menus no menu composto a ser usado durante a sessão in-loco.

Sintaxe

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

Parâmetros

[in] hmenuShared

Um identificador para um menu vazio.

[in, out] lpMenuWidths

Um ponteiro para uma matriz OLEMENUGROUPWIDTHS com seis elementos. 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

Esse método retorna S_OK em caso de êxito. Outros valores retornados possíveis incluem o seguinte.

Código de retorno Descrição
E_UNEXPECTED
 Ocorreu um erro inesperado.

Comentários

Anotações aos Chamadores

Esse método é chamado por aplicativos de objeto quando eles estão sendo ativados pela primeira vez. Eles o chamam para inserir seus menus na interface do usuário no nível do quadro.

O aplicativo de objeto solicita que o contêiner adicione seus menus ao menu especificado em hmenuShared e defina as contagens de grupo na matriz OLEMENUGROUPWIDTHS apontada por lpMenuWidths. Em seguida, o aplicativo de objeto adiciona seus próprios menus e contagens. Os objetos podem chamar 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 de menu nos menus suspensos.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [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 oleidl.h

Confira também

Ioleinplaceframe