Интерфейс 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 или более поздней версии |