Método IPreviewHandlerFrame::GetWindowContext (shobjidl_core.h)
Obtiene una lista de los métodos abreviados de teclado para el host de vista previa.
Sintaxis
HRESULT GetWindowContext(
[out] PREVIEWHANDLERFRAMEINFO *pinfo
);
Parámetros
[out] pinfo
Tipo: PREVIEWHANDLERFRAMEINFO*
Puntero a una estructura PREVIEWHANDLERFRAMEINFO que recibe información de la tabla del acelerador.
Valor devuelto
Tipo: HRESULT
Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Comentarios
Una tabla de aceleradores es una lista de métodos abreviados de teclado y los comandos que debe ejecutar el host. Como optimización, el controlador de vista previa puede examinar las pulsaciones de teclas que recibe, comprobarlas en la tabla de aceleradores para ver si el host está interesado en ellos y reenviarlos si es necesario, ignorando los comandos de la estructura. La tabla de aceleradores devuelta de IPreviewHandlerFrame::GetWindowContext solo contiene pulsaciones de tecla y no contiene entradas de comando válidas. Los controladores de vista previa también pueden omitir esta optimización y simplemente llamar a IPreviewHandlerFrame::TranslateAccelerator para cada pulsación de tecla. Cuando se destruye el controlador de vista previa, la tabla de aceleradores debe liberarse mediante la función DestroyAcceleratorTable .
Se debe llamar a este método en el momento en que el controlador de vista previa ha llamado a SetSite y los resultados se han almacenado en caché para su uso posterior por el controlador de vista previa. Los controladores de vista previa que se ejecutan en modo de baja integridad no pueden llamar a este método. Esos controladores de vista previa siempre deben llamar a IPreviewHandlerFrame::TranslateAccelerator para cada pulsación de tecla.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista, Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | shobjidl_core.h (incluya Shobjidl.h) |
| Redistribuible | Windows Search 4 o posterior |