Método IPreviewHandlerFrame::GetWindowContext (shobjidl_core.h)

  • Artigo

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

Confira também

IPreviewHandlerFrame

IPreviewHandlerFrame::TranslateAccelerator