mensagem DFM_INVOKECOMMANDEX

  • Artigo

Enviado pela implementação do menu de contexto padrão para solicitar LPFNDFMCALLBACK para invocar um comando de menu estendido.

                DFM_INVOKECOMMANDEX
    wParam = (WPARAM)(int) idCmd;           
    lParam = (LPARAM)(DFMICS) PDFMICS;

Parâmetros

idCmd [in]

A ID de comando do comando de menu selecionado. Os sinalizadores a seguir são reconhecidos.

DFM_CMD_DELETE

DFM_CMD_MOVE

DFM_CMD_COPY

DFM_CMD_LINK

DFM_CMD_PROPERTIES

Mostre a interface do usuário propriedades para o item no qual o menu foi invocado.

DFM_CMD_NEWFOLDER

DFM_CMD_PASTE

DFM_CMD_VIEWLIST

DFM_CMD_VIEWDETAILS

DFM_CMD_PASTELINK

DFM_CMD_PASTESPECIAL

DFM_CMD_MODALPROP

DFM_CMD_RENAME

PDFMICS [in]

Um ponteiro para uma estrutura DFMICS que contém argumentos adicionais para o comando de menu selecionado. Este parâmetro pode ser NULL.

Comentários

Após o recebimento dessa mensagem, sua função deverá retornar S_FALSE se você quiser que a implementação padrão invoque o manipulador padrão para o comando. Retorne S_OK se a mensagem tiver sido manipulada. Caso contrário, retorne um código de erro HRESULT padrão.

Essa mensagem é enviada para a função de retorno de chamada ou o objeto de retorno de chamada, dependendo de como o retorno de chamada é implementado. Há duas APIs para construção de retorno de chamada, CDefFolderMenu_Create2 que usa um ponteiro para uma função de retorno de chamada ou SHCreateDefaultContextMenu que usa um objeto de retorno de chamada que dá suporte a IContextMenuCB.

Os itens nos quais o comando está sendo invocado são fornecidos em um objeto de dados passado para a função de retorno de chamada ou para o método IContextMenuCB::CallBack . Esse objeto de dados é fornecido pela fonte de dados que implementa o retorno de chamada. Para extrair os itens do objeto de dados, use SHCreateShellItemArrayFromDataObject.

DFM_INVOKECOMMAND é uma versão mais simples dessa mensagem que não fornece tanta informação para o retorno de chamada. Use DFM_INVOKECOMMAND se as informações adicionais fornecidas pelo DFM_INVOKECOMMANDEX não forem necessárias em sua implementação.

Requisitos

Requisito Valor
Cliente mínimo com suporte
 Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
 Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho
Shlobj.h