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 supports a bitwise combination of its member values.

public enum class ThumbnailOptions
/// [System.Flags]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
enum class ThumbnailOptions
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public enum ThumbnailOptions
var value = Windows.Storage.FileProperties.ThumbnailOptions.none
Public Enum ThumbnailOptions

Windows requirements

Device family
Windows 10 (introduced in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced in v1.0)


None 0

No options.

ResizeThumbnail 2

Scale the thumbnail to the requested size.

ReturnOnlyIfCached 1

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

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.

Applies to

See also