DFM_INVOKECOMMAND mensagem

  • Artigo

Enviada pela implementação do menu de contexto padrão para solicitar a função de retorno de chamada que manipula o menu (LPFNDFMCALLBACK) para invocar um comando de menu.

DFM_INVOKECOMMAND
    wParam = (WPARAM)(int) id;          
    lParam = (LPARAM)(LPWSTR) args;

Parâmetros

id [in]

A ID de comando do comando de menu selecionado. Os seguintes sinalizadores são reconhecidos:

DFM_CMD_DELETE

Windows Vista e posterior. Exclua o item atual.

DFM_CMD_MOVE

Windows Vista e posterior. Mova o item atual.

DFM_CMD_COPY

Windows Vista e posterior. Copie o item atual.

DFM_CMD_LINK

Windows Vista e posterior. Crie um link para o item atual.

DFM_CMD_PROPERTIES

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

DFM_CMD_NEWFOLDER

Sem suporte.

DFM_CMD_PASTE

Windows Vista e posterior. Cole um item no local atual.

DFM_CMD_VIEWLIST

Sem suporte.

DFM_CMD_VIEWDETAILS

Sem suporte.

DFM_CMD_PASTELINK

Windows Vista e posterior. Cole um link no local atual.

DFM_CMD_PASTESPECIAL

Sem suporte.

DFM_CMD_MODALPROP

Sem suporte.

DFM_CMD_RENAME

Windows Vista e posterior. Renomeie o item atual.

args [in]

Um ponteiro para uma cadeia de caracteres terminada em nulo que contém argumentos adicionais para o comando de menu selecionado. Este parâmetro pode ser NULL.

Valor retornado

O manipulador dessa mensagem precisará 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 foi tratada. Caso contrário, retorne um código de erro HRESULT padrão.

Comentários

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_INVOKECOMMANDEX é uma versão estendida dessa mensagem e fornece mais informações para o retorno de chamada. Use DFM_INVOKECOMMANDEX se as informações adicionais fornecidas por essa interface forem necessárias em sua implementação.

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]
Cabeçalho
Shlobj.h