Compartilhar via

Método IMenuButton::AddButton (mmc.h)

  • Artigo

O método IMenuButton::AddButton permite que um usuário adicione um botão à barra de menus do MMC para uma exibição específica.

Sintaxe

HRESULT AddButton(
  [in] int      idCommand,
  [in] LPOLESTR lpButtonText,
  [in] LPOLESTR lpTooltipText
);

Parâmetros

[in] idCommand

Um valor que especifica um valor fornecido pelo usuário que identifica exclusivamente o botão a ser adicionado à barra de menus.

[in] lpButtonText

Um ponteiro para o valor de texto (uma cadeia de caracteres terminada em nulo) a ser exibido no botão.

[in] lpTooltipText

Um ponteiro para o valor de texto (uma cadeia de caracteres terminada em nulo) a ser exibido quando o usuário coloca o ponteiro do mouse no botão.

Retornar valor

Esse método pode retornar um desses valores.

Comentários

Botões adicionados à barra de menus do MMC para uma exibição específica são sempre acrescentados aos botões já presentes. O estado inicial de qualquer botão de menu está oculto e desabilitado.

Quando o snap-in perde o foco, esses botões são removidos automaticamente da barra de menus. Como resultado, eles devem ser adicionados sempre que o snap-in obtém o foco.

Esse método pode ser chamado por snap-ins primários ou de extensão.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista
Servidor mínimo com suporte Windows Server 2008
Plataforma de Destino Windows
Cabeçalho mmc.h
DLL Mmcndmgr.dll

Confira também

IMenuButton