Interfaz IPreviewHandler (shobjidl_core.h)

Expone métodos para mostrar vistas previas enriquecidas.

Herencia

La interfaz IPreviewHandler hereda de la interfaz IUnknown . IPreviewHandler también tiene estos tipos de miembros:

Métodos

La interfaz IPreviewHandler tiene estos métodos.

IPreviewHandler::D oPreview Dirige el controlador de vista previa para cargar datos desde el origen especificado en una llamada de método Initialize anterior y para comenzar la representación en la ventana del controlador de vista previa.
IPreviewHandler::QueryFocus Dirige el controlador de vista previa para devolver el HWND desde una llamada a la función GetFocus.
IPreviewHandler::SetFocus Dirige el controlador de vista previa para establecer el foco en sí mismo.
IPreviewHandler::SetRect Dirige el controlador de vista previa para cambiar el área dentro del hwnd primario en el que se dibuja.
IPreviewHandler::SetWindow 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.
IPreviewHandler::TranslateAccelerator Dirige el controlador de vista previa para controlar una pulsación de tecla pasada desde la bomba de mensajes del proceso en el que se ejecuta el controlador de vista previa.
IPreviewHandler::Unload Dirige al controlador de vista previa para dejar de representar una vista previa y liberar todos los recursos asignados en función del elemento pasado durante la inicialización.

Comentarios

Los controladores de vista previa se pueden compilar en código administrado. Normalmente, todos los controladores de vista previa se hospedan juntos en un proceso suplente denominado prevhost.exe. Hay una instancia de este proceso para los controladores de versión preliminar que se ejecutan en el nivel de integridad normal y otra instancia de controladores de vista previa que se ejecutan en un nivel de integridad bajo. Si desea implementar el controlador en código administrado, el controlador no debe ejecutarse dentro de ninguno de estos procesos compartidos. En su lugar, organice el controlador para obtener una nueva instancia de prevhost.exe mediante la creación de una nueva entrada appID en el Registro (especificando prevhost.exe como el valor DllSurrogate) y, a continuación, estableciendo eso como el valor appID en el valor del Registro para el identificador de clase del controlador. Esto garantizará que se cree una instancia de prevhost.exe única para el controlador, en lugar de las instancias comunes usadas por los demás controladores.

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
Redistribuible	Windows Search 4 o posterior