Método IPreviewHandlerFrame::GetWindowContext (shobjidl_core.h)
Obtém uma lista dos atalhos de teclado para o host de visualização.
Sintaxe
HRESULT GetWindowContext(
[out] PREVIEWHANDLERFRAMEINFO *pinfo
);
Parâmetros
[out] pinfo
Tipo: PREVIEWHANDLERFRAMEINFO*
Um ponteiro para uma estrutura PREVIEWHANDLERFRAMEINFO que recebe informações da tabela de aceleradores.
Retornar valor
Tipo: HRESULT
Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.
Comentários
Uma tabela de aceleradores é uma lista de atalhos de teclado e os comandos que o host deve executar. Como otimização, o manipulador de visualização pode examinar os pressionamentos de tecla recebidos, marcar-los na tabela de aceleradores para ver se o host está interessado neles e encaminhá-los, se apropriado, ignorando os comandos na estrutura. A tabela de aceleradores retornada de IPreviewHandlerFrame::GetWindowContext contém apenas pressionamentos de tecla e não contém entradas de comando válidas. Os manipuladores de visualização também podem ignorar essa otimização e simplesmente chamar IPreviewHandlerFrame::TranslateAccelerator para cada pressionamento de tecla. Quando o manipulador de visualização é destruído, a tabela de aceleradores deve ser liberada usando a função DestroyAcceleratorTable .
Esse método deve ser chamado no ponto em que o manipulador de visualização chamou SetSite e os resultados foram armazenados em cache para uso posterior pelo manipulador de visualização. Esse método não pode ser chamado por manipuladores de visualização em execução no modo de baixa integridade. Esses manipuladores de visualização sempre devem chamar IPreviewHandlerFrame::TranslateAccelerator para cada pressionamento de tecla.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista, Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | shobjidl_core.h (inclua Shobjidl.h) |
| Redistribuível | Windows Search 4 ou posterior |