다음을 통해 공유


StorageFile.GetScaledImageAsThumbnailAsync 메서드

정의

오버로드

GetScaledImageAsThumbnailAsync(ThumbnailMode)

축소판 그림의 용도에 따라 결정되는 축소판 그림으로 크기 조정된 이미지를 가져옵니다.

GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32)

축소판 그림의 목적과 요청된 크기에 따라 결정되는 축소판 그림으로 크기 조정된 이미지를 가져옵니다.

GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)

축소판 그림의 목적, 요청된 크기 및 지정된 옵션에 따라 결정되는 축소판 그림으로 크기 조정된 이미지를 가져옵니다.

GetScaledImageAsThumbnailAsync(ThumbnailMode)

축소판 그림의 용도에 따라 결정되는 축소판 그림으로 크기 조정된 이미지를 가져옵니다.

public:
 virtual IAsyncOperation<StorageItemThumbnail ^> ^ GetScaledImageAsThumbnailAsync(ThumbnailMode mode) = GetScaledImageAsThumbnailAsync;
/// [Windows.Foundation.Metadata.Overload("GetScaledImageAsThumbnailAsyncOverloadDefaultSizeDefaultOptions")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StorageItemThumbnail> GetScaledImageAsThumbnailAsync(ThumbnailMode const& mode);
[Windows.Foundation.Metadata.Overload("GetScaledImageAsThumbnailAsyncOverloadDefaultSizeDefaultOptions")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StorageItemThumbnail> GetScaledImageAsThumbnailAsync(ThumbnailMode mode);
function getScaledImageAsThumbnailAsync(mode)
Public Function GetScaledImageAsThumbnailAsync (mode As ThumbnailMode) As IAsyncOperation(Of StorageItemThumbnail)

매개 변수

mode
ThumbnailMode

썸네일의 용도를 설명하고 썸네일 이미지를 조정하는 방법을 결정하는 열거형 값입니다.

최상의 썸네일 모드를 선택하는 방법에 대한 지침은 미리 보기에 대한 지침 및 검사 목록을 참조하세요.

반환

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

구현

특성

설명

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

추가 정보

적용 대상

GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32)

축소판 그림의 목적과 요청된 크기에 따라 결정되는 축소판 그림으로 크기 조정된 이미지를 가져옵니다.

public:
 virtual IAsyncOperation<StorageItemThumbnail ^> ^ GetScaledImageAsThumbnailAsync(ThumbnailMode mode, unsigned int requestedSize) = GetScaledImageAsThumbnailAsync;
/// [Windows.Foundation.Metadata.Overload("GetScaledImageAsThumbnailAsyncOverloadDefaultOptions")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StorageItemThumbnail> GetScaledImageAsThumbnailAsync(ThumbnailMode const& mode, uint32_t const& requestedSize);
[Windows.Foundation.Metadata.Overload("GetScaledImageAsThumbnailAsyncOverloadDefaultOptions")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StorageItemThumbnail> GetScaledImageAsThumbnailAsync(ThumbnailMode mode, uint requestedSize);
function getScaledImageAsThumbnailAsync(mode, requestedSize)
Public Function GetScaledImageAsThumbnailAsync (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.IStorageItemProperties2.GetScaledImageAsThumbnailAsync(Windows.Storage.FileProperties.ThumbnailMode,System.UInt32) M:Windows.Storage.IStorageItemProperties2.GetScaledImageAsThumbnailAsync(Windows.Storage.FileProperties.ThumbnailMode,unsigned int) M:Windows.Storage.IStorageItemProperties2.GetScaledImageAsThumbnailAsync(Windows.Storage.FileProperties.ThumbnailMode,uint32_t)
특성

설명

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

추가 정보

적용 대상

GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)

축소판 그림의 목적, 요청된 크기 및 지정된 옵션에 따라 결정되는 축소판 그림으로 크기 조정된 이미지를 가져옵니다.

public:
 virtual IAsyncOperation<StorageItemThumbnail ^> ^ GetScaledImageAsThumbnailAsync(ThumbnailMode mode, unsigned int requestedSize, ThumbnailOptions options) = GetScaledImageAsThumbnailAsync;
/// [Windows.Foundation.Metadata.Overload("GetScaledImageAsThumbnailAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StorageItemThumbnail> GetScaledImageAsThumbnailAsync(ThumbnailMode const& mode, uint32_t const& requestedSize, ThumbnailOptions const& options);
[Windows.Foundation.Metadata.Overload("GetScaledImageAsThumbnailAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StorageItemThumbnail> GetScaledImageAsThumbnailAsync(ThumbnailMode mode, uint requestedSize, ThumbnailOptions options);
function getScaledImageAsThumbnailAsync(mode, requestedSize, options)
Public Function GetScaledImageAsThumbnailAsync (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.IStorageItemProperties2.GetScaledImageAsThumbnailAsync(Windows.Storage.FileProperties.ThumbnailMode,System.UInt32,Windows.Storage.FileProperties.ThumbnailOptions) M:Windows.Storage.IStorageItemProperties2.GetScaledImageAsThumbnailAsync(Windows.Storage.FileProperties.ThumbnailMode,unsigned int,Windows.Storage.FileProperties.ThumbnailOptions) M:Windows.Storage.IStorageItemProperties2.GetScaledImageAsThumbnailAsync(Windows.Storage.FileProperties.ThumbnailMode,uint32_t,Windows.Storage.FileProperties.ThumbnailOptions)
특성

설명

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

추가 정보

적용 대상