ThumbnailFlags Enumeration

Specifies options for the extraction and display of a thumbnail image.

For GetThumbnail(IShellItem, UInt32, ThumbnailFlags, ISharedBitmap, ThumbnailCacheFlags, ThumbnailId) function.

Definition

Namespace: DevCase.Win32.Enums
Assembly: DevCase.net48 (in DevCase.net48.dll) Version: 6.0.0.0 (6.0)
XMLNS for XAML: Not mapped to an xmlns.
[FlagsAttribute]
public enum ThumbnailFlags

Remarks

Members

Extract 0 Extract the thumbnail if it is not cached.
InCacheOnly 1 Only return the thumbnail if it is cached.
FastExtract 2 If not cached, only extract the thumbnail if it is embedded in EXIF format, typically 96x96.
ForceExtract 4 Ignore cache and extract thumbnail from source file.
SlowReclaim 8 The thumbnail has an extended lifetime. Use for volumes that might go offline, like non-fixed disks.
ExtractDoNotcache 32 Extract but do not add the thumbnail to the cache.
ScaleForRequestedSize 64 If the specific thumbnail size requested in the requestedThumbSize parameter of GetThumbnail(IShellItem, UInt32, ThumbnailFlags, ISharedBitmap, ThumbnailCacheFlags, ThumbnailId) function is not available, resize the thumbnail to the requested size.

If possible, a larger bitmap is reduced in scale, preserving its aspect ratio, to the width and height required.

If the only available cached thumbnail is smaller than the requested size, then it is scaled up using the nearest-neighbor algorithm.

SkipFastExtract 128 Do not extract a thumbnail embedded in the metadata of an EXIF image.
ExtractInProc 256 Ensures that the thumbnail handler is loaded in the same process as the caller.

When this flag is not specified, the handler is loaded into a surrogate process to protect the caller from unexpected crashes caused by the processing of the target file.

Use this value when debugging thumbnail extractors.

CropToSquare 512 If necessary, crop the bitmap's dimensions so that is square.

The length of the shortest side becomes the length of all sides.

InstanceSurrogate 1,024 Create a surrogate for this instance of the cache rather than using the shared DLLHost surrogate.
RequireSurrogate 2,048 Require extractions to take place in the surrogate.
AppStyle 8,192 Pass the WTSCF_APPSTYLE flag to IThumbnailSettings::SetContext, if the provider supports it.
WideThumbnails 16,384 Stretch and crop the bitmap so that its height is 0.7 times its width.
IdealCacheSizeOnly 32,768 Return from the ideal cache snap size only.

The returned image might be larger, but it will be pulled from the correct cache entry.

ScaleUp 65,536 If necessary, stretch the image so that the height and width fit the given size.

See Also