다음을 통해 공유


StorageFile.GetThumbnailAsync 메서드

정의

오버로드

GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)

미리 보기의 목적, 요청된 크기 및 지정된 옵션에 따라 결정되는 파일의 조정된 썸네일 이미지를 검색합니다.

GetThumbnailAsync(ThumbnailMode)

썸네일의 용도에 따라 결정되는 파일의 조정된 썸네일 이미지를 검색합니다.

GetThumbnailAsync(ThumbnailMode, UInt32)

썸네일의 목적과 요청된 크기에 따라 결정되는 파일의 조정된 썸네일 이미지를 검색합니다.

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

썸네일의 가장 긴 가장자리의 요청된 크기(픽셀)입니다. Windows는 requestedSize 를 가이드로 사용하고 이미지 품질을 저하하지 않고 썸네일 이미지의 크기를 조정하려고 합니다.

Windows에서 요청된 크기에 맞게 확장할 수 있는 썸네일 이미지를 찾을 수 없는 경우 더 큰 축소판 그림이 반환될 수 있습니다. 더 큰 축소판 그림을 사용할 수 없는 경우 요청된 크기보다 작은 썸네일 이미지가 반환될 수 있습니다.

options
ThumbnailOptions

썸네일 이미지를 검색하는 데 사용할 원하는 동작을 설명하는 열거형 값입니다. 지정된 동작은 이미지의 크기 및/또는 품질과 썸네일 이미지가 검색되는 빈도에 영향을 줄 수 있습니다.

반환

이 메서드가 성공적으로 완료되면 파일과 연결된 썸네일 이미지가 없는 경우 썸네일 이미지를 나타내는 StorageItemThumbnail 또는 null 을 반환합니다.

구현

M:Windows.Storage.IStorageItemProperties.GetThumbnailAsync(Windows.Storage.FileProperties.ThumbnailMode,System.UInt32,Windows.Storage.FileProperties.ThumbnailOptions) M:Windows.Storage.IStorageItemProperties.GetThumbnailAsync(Windows.Storage.FileProperties.ThumbnailMode,unsigned int,Windows.Storage.FileProperties.ThumbnailOptions) M:Windows.Storage.IStorageItemProperties.GetThumbnailAsync(Windows.Storage.FileProperties.ThumbnailMode,uint32_t,Windows.Storage.FileProperties.ThumbnailOptions)
특성

예제

이 예제에서는 [storageFile.getThumbnailAsync(mode, requestedSize, options) 메서드를 사용하여 파일의 썸네일을 캡처하는 방법을 보여 줍니다.

storageFile.getThumbnailAsync(
    Windows.Storage.FileProperties.ThumbnailMode.musicView,
    100,
    Windows.Storage.FileProperties.ThumbnailOptions.useCurrentScale).then(
        function (storageItemThumbnail) {
            // Add code to process thumbnail
        }
    );

StorageFile.GetThumbnailAsync 메서드 중 하나를 사용하려면 파일을 나타내는 StorageFile 개체(storageFile예에서는 )가 있어야 합니다.

설명

GetThumbnailAsync는 썸네일 디스크 캐시에서 지원하는 최대 크기를 준수하지만 GetScaledImageAsThumbnailAsync는 썸네일 디스크 캐시에서 지원하는 것보다 큰 썸네일을 추출할 수 있습니다. GetScaledImageAsThumbnailAsync는 최적의 품질을 제공하지만 미리 보기 크기가 너무 큰 경우 디스크 캐시를 사용하지 않음으로써 성능에 영향을 줄 수 있습니다.

추가 정보

적용 대상

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 을 반환합니다.

구현

특성

설명

GetThumbnailAsync는 썸네일 디스크 캐시에서 지원하는 최대 크기를 준수하지만 GetScaledImageAsThumbnailAsync는 썸네일 디스크 캐시에서 지원하는 것보다 큰 썸네일을 추출할 수 있습니다. GetScaledImageAsThumbnailAsync는 최적의 품질을 제공하지만 미리 보기 크기가 너무 큰 경우 디스크 캐시를 사용하지 않음으로써 성능에 영향을 줄 수 있습니다.

추가 정보

적용 대상

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

썸네일의 가장 긴 가장자리의 요청된 크기(픽셀)입니다. Windows는 requestedSize 를 가이드로 사용하고 이미지 품질을 저하하지 않고 썸네일 이미지의 크기를 조정하려고 합니다.

Windows에서 요청된 크기에 맞게 확장할 수 있는 썸네일 이미지를 찾을 수 없는 경우 더 큰 축소판 그림이 반환될 수 있습니다. 더 큰 축소판 그림을 사용할 수 없는 경우 요청된 크기보다 작은 썸네일 이미지가 반환될 수 있습니다.

반환

이 메서드가 성공적으로 완료되면 파일과 연결된 썸네일 이미지가 없는 경우 썸네일 이미지를 나타내는 StorageItemThumbnail 또는 null 을 반환합니다.

구현

M:Windows.Storage.IStorageItemProperties.GetThumbnailAsync(Windows.Storage.FileProperties.ThumbnailMode,System.UInt32) M:Windows.Storage.IStorageItemProperties.GetThumbnailAsync(Windows.Storage.FileProperties.ThumbnailMode,unsigned int) M:Windows.Storage.IStorageItemProperties.GetThumbnailAsync(Windows.Storage.FileProperties.ThumbnailMode,uint32_t)
특성

설명

GetThumbnailAsync는 썸네일 디스크 캐시에서 지원하는 최대 크기를 준수하지만 GetScaledImageAsThumbnailAsync는 썸네일 디스크 캐시에서 지원하는 것보다 큰 썸네일을 추출할 수 있습니다. GetScaledImageAsThumbnailAsync는 최적의 품질을 제공하지만 미리 보기 크기가 너무 큰 경우 디스크 캐시를 사용하지 않음으로써 성능에 영향을 줄 수 있습니다.

추가 정보

적용 대상