Método IExtendContextMenu::Command (mmc.h)

Artigo
03/08/2023

O método IExtendContextMenu::Command será chamado se um dos itens adicionados ao menu de contexto com IExtendContextMenu::AddMenuItems for selecionado posteriormente. O MMC chama Command com a ID de comando especificada e outro ponteiro para a mesma interface IDataObject .

Sintaxe

HRESULT Command(
  [in] long         lCommandID,
  [in] LPDATAOBJECT piDataObject
);

Parâmetros

[in] lCommandID

Um valor que especifica o identificador de comando do item de menu.

[in] piDataObject

Um ponteiro para a interface IDataObject no objeto cujo menu de contexto foi exibido.

Retornar valor

Esse método pode retornar um desses valores.

Comentários

O MMC reserva IDs de comando com valor negativo para IDs de comando de menu predefinidas que ele envia para o método IExtendContextMenu::Command de um snap-in. A ID do comando –1 é o valor do enumerador MMCC_STANDARD_VIEW_SELECT definido em mmc.h. Isso é enviado para IExtendContextMenu::Command quando o usuário clica em um comando de exibição padrão no menu Exibir (Grande, Pequeno, Lista ou Detalhe). Isso notifica o snap-in de que o usuário está se afastando de uma exibição personalizada (OCX, HTML). Depois de obter um comando MMCC_STANDARD_VIEW_SELECT, o snap-in deverá solicitar uma exibição padrão na próxima vez que o método IComponent::GetResultViewType for chamado e não solicitar uma exibição personalizada até que um de seus itens de menu de exibição personalizada seja selecionado. Se o snap-in usar apenas exibições padrão ou usar apenas exibições personalizadas, ele poderá ignorar o comando MMCC_STANDARD_VIEW_SELECT.

O MMC envia o snap-in do comando MMCC_STANDARD_VIEW_SELECT quando o usuário clica no botão Voltar na barra de ferramentas. O MMC usa esse comando para instruir o snap-in a exibir a exibição anterior do painel de resultados.