Compartilhar via


Método IPreviewHandler::SetWindow (shobjidl_core.h)

Define a janela pai da janela do visualizador, bem como a área dentro do pai a ser usada para a janela do visualizador.

Sintaxe

HRESULT SetWindow(
  [in] HWND       hwnd,
  [in] const RECT *prc
);

Parâmetros

[in] hwnd

Digite: HWND

Um identificador para a janela pai.

[in] prc

Tipo: const RECT*

Um ponteiro para um RECT definindo a área para o visualizador.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

O manipulador de visualização é responsável por pintar toda a área definida pela prc. Se a janela do visualizador tiver sido criada, o manipulador de visualização deverá associar a janela do visualizador ao novo hwnd pai e redimensionar a janela do visualizador à área definida pela prc. Se a janela do visualizador ainda não tiver sido criada, o manipulador de visualização deverá lembrar essas informações para quando a janela do visualizador for criada em IPreviewHandler::D oPreview.

Nota É preferível que essas informações sejam armazenadas antes de chamar IPreviewHandler::D oPreview. Isso aumenta o desempenho no momento da instalação para todos os casos em que a visualização não é iniciada.
 

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