Função de retorno de chamada LPFNVIEWCALLBACK (shlobj_core.h)

Artigo
08/26/2023

[Essa interface tem suporte por meio do Windows XP Service Pack 2 (SP2) e do Windows Server 2003. Ele pode não ter suporte em versões subsequentes do Windows.]

Define o protótipo para a função de retorno de chamada usada pelo objeto de exibição de pasta do sistema. Essa função essencialmente duplica a funcionalidade de IShellFolderViewCB.

Sintaxe

LPFNVIEWCALLBACK Lpfnviewcallback;

HRESULT Lpfnviewcallback(
  [in] IShellView *psvOuter,
  [in] IShellFolder *psf,
  [in] HWND hwndMain,
       UINT uMsg,
       WPARAM wParam,
       LPARAM lParam
)
{...}

Parâmetros

[in] psvOuter

Tipo: IShellView*

Um ponteiro para a instância proprietária do IShellView, se aplicável. Este parâmetro pode ser NULL.

[in] psf

Tipo: IShellFolder*

Um ponteiro para a instância de IShellFolder à qual a mensagem se aplica.

[in] hwndMain

Digite: HWND

O identificador da janela que contém a exibição que recebe a mensagem.

uMsg

Tipo: UINT

Uma das notificações a seguir.

SFVM_ADDPROPERTYPAGES

Permite que o objeto de retorno de chamada forneça uma página para adicionar à folha de propriedades Propriedades do objeto selecionado.

SFVM_BACKGROUNDENUM

Permite que o objeto de retorno de chamada solicite que a enumeração seja feita em um thread em segundo plano.

SFVM_BACKGROUNDENUMDONE

Notifica o objeto de retorno de chamada de que a enumeração em segundo plano está concluída.

SFVM_COLUMNCLICK

Notifica o objeto de retorno de chamada de que o usuário clicou em um cabeçalho de coluna para classificar a lista de objetos na exibição de pasta.

SFVM_DEFITEMCOUNT

Permite que o objeto de retorno de chamada especifique o número de itens na exibição de pasta.

SFVM_DEFVIEWMODE

Permite que o objeto de retorno de chamada especifique o modo de exibição.

SFVM_DIDDRAGDROP

Notifica a função de retorno de chamada de que uma operação de arrastar e soltar foi iniciada.

SFVM_FSNOTIFY

Notifica o objeto de retorno de chamada de que ocorreu um evento que afeta um de seus itens.

SFVM_GETANIMATION

Permite que o objeto de retorno de chamada especifique que uma animação seja exibida enquanto os itens são enumerados em um thread em segundo plano.

SFVM_GETBUTTONINFO

Permite que o objeto de retorno de chamada adicione botões à barra de ferramentas.

SFVM_GETBUTTONS

Permite que o objeto de retorno de chamada especifique os botões a serem adicionados à barra de ferramentas.

SFVM_GETDETAILSOF

Permite que o objeto de retorno de chamada forneça os detalhes de um item em uma pasta shell. Use somente se uma chamada para IShellFolder2::GetDetailsOf falhar e não houver nenhum método IShellDetails::GetDetailsOf disponível para chamar.

SFVM_GETHELPTEXT

Permite que o objeto de retorno de chamada especifique uma cadeia de caracteres de texto de ajuda para itens de menu ou botões da barra de ferramentas.

SFVM_GETHELPTOPIC

Permite que o objeto de retorno de chamada especifique um arquivo de Ajuda e um tópico.

SFVM_GETNOTIFY

Especifica quais eventos gerarão uma mensagem SFVM_FSNOTIFY para um determinado item.

SFVM_GETPANE

Permite que o objeto de retorno de chamada forneça o painel status barra no qual exibir as informações da zona da Internet.

SFVM_GETSORTDEFAULTS

Permite que o objeto de retorno de chamada especifique parâmetros de classificação padrão.

SFVM_GETTOOLTIPTEXT

Permite que o objeto de retorno de chamada especifique uma cadeia de caracteres de texto de dica de ferramenta para itens de menu ou botões da barra de ferramentas.

SFVM_GETZONE

Permite que o objeto de retorno de chamada forneça informações de zona da Internet.

SFVM_INITMENUPOPUP

Permite que o objeto de retorno de chamada modifique o menu de contexto de um item.

SFVM_INVOKECOMMAND

Notifica o objeto de retorno de chamada de que um de seus comandos de barra de ferramentas ou menu foi invocado.

SFVM_MERGEMENU

Permite que o objeto de retorno de chamada mescle itens de menu nos menus do Windows Explorer.

SFVM_QUERYFSNOTIFY

Permite que o objeto de retorno de chamada registre uma pasta para que as alterações na exibição dessa pasta gerem notificações.

SFVM_SETISFV

Notifica o objeto de retorno de chamada do site de contêiner. Isso é usado somente quando IObjectWithSite::SetSite não tem suporte e SHCreateShellFolderViewEx é usado.

SFVM_SIZE

Notifica o objeto de retorno de chamada de que a exibição de pasta foi redimensionada.

SFVM_THISIDLIST

Permite que o objeto de retorno de chamada especifique o PIDL da exibição. Isso é usado somente quando IPersistIDList::SetIDList e IPersistFolder2::GetCurFolder falharam.

SFVM_UNMERGEMENU

Notifica o objeto de retorno de chamada de que um menu está sendo removido.

SFVM_UPDATESTATUSBAR

Permite que o objeto de retorno de chamada solicite que a barra de status seja atualizada.

SFVM_WINDOWCREATED

Notifica o objeto de retorno de chamada de que a janela de exibição de pasta está sendo criada.

wParam

Tipo: WPARAM

Informações adicionais dependentes do valor em uMsg. Consulte as páginas de notificação individuais para obter requisitos específicos.

lParam

Tipo: LPARAM