enumerazione WTS_FLAGS (thumbcache.h)

Articolo
08/08/2024

Valori usati da IThumbnailCache::GetThumbnail per specificare le opzioni per l'estrazione e la visualizzazione dell'immagine di anteprima.

Sintassi

typedef enum WTS_FLAGS {
  WTS_NONE = 0,
  WTS_EXTRACT = 0,
  WTS_INCACHEONLY = 0x1,
  WTS_FASTEXTRACT = 0x2,
  WTS_FORCEEXTRACTION = 0x4,
  WTS_SLOWRECLAIM = 0x8,
  WTS_EXTRACTDONOTCACHE = 0x20,
  WTS_SCALETOREQUESTEDSIZE = 0x40,
  WTS_SKIPFASTEXTRACT = 0x80,
  WTS_EXTRACTINPROC = 0x100,
  WTS_CROPTOSQUARE = 0x200,
  WTS_INSTANCESURROGATE = 0x400,
  WTS_REQUIRESURROGATE = 0x800,
  WTS_APPSTYLE = 0x2000,
  WTS_WIDETHUMBNAILS = 0x4000,
  WTS_IDEALCACHESIZEONLY = 0x8000,
  WTS_SCALEUP = 0x10000
} ;

Costanti


`WTS_NONE` Valore: 0 0x00000000. Introdotta in Windows 8. Nessuna delle opzioni seguenti è impostata.
`WTS_EXTRACT` Valore: 0 Valore predefinito. 0x00000000. Estrarre l'anteprima se non è memorizzata nella cache.
`WTS_INCACHEONLY` Valore: 0x1 0x00000001. Restituisce solo l'anteprima se viene memorizzata nella cache.
`WTS_FASTEXTRACT` Valore: 0x2 0x00000002. Se non memorizzato nella cache, estrarre l'anteprima solo se è incorporata in formato EXIF, in genere 96x96.
`WTS_FORCEEXTRACTION` Valore: 0x4 0x00000004. Ignorare la cache ed estrarre l'anteprima dal file di origine.
`WTS_SLOWRECLAIM` Valore: 0x8 0x00000008. L'anteprima ha una durata estesa. Usare per i volumi che potrebbero essere offline, ad esempio dischi non fissi.
`WTS_EXTRACTDONOTCACHE` Valore: 0x20 0x00000020. Estrarre ma non aggiungere l'anteprima alla cache.
`WTS_SCALETOREQUESTEDSIZE` Valore: 0x40 0x00000040. Introdotta in Windows 7. Se la dimensione dell'anteprima specifica richiesta nel parametro cxyRequestedThumbSize non è disponibile, ridimensionare l'anteprima alla dimensione richiesta. Se possibile, una bitmap più grande è ridotta in scala, mantenendo il rapporto di aspetto, con la larghezza e l'altezza necessaria. Se l'unica anteprima memorizzata nella cache disponibile è inferiore alla dimensione richiesta, viene ridimensionata usando l'algoritmo adiacente più vicino.
`WTS_SKIPFASTEXTRACT` Valore: 0x80 0x00000080. Introdotta in Windows 7. Non estrarre un'anteprima incorporata nei metadati di un'immagine EXIF.
`WTS_EXTRACTINPROC` Valore: 0x100 0x00000100. Introdotta in Windows 7. Assicura che il gestore dell'anteprima venga caricato nello stesso processo del chiamante. Quando questo flag non viene specificato, il gestore viene caricato in un processo surrogato per proteggere il chiamante da arresti anomali imprevisti causati dall'elaborazione del file di destinazione. Usare questo valore durante il debug degli estrattori di anteprima.
`WTS_CROPTOSQUARE` Valore: 0x200 0x00000200. Introdotta in Windows 8. Se necessario, ritagliare le dimensioni della bitmap in modo che sia quadrato. La lunghezza del lato più corto diventa la lunghezza di tutti i lati.
`WTS_INSTANCESURROGATE` Valore: 0x400 0x00000400. Introdotta in Windows 8. Creare un surrogato per questa istanza della cache anziché usare il surrogato DLLHost condiviso.
`WTS_REQUIRESURROGATE` Valore: 0x800 0x00000800. Introdotta in Windows 8. Richiedere l'estrazione del surrogato.
`WTS_APPSTYLE` Valore: 0x2000 0x00002000. Windows 8 e versioni successive. Passare il flag di WTSCF_APPSTYLE a IThumbnailSettings::SetContext, se il provider lo supporta.
`WTS_WIDETHUMBNAILS` Valore: 0x4000 0x00004000. Windows 8 e versioni successive. Estendere e ritagliare la bitmap in modo che l'altezza sia 0,7 volte la larghezza.
`WTS_IDEALCACHESIZEONLY` Valore: 0x8000 0x00008000. Windows 8 e versioni successive. Restituisce solo le dimensioni dello snap della cache ideale. L'immagine restituita potrebbe essere più grande, ma verrà estratta dalla voce della cache corretta.
`WTS_SCALEUP` Valore: 0x10000 0x00010000. Windows 8 e versioni successive. Se necessario, estendere l'immagine in modo che l'altezza e la larghezza siano adattate alle dimensioni specificate.

Commenti

Le combinazioni seguenti sono valide.

WTS_INCACHEONLY

WTS_FASTEXTRACT

WTS_EXTRACT

WTS_EXTRACT | WTS_SLOWRECLAIM

WTS_FORCEEXTRACTION

WTS_FORCEEXTRACTION | WTS_SLOWRECLAIM

WTS_EXTRACTDONOTCACHE

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Intestazione	thumbcache.h

Vedi anche

IThumbnailCache::GetThumbnail

IThumbnailSettings::SetContext

Condividi tramite