Метод IPreviewHandler::SetWindow (shobjidl_core.h)

  • Статья

Задает родительское окно окна средства предварительного просмотра, а также область внутри родительского элемента, которая будет использоваться для окна средства предварительного просмотра.

Синтаксис

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

Параметры

[in] hwnd

Тип: HWND

Дескриптор родительского окна.

[in] prc

Тип: const RECT*

Указатель на RECT , определяющий область для средства предварительного просмотра.

Возвращаемое значение

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Обработчик предварительного просмотра отвечает за рисование всей области, определенной prc. Если окно средства предварительного просмотра было создано, обработчик предварительного просмотра должен связать окно средства предварительного просмотра с новым родительским hwnd и изменить размер окна средства предварительного просмотра с областью, определенной prc. Если окно средства предварительного просмотра еще не создано, обработчик предварительного просмотра должен запомнить эти сведения при создании окна средства предварительного просмотра в IPreviewHandler::D oPreview.

Примечание Рекомендуется хранить эти сведения перед вызовом IPreviewHandler::D oPreview. Это повышает производительность во время установки для всех случаев, когда предварительная версия не запускается.
 

Требования

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