Interfaccia IPreviewHandler (shobjidl_core.h)

Espone i metodi per la visualizzazione di anteprime avanzate.

Ereditarietà

L'interfaccia IPreviewHandler eredita dall'interfaccia IUnknown . IPreviewHandler include anche questi tipi di membri:

Metodi

L'interfaccia IPreviewHandler include questi metodi.

IPreviewHandler::D oPreview Indirizza il gestore di anteprima a caricare i dati dall'origine specificata in una chiamata di metodo Initialize precedente e per iniziare a eseguire il rendering nella finestra dell'anteprima.
IPreviewHandler::QueryFocus Indirizza il gestore di anteprima per restituire HWND chiamando la funzione GetFocus.
IPreviewHandler::SetFocus Indirizza il gestore di anteprima per impostare lo stato attivo su se stesso.
IPreviewHandler::SetRect Indirizza il gestore di anteprima per modificare l'area all'interno dell'oggetto padre in cui viene disegnato.
IPreviewHandler::SetWindow Imposta la finestra padre della finestra dell'anteprima, nonché l'area all'interno dell'elemento padre da usare per la finestra di anteprima.
IPreviewHandler::TranslateAccelerator Indirizza il gestore di anteprima per gestire una sequenza di tasti passata dalla pompa dei messaggi del processo in cui è in esecuzione il gestore di anteprima.
IPreviewHandler::Unload Indirizza il gestore di anteprima per interrompere il rendering di un'anteprima e rilasciare tutte le risorse allocate in base all'elemento passato durante l'inizializzazione.

Commenti

I gestori di anteprima possono essere compilati nel codice gestito. In genere, tutti i gestori di anteprima sono ospitati insieme in un processo surrogato denominato prevhost.exe. Esiste un'istanza di questo processo per i gestori di anteprima in esecuzione a livello di integrità normale e un'altra istanza per i gestori di anteprima in esecuzione a basso livello di integrità. Se si vuole implementare il gestore nel codice gestito, il gestore non deve essere eseguito all'interno di uno di questi processi condivisi. In alternativa, disporre che il gestore ottenga una nuova istanza di prevhost.exe creando una nuova voce AppID nel Registro di sistema (specificando prevhost.exe come valore DllSurrogate) e quindi impostando che come valore AppID nel valore del Registro di sistema per l'ID classe del gestore. In questo modo si garantisce che venga creata un'istanza di prevhost.exe univoca per il gestore, anziché le istanze comuni usate dagli altri gestori.

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
Componente ridistribuibile	Windows Search 4 o versione successiva