내보내기(0) 인쇄
모두 확장
정보
요청한 주제가 아래에 표시됩니다. 그러나 이 주제는 이 라이브러리에 포함되지 않습니다.

IStorageItemProperties.GetThumbnailAsync(ThumbnailMode, UInt32) Method

항목에 대한 조정된 축소판 이미지를 검색합니다. 이 이미지는 축소판 용도와 요청한 크기에 따라 결정됩니다.

구문


IAsyncOperation<StorageItemThumbnail> GetThumbnailAsync(
  ThumbnailMode mode, 
  uint requestedSize
)

매개 변수

mode

유형: ThumbnailMode

축소판 그림의 용도를 설명하고 축소판 이미지의 조정 방식을 결정하는 열거형 값입니다.

가장 적절한 축소판 그림 모드를 선택하는 방법에 대한 지침은 축소판 그림의 지침 및 검사 목록을 참조하십시오.

requestedSize

유형: System.UInt32 [.NET] | uint32 [C++]

축소판 그림의 가장 긴 가장자리의 요청 크기(픽셀 단위)입니다. Windows는 requestedSize를 지침으로 사용하여 이미지 품질을 줄이지 않고 축소판 이미지의 배율을 조정하려고 합니다.

Windows에서 요청된 크기로 배율 조정할 수 있는 축소판 이미지를 찾을 수 없는 경우 더 큰 축소판 그림이 반환될 수 있습니다. 사용할 수 있는 큰 축소판 그림이 없는 경우 요청한 크기보다 작은 축소판 이미지가 반환될 수 있습니다.

반환 값

유형: IAsyncOperation<StorageItemThumbnail>

이 메서드가 성공적으로 완료되면 축소판 이미지를 나타내는 StorageItemThumbnail이 반환되거나 이 항목에 연결된 축소판 이미지가 없는 경우 null이 반환됩니다.

설명

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

Windows 8.1에서 GetThumbnailAsync 메서드는 모든 크기의 미리 보기를 반환할 수 있습니다. 따라서 로컬 사진을 표시하는 앱은 이 메서드를 호출하여 표시하려는 크기 조정된 이미지를 가져옵니다. 이렇게 하면 앱이 전체 파일을 다운로드하지 않고 클라우드에서 미리 보기를 가져오는 특수 메커니즘을 포함하여 모든 캐시 및 성능 최적화를 활용할 수 있습니다.

가장 적절한 축소판 그림 모드를 선택하는 방법에 대한 지침은 축소판 그림의 지침 및 검사 목록을 참조하십시오.

Windows Phone 8

이 API는 구현되어 있지 않으므로 호출할 경우 예외가 throw됩니다. Windows Phone 런타임 API를 참조하십시오.

요구 사항

지원되는 최소 클라이언트

Windows 8

지원되는 최소 서버

Windows Server 2012

지원되는 최소 전화

Windows Phone 8[구현되지 않음, 설명 참조]

네임스페이스

Windows.Storage
Windows::Storage [C++]

메타데이터

Windows.winmd

참고 항목

IStorageItemProperties
GetThumbnailAsync(ThumbnailMode)
GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)

 

 

Microsoft는 MSDN 웹 사이트에 대한 귀하의 의견을 이해하기 위해 온라인 설문 조사를 진행하고 있습니다. 참여하도록 선택하시면 MSDN 웹 사이트에서 나가실 때 온라인 설문 조사가 표시됩니다.

참여하시겠습니까?
표시:
© 2014 Microsoft