Метод IPreviewHandlerFrame::GetWindowContext (shobjidl_core.h)
Возвращает список сочетаний клавиш для узла предварительного просмотра.
Синтаксис
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 или более поздней версии |