enumeração WTS_FLAGS (thumbcache.h)

  • Artigo

Valores usados por IThumbnailCache::GetThumbnail para especificar opções para extração e exibição da imagem em miniatura.

Syntax

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
} ;

Constantes

 
WTS_NONE
Valor: 0
0x00000000. Introduzido no Windows 8. Nenhuma das opções a seguir está definida.
WTS_EXTRACT
Valor: 0
Padrão. 0x00000000. Extraia a miniatura se ela não estiver armazenada em cache.
WTS_INCACHEONLY
Valor: 0x1
0x00000001. Retornará apenas a miniatura se ela estiver armazenada em cache.
WTS_FASTEXTRACT
Valor: 0x2
0x00000002. Se não estiver armazenado em cache, extraia apenas a miniatura se ela estiver inserida no formato EXIF, normalmente 96x96.
WTS_FORCEEXTRACTION
Valor: 0x4
0x00000004. Ignore o cache e extraia a miniatura do arquivo de origem.
WTS_SLOWRECLAIM
Valor: 0x8
0x00000008. A miniatura tem um tempo de vida estendido. Use para volumes que podem ficar offline, como discos não fixos.
WTS_EXTRACTDONOTCACHE
Valor: 0x20
0x00000020. Extraia, mas não adicione a miniatura ao cache.
WTS_SCALETOREQUESTEDSIZE
Valor: 0x40
0x00000040. Introduzido no Windows 7. Se o tamanho da miniatura específico solicitado no parâmetro cxyRequestedThumbSize não estiver disponível, redimensione a miniatura para o tamanho solicitado. Se possível, um bitmap maior é reduzido em escala, preservando sua taxa de proporção, para a largura e a altura necessárias. Se a única miniatura em cache disponível for menor que o tamanho solicitado, ela será escalada verticalmente usando o algoritmo vizinho mais próximo.
WTS_SKIPFASTEXTRACT
Valor: 0x80
0x00000080. Introduzido no Windows 7. Não extraia uma miniatura inserida nos metadados de uma imagem EXIF.
WTS_EXTRACTINPROC
Valor: 0x100
0x00000100. Introduzido no Windows 7. Garante que o manipulador de miniaturas seja carregado no mesmo processo que o chamador. Quando esse sinalizador não é especificado, o manipulador é carregado em um processo alternativo para proteger o chamador contra falhas inesperadas causadas pelo processamento do arquivo de destino. Use esse valor ao depurar extratores de miniatura.
WTS_CROPTOSQUARE
Valor: 0x200
0x00000200. Introduzido no Windows 8. Se necessário, corte as dimensões do bitmap para que seja quadrada. O comprimento do lado mais curto torna-se o comprimento de todos os lados.
WTS_INSTANCESURROGATE
Valor: 0x400
0x00000400. Introduzido no Windows 8. Crie um substituto para essa instância do cache em vez de usar o substituto DLLHost compartilhado.
WTS_REQUIRESURROGATE
Valor: 0x800
0x00000800. Introduzido no Windows 8. Exigir que as extrações ocorram no substituto.
WTS_APPSTYLE
Valor: 0x2000
0x00002000. Windows 8 e posterior. Passe o sinalizador WTSCF_APPSTYLE para IThumbnailSettings::SetContext, se o provedor der suporte a ele.
WTS_WIDETHUMBNAILS
Valor: 0x4000
0x00004000. Windows 8 e posterior. Estique e corte o bitmap para que sua altura seja 0,7 vezes sua largura.
WTS_IDEALCACHESIZEONLY
Valor: 0x8000
0x00008000. Windows 8 e posterior. Retornar somente do tamanho ideal de ajuste de cache. A imagem retornada pode ser maior, mas será extraída da entrada de cache correta.
WTS_SCALEUP
Valor: 0x10000
0x00010000. Windows 8 e posterior. Se necessário, estique a imagem para que a altura e a largura se ajustem ao tamanho especificado.

Comentários

As combinações a seguir são válidas.

WTS_INCACHEONLY
WTS_FASTEXTRACT
WTS_EXTRACT
WTS_EXTRACT | WTS_SLOWRECLAIM
WTS_FORCEEXTRACTION
WTS_FORCEEXTRACTION | WTS_SLOWRECLAIM
WTS_EXTRACTDONOTCACHE

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho thumbcache.h

Confira também

IThumbnailCache::GetThumbnail

IThumbnailSettings::SetContext