Windows Dev Center

StorageFolder.GetThumbnailAsync | getThumbnailAsync methods

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.

Note  The StorageFolder.GetThumbnailAsync method sometimes returns the default image of a folder. For Windows Phone Store apps, 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:
© 2015 Microsoft