IStorageItemProperties.GetThumbnailAsync 메서드

정의

네임스페이스:

Windows.Storage

오버로드

GetThumbnailAsync(ThumbnailMode)	썸네일의 목적에 따라 결정되는 항목에 대해 조정된 축소판 그림 이미지를 검색합니다.
GetThumbnailAsync(ThumbnailMode, UInt32)	썸네일의 목적과 요청된 크기에 따라 결정되는 항목에 대해 조정된 미리 보기 이미지를 검색합니다.
GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)	썸네일의 목적, 요청된 크기 및 지정된 옵션에 따라 결정되는 항목에 대해 조정된 썸네일 이미지를 검색합니다.

GetThumbnailAsync(ThumbnailMode)

썸네일의 목적에 따라 결정되는 항목에 대해 조정된 축소판 그림 이미지를 검색합니다.

public:
 IAsyncOperation<StorageItemThumbnail ^> ^ GetThumbnailAsync(ThumbnailMode mode);

/// [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

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

반환

IAsyncOperation<StorageItemThumbnail>

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

특성

OverloadAttribute RemoteAsyncAttribute

설명

Windows 8에서 GetThumbnailAsync 메서드에는 UWP 앱 사용자 인터페이스를 표시할 수 있는 한 번에 하나의 몰입형 모니터만 있습니다. Windows 8.1 UWP 앱 사용자 인터페이스는 여러 모니터에 동시에 단일 앱을 표시하는 옵션을 사용하여 여러 모니터에 표시할 수 있습니다. 크기 조정의 경우 한 번에 여러 배율 인수를 고려합니다.

Windows 8.1 GetThumbnailAsync 메서드는 모든 크기 축소판 그림을 반환할 수 있습니다. 따라서 로컬 그림을 표시하는 앱은 이 메서드를 호출하여 표시하려는 크기 조정된 이미지를 가져와야 합니다. 이렇게 하면 앱이 전체 파일을 다운로드하지 않고 클라우드에서 썸네일을 가져오는 특수 메커니즘을 포함하여 모든 캐시 및 성능 최적화의 이점을 얻을 수 있습니다.

추가 정보

• GetThumbnailAsync(ThumbnailMode, UInt32)
• GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)

GetThumbnailAsync(ThumbnailMode, UInt32)

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

public:
 IAsyncOperation<StorageItemThumbnail ^> ^ GetThumbnailAsync(ThumbnailMode mode, unsigned int requestedSize);

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

반환

IAsyncOperation<StorageItemThumbnail>

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

특성

OverloadAttribute RemoteAsyncAttribute

추가 정보

• GetThumbnailAsync(ThumbnailMode)
• GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)

GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)

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

public:
 IAsyncOperation<StorageItemThumbnail ^> ^ GetThumbnailAsync(ThumbnailMode mode, unsigned int requestedSize, ThumbnailOptions options);

/// [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

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

반환

IAsyncOperation<StorageItemThumbnail>

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

특성

OverloadAttribute RemoteAsyncAttribute

추가 정보

• GetThumbnailAsync(ThumbnailMode)
• GetThumbnailAsync(ThumbnailMode, UInt32)