Compartir a través de

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

  • Artículo

Establece la ventana primaria de la ventana del previsualizador, así como el área dentro del elemento primario que se va a usar para la ventana del previsualizador.

Sintaxis

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

Parámetros

[in] hwnd

Tipo: HWND

Identificador de la ventana primaria.

[in] prc

Tipo: const RECT*

Puntero a un RECT que define el área del previsualizador.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

El controlador de vista previa es responsable de pintar todo el área definida por prc. Si se ha creado la ventana del controlador de vista previa, el controlador de vista previa debe asociar la ventana de vista previa al nuevo hwnd primario y cambiar el tamaño de la ventana del controlador de vista previa al área definida por prc. Si aún no se ha creado la ventana del previsualizador, el controlador de vista previa debe recordar esta información para cuando se cree la ventana del controlador de vista previa en IPreviewHandler::D oPreview.

Nota Se prefiere que esta información se almacene antes de llamar a IPreviewHandler::D oPreview. Esto aumenta el rendimiento en el momento de la instalación en los casos en los que la versión preliminar no se inicia.
 

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista, Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shobjidl_core.h (include Shobjidl.h)
Redistribuible Windows Search 4 o posterior