Interface IPreviewHandler (shobjidl_core.h)

Expõe métodos para a exibição de visualizações avançadas.

Herança

A interface IPreviewHandler herda da interface IUnknown . IPreviewHandler também tem estes tipos de membros:

Métodos

A interface IPreviewHandler tem esses métodos.

IPreviewHandler::D oPreview Direciona o manipulador de visualização para carregar dados da origem especificada em uma chamada de método Initialize anterior e para começar a renderizar para a janela do visualizador.
IPreviewHandler::QueryFocus Direciona o manipulador de visualização para retornar o HWND de chamar a Função GetFocus.
IPreviewHandler::SetFocus Direciona o manipulador de visualização para definir o foco para si mesmo.
IPreviewHandler::SetRect Direciona o manipulador de visualização para alterar a área dentro do hwnd pai no qual ele desenha.
IPreviewHandler::SetWindow Define a janela pai da janela do visualizador, bem como a área dentro do pai a ser usada para a janela do visualizador.
IPreviewHandler::TranslateAccelerator Direciona o manipulador de visualização para manipular um pressionamento de tecla passado da bomba de mensagem do processo no qual o manipulador de visualização está em execução.
IPreviewHandler::Unload Direciona o manipulador de visualização para deixar de renderizar uma versão prévia e liberar todos os recursos que foram alocados com base no item passado durante a inicialização.

Comentários

Os manipuladores de visualização podem ser criados em código gerenciado. Normalmente, todos os manipuladores de visualização são hospedados juntos em um processo alternativo chamado prevhost.exe. Há uma instância desse processo para manipuladores de visualização em execução no nível de integridade normal e outra instância para manipuladores de visualização em execução no nível de integridade baixo. Se você quiser implementar o manipulador no código gerenciado, o manipulador não deverá ser executado dentro de nenhum desses processos compartilhados. Em vez disso, organize o manipulador para obter uma nova instância de prevhost.exe criando uma nova entrada AppID no Registro (especificando prevhost.exe como o valor DllSurrogate) e definindo-a como o valor AppID no valor do Registro para a ID de classe do manipulador. Isso garantirá que uma instância de prevhost.exe exclusiva seja criada para o manipulador, em vez das instâncias comuns usadas pelos outros manipuladores.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shobjidl_core.h
Redistribuível	Windows Search 4 ou posterior