StorageFolder.GetThumbnailAsync 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
오버로드
| GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions) |
현재 폴더에 대한 썸네일 이미지를 가져오며, 썸네일의 지정된 용도로 크기가 조정되고 지정된 옵션을 사용하여 요청된 크기로 조정됩니다. |
| GetThumbnailAsync(ThumbnailMode, UInt32) |
현재 폴더의 썸네일 이미지를 가져오며, 썸네일의 지정된 용도로 크기가 조정되고 요청된 크기로 조정됩니다. |
| GetThumbnailAsync(ThumbnailMode) |
현재 폴더의 축소판 그림 이미지를 가져오며 썸네일의 지정된 용도로 크기가 조정됩니다. |
GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)
현재 폴더에 대한 썸네일 이미지를 가져오며, 썸네일의 지정된 용도로 크기가 조정되고 지정된 옵션을 사용하여 요청된 크기로 조정됩니다.
public:
virtual IAsyncOperation<StorageItemThumbnail ^> ^ GetThumbnailAsync(ThumbnailMode mode, unsigned int requestedSize, ThumbnailOptions options) = GetThumbnailAsync;/// [Windows.Foundation.Metadata.Overload("GetThumbnailAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StorageItemThumbnail> GetThumbnailAsync(ThumbnailMode const& mode, uint32_t const& requestedSize, ThumbnailOptions const& options);[Windows.Foundation.Metadata.Overload("GetThumbnailAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StorageItemThumbnail> GetThumbnailAsync(ThumbnailMode mode, uint requestedSize, ThumbnailOptions options);function getThumbnailAsync(mode, requestedSize, options)Public Function GetThumbnailAsync (mode As ThumbnailMode, requestedSize As UInteger, options As ThumbnailOptions) As IAsyncOperation(Of StorageItemThumbnail)매개 변수
- mode
- ThumbnailMode
썸네일의 용도를 설명하고 썸네일 이미지를 조정하는 방법을 결정하는 열거형의 값입니다.
최상의 썸네일 모드를 선택하는 방법에 대한 지침은 미리 보기에 대한 지침 및 검사 목록을 참조하세요.
- requestedSize
-
UInt32
unsigned int
uint32_t
썸네일의 가장 긴 가장자리의 요청된 크기(픽셀)입니다. 이 메서드는 requestedSize 를 가이드로 사용하고 이미지 품질을 줄이지 않고 축소판 그림 이미지의 크기를 조정하려고 합니다.
이 메서드가 요청된 크기로 확장할 수 있는 썸네일 이미지를 찾을 수 없는 경우 더 큰 썸네일을 반환할 수 있습니다. 더 큰 축소판 그림을 사용할 수 없는 경우 요청된 크기보다 작은 썸네일 이미지를 반환할 수 있습니다.
- options
- ThumbnailOptions
이미지를 검색하고 크기를 조정하는 방법을 지정하는 열거형의 값입니다. 기본값인 UseCurrentScale은 대부분의 앱에 적합합니다.
반환
이 메서드가 성공적으로 완료되면 미리 보기 이미지를 나타내는 StorageItemThumbnail 을 반환하거나 폴더와 연결된 썸네일 이미지가 없는 경우 null 을 반환합니다.
구현
- 특성
추가 정보
적용 대상
GetThumbnailAsync(ThumbnailMode, UInt32)
현재 폴더의 썸네일 이미지를 가져오며, 썸네일의 지정된 용도로 크기가 조정되고 요청된 크기로 조정됩니다.
public:
virtual IAsyncOperation<StorageItemThumbnail ^> ^ GetThumbnailAsync(ThumbnailMode mode, unsigned int requestedSize) = GetThumbnailAsync;/// [Windows.Foundation.Metadata.Overload("GetThumbnailAsyncOverloadDefaultOptions")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StorageItemThumbnail> GetThumbnailAsync(ThumbnailMode const& mode, uint32_t const& requestedSize);[Windows.Foundation.Metadata.Overload("GetThumbnailAsyncOverloadDefaultOptions")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StorageItemThumbnail> GetThumbnailAsync(ThumbnailMode mode, uint requestedSize);function getThumbnailAsync(mode, requestedSize)Public Function GetThumbnailAsync (mode As ThumbnailMode, requestedSize As UInteger) As IAsyncOperation(Of StorageItemThumbnail)매개 변수
- mode
- ThumbnailMode
썸네일의 용도를 설명하고 썸네일 이미지를 조정하는 방법을 결정하는 열거형의 값입니다.
최상의 썸네일 모드를 선택하는 방법에 대한 지침은 미리 보기에 대한 지침 및 검사 목록을 참조하세요.
- requestedSize
-
UInt32
unsigned int
uint32_t
썸네일의 가장 긴 가장자리의 요청된 크기(픽셀)입니다. 이 메서드는 requestedSize 를 가이드로 사용하고 이미지 품질을 줄이지 않고 축소판 그림 이미지의 크기를 조정하려고 합니다.
이 메서드가 요청된 크기로 확장할 수 있는 썸네일 이미지를 찾을 수 없는 경우 더 큰 썸네일을 반환할 수 있습니다. 더 큰 축소판 그림을 사용할 수 없는 경우 요청된 크기보다 작은 썸네일 이미지를 반환할 수 있습니다.
반환
이 메서드가 성공적으로 완료되면 미리 보기 이미지를 나타내는 StorageItemThumbnail 을 반환하거나 폴더와 연결된 썸네일 이미지가 없는 경우 null 을 반환합니다.
구현
- 특성
추가 정보
적용 대상
GetThumbnailAsync(ThumbnailMode)
현재 폴더의 축소판 그림 이미지를 가져오며 썸네일의 지정된 용도로 크기가 조정됩니다.
public:
virtual IAsyncOperation<StorageItemThumbnail ^> ^ GetThumbnailAsync(ThumbnailMode mode) = GetThumbnailAsync;/// [Windows.Foundation.Metadata.Overload("GetThumbnailAsyncOverloadDefaultSizeDefaultOptions")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StorageItemThumbnail> GetThumbnailAsync(ThumbnailMode const& mode);[Windows.Foundation.Metadata.Overload("GetThumbnailAsyncOverloadDefaultSizeDefaultOptions")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StorageItemThumbnail> GetThumbnailAsync(ThumbnailMode mode);function getThumbnailAsync(mode)Public Function GetThumbnailAsync (mode As ThumbnailMode) As IAsyncOperation(Of StorageItemThumbnail)매개 변수
- mode
- ThumbnailMode
썸네일의 용도를 설명하고 썸네일 이미지를 조정하는 방법을 결정하는 열거형의 값입니다.
최상의 썸네일 모드를 선택하는 방법에 대한 지침은 미리 보기에 대한 지침 및 검사 목록을 참조하세요.
반환
이 메서드가 성공적으로 완료되면 미리 보기 이미지를 나타내는 StorageItemThumbnail 을 반환하거나 폴더와 연결된 썸네일 이미지가 없는 경우 null 을 반환합니다.
구현
- 특성
예제
다음 예제에서는 사용자의 사진 폴더에 대한 미리 보기 이미지를 가져오고 이미지 컨트롤에 썸네일을 표시합니다. 또한 이 예제에서는 가장 긴 면이 64픽셀인 이미지를 요청하고 디바이스에 이미 캐시된 경우에만 이미지를 요청합니다. 이 예제에서는 현재 페이지에 ImageControl이라는 이미지 컨트롤이 있다고 가정합니다.
다음 예제를 실행하기 전에 앱 매니페스트 파일에서 그림 라이브러리 기능을 사용하도록 설정합니다.
using Windows.Storage;
using Windows.Storage.FileProperties;
using System.Threading.Tasks;
using Windows.UI.Xaml.Media.Imaging; // For the Bitmap object.
// Get the user's Pictures folder.
// Enable the corresponding capability in the app manifest file.
StorageFolder picturesFolder = KnownFolders.PicturesLibrary;
// Get a thumbnail for the current folder.
StorageItemThumbnail thumb =
await picturesFolder.GetThumbnailAsync(ThumbnailMode.SingleItem,
64, ThumbnailOptions.ReturnOnlyIfCached);
// Display the thumbnail in an Image control
// named ImageControl on the current page.
BitmapImage bitmapImage = new BitmapImage();
bitmapImage.SetSource(thumb);
ImageControl.Source = bitmapImage;
설명
GetThumbnailAsync 메서드를 보여 주는 샘플은 파일 및 폴더 미리 보기 샘플을 참조하세요.
최상의 썸네일 모드를 선택하는 방법에 대한 지침은 미리 보기에 대한 지침 및 검사 목록을 참조하세요.
StorageFolder.GetThumbnailAsync 메서드는 폴더의 기본 이미지를 반환하는 경우가 있습니다. Windows Phone 8.x 앱의 경우 이 기본 이미지를 반환할 때 이 메서드는 현재 테마를 무시합니다. 반환되는 이미지는 항상 어두운 테마의 이미지입니다. 즉, 폴더는 흰색 테두리로 투명합니다. 밝은 테마에 대한 이미지를 반환하려면 밝은 배경에 표시되는 고유한 이미지를 만들어야 합니다. 그런 다음 조건부 논리를 사용하여 활성 테마를 검사 합니다. 활성 테마가 밝은 테마인 경우 GetThumbnailAsync 이외의 메서드를 사용하여 사용자 지정 이미지를 검색합니다.