Метод IPreviewHandlerFrame::GetWindowContext (shobjidl_core.h)

Статья
08/26/2023

Возвращает список сочетаний клавиш для узла предварительного просмотра.

Синтаксис

HRESULT GetWindowContext(
  [out] PREVIEWHANDLERFRAMEINFO *pinfo
);

Параметры

[out] pinfo

Тип: PREVIEWHANDLERFRAMEINFO*

Указатель на структуру PREVIEWHANDLERFRAMEINFO , которая получает сведения о таблице ускорителя.

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

Тип: HRESULT

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

Таблица ускорителей — это список сочетаний клавиш и команд, которые должен выполнять узел. В качестве оптимизации обработчик предварительного просмотра может затем просматривать полученные нажатия клавиш, проверка их в таблице ускорителей, чтобы узнать, заинтересованы ли они в узле, и пересылать их, если это необходимо, игнорируя команды в структуре. Таблица ускорителей, возвращаемая из IPreviewHandlerFrame::GetWindowContext, содержит только нажатия клавиш и не содержит допустимых записей команд. Обработчики предварительного просмотра также могут пропустить эту оптимизацию и просто вызывать IPreviewHandlerFrame::TranslateAccelerator для каждого нажатия клавиши. При уничтожении обработчика предварительного просмотра таблица ускорителей должна быть освобождена с помощью функции DestroyAcceleratorTable .

Этот метод следует вызывать в момент, когда обработчик предварительного просмотра вызывает SetSite и результаты кэшируются для последующего использования обработчиком предварительного просмотра. Этот метод не может вызываться обработчиками предварительного просмотра, работающими в режиме низкой целостности. Эти обработчики предварительного просмотра всегда должны вызывать IPreviewHandlerFrame::TranslateAccelerator для каждого нажатия клавиши.

Требования

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

См. также раздел

IPreviewHandlerFrame

IPreviewHandlerFrame::TranslateAccelerator