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

  • Artigo

Instala o menu composto na janela de exibição.

Sintaxe

HRESULT SetMenuSB(
  HMENU    hmenuShared,
  HOLEMENU holemenuRes,
  HWND     hwndActiveObject
);

Parâmetros

hmenuShared

Tipo: HMENU

Um identificador para o menu composto construído por chamadas para IShellBrowser::InsertMenusSB e a função InsertMenu .

holemenuRes

Tipo: HOLEMENU

hwndActiveObject

Digite: HWND

O identificador de janela do modo de exibição.

Retornar valor

Tipo: RESULT

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::SetMenu . No entanto, o Windows Explorer executa a expedição de menu com base no identificador do item de menu.

A disponibilidade de itens de menu específicos depende se o modo de exibição tem o foco. Assim, é necessário chamar o método IShellBrowser::OnViewWindowActive sempre que a janela de exibição (ou uma de suas janelas filho) tiver o foco.

Observações para aplicativos de chamada

O objeto chama IShellBrowser_SetMenuSB para solicitar que o contêiner instale a estrutura do menu composto configurada por chamadas para IShellBrowser::InsertMenusSB.

Observações aos implementadores

A implementação desse método por um contêiner deve chamar a função SetMenu .

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)

Confira também

IShellBrowser