StorageFolder.GetThumbnailAsync | getThumbnailAsync methods

Applies to Windows and Windows Phone

Gets a thumbnail image for the current folder, sized for the specified purpose of the thumbnail.

Overload list

MethodDescription
GetThumbnailAsync(ThumbnailMode) Gets a thumbnail image for the current folder, sized for the specified purpose of the thumbnail.
GetThumbnailAsync(ThumbnailMode, UInt32) Gets a thumbnail image for the current folder, sized for the specified purpose of the thumbnail and adjusted to the requested size.
GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions) Gets a thumbnail image for the current folder, sized for the specified purpose of the thumbnail and adjusted to the requested size with the specified options.

Remarks

For a sample that demonstrates the GetThumbnailAsync method, see File and folder thumbnail sample.

For guidance about choosing the best thumbnail mode, see Guidelines and checklist for thumbnails.

  • Applies to Windows Phone

The StorageFolder.GetThumbnailAsync method sometimes returns the default image of a folder. On Windows Phone, this method ignores the current theme when it returns this default image. The image returned is always the image for the dark theme; that is, the folder is transparent with a white border. If you want to return the image for the light theme, you have to create your own image that's visible on a light background. Then you have to use conditional logic to check the active theme. If the active theme is the light theme, use a method other than GetThumbnailAsync to retrieve your custom image.

Requirements

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Minimum supported phone

Windows Phone 8.1 [Windows Phone Silverlight 8.1 and Windows Runtime apps]

Namespace

Windows.Storage
Windows::Storage [C++]

Metadata

Windows.winmd

See also

StorageFolder

 

 

Show:
© 2014 Microsoft