Compartilhar via


Método IPreviewHandler::D oPreview (shobjidl_core.h)

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.

Sintaxe

HRESULT DoPreview();

Retornar valor

Tipo: HRESULT

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK
A operação foi concluída com sucesso.
E_PREVIEWHANDLER_DRM_FAIL
Bloqueado pelo gerenciamento de direitos digitais.
E_PREVIEWHANDLER_NOAUTH
Bloqueado por permissões de arquivo.
E_PREVIEWHANDLER_NOTFOUND
O item não foi encontrado.
E_PREVIEWHANDLER_CORRUPT
O item estava corrompido.

Comentários

Se a janela do visualizador ainda não tiver sido criada, ela deverá ser criada depois que esse método tiver sido chamado. O manipulador de visualização é responsável por pintar a área especificada em IPreviewHandler::SetWindow ou IPreviewHandler::SetRect. Se esses métodos forem chamados enquanto o manipulador de visualização estiver sendo renderizado, a janela deverá ser reparentada/redimensionada sem parar ou reiniciar a renderização do item.

Esse método deve ser chamado somente depois que IPreviewHandler::SetWindow tiver sido chamado.

Além disso, esse método deve ser chamado somente depois que Initialize, Initialize ou Initialize tiver sido chamado.

Nota Na verdade, não crie a janela do visualizador até que esse método tenha sido chamado.
 

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 (inclua Shobjidl.h)
Redistribuível Windows Search 4 ou posterior