Интерфейс IPreviewHandler (shobjidl_core.h)

Предоставляет методы для отображения полнофункционированных предварительных просмотров.

Наследование

Интерфейс IPreviewHandler наследуется от интерфейса IUnknown . IPreviewHandler также имеет следующие типы элементов:

Методы

Интерфейс IPreviewHandler содержит следующие методы.

IPreviewHandler::D oPreview Направляет обработчик предварительного просмотра, чтобы загрузить данные из источника, указанного в предыдущем вызове метода Initialize, и начать отрисовку в окне средства предварительного просмотра.
IPreviewHandler::QueryFocus Направляет обработчик предварительного просмотра на возврат HWND из вызова функции GetFocus.
IPreviewHandler::SetFocus Направляет обработчик предварительного просмотра для установки фокуса на себя.
IPreviewHandler::SetRect Направляет обработчик предварительного просмотра на изменение области в родительском элементе hwnd, в которую он отрисовывается.
IPreviewHandler::SetWindow Задает родительское окно окна средства предварительного просмотра, а также область внутри родительского элемента, которая будет использоваться для окна средства предварительного просмотра.
IPreviewHandler::TranslateAccelerator Направляет обработчик предварительного просмотра на обработку нажатия клавиши, переданного из насоса сообщений процесса, в котором выполняется обработчик предварительного просмотра.
IPreviewHandler::Unload Предписывает обработчику предварительного просмотра прекратить отрисовку предварительного просмотра и освободить все ресурсы, выделенные на основе элемента, переданного во время инициализации.

Комментарии

Обработчики предварительной версии можно встроить в управляемый код. Как правило, все обработчики предварительного просмотра размещаются вместе в суррогатном процессе, который называется prevhost.exe. Существует один экземпляр этого процесса для обработчиков предварительной версии, работающих на нормальном уровне целостности, а другой экземпляр для обработчиков предварительной версии, работающих на низком уровне целостности. Если вы хотите реализовать обработчик в управляемом коде, обработчик не должен выполняться в любом из этих общих процессов. Вместо этого настройте обработчик, чтобы получить новый экземпляр prevhost.exe, создав новую запись AppID в реестре (указав prevhost.exe в качестве значения DllSurrogate), а затем задав ее в качестве значения AppID в значении реестра для идентификатора класса обработчика. Это обеспечит создание уникального экземпляра prevhost.exe для обработчика вместо общих экземпляров, используемых другими обработчиками.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista, Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	shobjidl_core.h
Распространяемые компоненты	Windows Search 4 или более поздней версии