Metodo IPreviewHandlerFrame::GetWindowContext (shobjidl_core.h)

  • Articolo

Ottiene un elenco dei tasti di scelta rapida per l'host di anteprima.

Sintassi

HRESULT GetWindowContext(
  [out] PREVIEWHANDLERFRAMEINFO *pinfo
);

Parametri

[out] pinfo

Tipo: PREVIEWHANDLERFRAMEINFO*

Puntatore a una struttura PREVIEWHANDLERFRAMEINFO che riceve informazioni sulla tabella degli acceleratori.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Una tabella di tasti di scelta rapida è un elenco di tasti di scelta rapida e i comandi che l'host deve eseguire. Come ottimizzazione, il gestore di anteprima può quindi esaminare le sequenze di tasti ricevute, controllarle sulla tabella dell'acceleratore per verificare se l'host è interessato e inoltrarle, se appropriato, ignorando i comandi nella struttura. La tabella dell'acceleratore restituita da IPreviewHandlerFrame::GetWindowContext contiene solo sequenze di tasti e non contiene voci di comando valide. I gestori di anteprima possono anche ignorare questa ottimizzazione e semplicemente chiamare IPreviewHandlerFrame::TranslateAccelerator per ogni sequenza di tasti. Quando il gestore di anteprima viene eliminato definitivamente, la tabella dell'acceleratore deve essere liberata usando la funzione DestroyAcceleratorTable .

Questo metodo deve essere chiamato nel momento in cui il gestore di anteprima ha chiamato SetSite e i risultati sono stati memorizzati nella cache per un uso successivo da parte del gestore di anteprima. Questo metodo non può essere chiamato dai gestori di anteprima in esecuzione in modalità di bassa integrità. Questi gestori di anteprima devono sempre chiamare IPreviewHandlerFrame::TranslateAccelerator per ogni sequenza di tasti.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista, Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione shobjidl_core.h (include Shobjidl.h)
Componente ridistribuibile Windows Search 4 o versione successiva

Vedi anche

IPreviewHandlerFrame

IPreviewHandlerFrame::TranslateAccelerator