ThumbnailOptions ThumbnailOptions ThumbnailOptions ThumbnailOptions ThumbnailOptions Enum


Describes the behavior used to retrieve and adjust thumbnails, including the size and quality of the image and how quickly the thumbnail image is retrieved.

This enumeration has a System.FlagsAttribute attribute that allows a bitwise combination of its member values.

public : enum class ThumbnailOptions
enum class winrt::Windows::Storage::FileProperties::ThumbnailOptions : uint32_t
public enum ThumbnailOptions
Public Enum ThumbnailOptions
var value = Windows.Storage.FileProperties.ThumbnailOptions.none;
System.FlagsAttribute ContractVersionAttribute

Windows 10 requirements

Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)


None None None None None 0

No options.

ResizeThumbnail ResizeThumbnail ResizeThumbnail ResizeThumbnail ResizeThumbnail 2

Scale the thumbnail to the requested size.

ReturnOnlyIfCached ReturnOnlyIfCached ReturnOnlyIfCached ReturnOnlyIfCached ReturnOnlyIfCached 1

Retrieve a thumbnail only if it is cached or embedded in the file.

UseCurrentScale UseCurrentScale UseCurrentScale UseCurrentScale UseCurrentScale 4

Default. Increase requested size based on the Pixels Per Inch (PPI) of the display.


This enumeration is used when you get a thumbnail image by calling one of the getThumbnailAsync method overloads like storageFile.getThumbnailAsync(mode, requestedSize, options). The thumbnail image that is returned is represented by a storageItemThumbnail object.

See also