WTS_FLAGS 枚举 (thumbcache.h)

IThumbnailCache::GetThumbnail 用于指定缩略图提取和显示选项的值。

语法

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

常量

 
WTS_NONE
值: 0
0x00000000。 在 Windows 8 中引入。 未设置以下任何选项。
WTS_EXTRACT
值: 0
默认。 0x00000000。 提取缩略图(如果未缓存)。
WTS_INCACHEONLY
值: 0x1
0x00000001。 仅当缩略图已缓存时,才返回缩略图。
WTS_FASTEXTRACT
值: 0x2
0x00000002。 如果未缓存,则仅提取以 EXIF 格式嵌入的缩略图,通常为 96x96。
WTS_FORCEEXTRACTION
值: 0x4
0x00000004。 忽略缓存并从源文件中提取缩略图。
WTS_SLOWRECLAIM
值: 0x8
0x00000008。 缩略图的生存期延长。 用于可能脱机的卷,例如非固定磁盘。
WTS_EXTRACTDONOTCACHE
值: 0x20
0x00000020。 提取缩略图,但不要将缩略图添加到缓存。
WTS_SCALETOREQUESTEDSIZE
值: 0x40
0x00000040。 在 Windows 7 中引入。 如果 cxyRequestedThumbSize 参数中请求的特定缩略图大小不可用,请将缩略图大小调整为请求的大小。 如果可能,较大的位图会缩小比例,使其纵横比保持为所需的宽度和高度。 如果唯一可用的缓存缩略图小于请求的大小,则使用最近邻算法纵向扩展该缩略图。
WTS_SKIPFASTEXTRACT
值: 0x80
0x00000080。 在 Windows 7 中引入。 不要提取嵌入在 EXIF 图像元数据中的缩略图。
WTS_EXTRACTINPROC
值: 0x100
0x00000100。 在 Windows 7 中引入。 确保缩略图处理程序加载到与调用方相同的进程中。 如果未指定此标志,处理程序将加载到代理进程中,以保护调用方免受因处理目标文件而导致的意外崩溃。 调试缩略图提取程序时使用此值。
WTS_CROPTOSQUARE
值: 0x200
0x00000200。 在 Windows 8 中引入。 如有必要,请裁剪位图的尺寸,使其为正方形。 最短边的长度变为所有边的长度。
WTS_INSTANCESURROGATE
值: 0x400
0x00000400。 在 Windows 8 中引入。 为此缓存实例创建代理项,而不是使用共享 DLLHost 代理项。
WTS_REQUIRESURROGATE
值: 0x800
0x00000800。 在 Windows 8 中引入。 要求在代理项中进行提取。
WTS_APPSTYLE
值: 0x2000
0x00002000。 Windows 8 及更高版本。 将 WTSCF_APPSTYLE 标志传递给 IThumbnailSettings::SetContext(如果提供程序支持)。
WTS_WIDETHUMBNAILS
值: 0x4000
0x00004000。 Windows 8 及更高版本。 拉伸和裁剪位图,使其高度为宽度的 0.7 倍。
WTS_IDEALCACHESIZEONLY
值: 0x8000
0x00008000。 Windows 8 及更高版本。 仅从理想的缓存对齐大小返回。 返回的图像可能较大,但它将从正确的缓存条目中提取。
WTS_SCALEUP
值: 0x10000
0x00010000。 Windows 8 及更高版本。 如有必要,请拉伸图像,使高度和宽度适合给定的大小。

注解

以下组合有效。

WTS_INCACHEONLY
WTS_FASTEXTRACT
WTS_EXTRACT
WTS_EXTRACT |WTS_SLOWRECLAIM
WTS_FORCEEXTRACTION
WTS_FORCEEXTRACTION |WTS_SLOWRECLAIM
WTS_EXTRACTDONOTCACHE

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
标头 thumbcache.h

另请参阅

IThumbnailCache::GetThumbnail

IThumbnailSettings::SetContext