StorageItemThumbnail 클래스

정의

네임스페이스:

Windows.Storage.FileProperties

시스템 리소스(예: 파일 또는 폴더)와 연결된 썸네일 이미지를 나타냅니다.

public ref class StorageItemThumbnail sealed : IClosable, IRandomAccessStreamWithContentType

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class StorageItemThumbnail final : IClosable, IRandomAccessStreamWithContentType

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class StorageItemThumbnail : System.IDisposable, IRandomAccessStreamWithContentType

Public NotInheritable Class StorageItemThumbnail
Implements IDisposable, IRandomAccessStreamWithContentType

상속

Object Platform::Object IInspectable StorageItemThumbnail

특성

ContractVersionAttribute

구현

IClosable IDisposable IContentTypeProvider IInputStream IOutputStream IRandomAccessStream IRandomAccessStreamWithContentType

Windows 요구 사항

디바이스 패밀리	Windows 10 (10.0.10240.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)

예제

이 예제에서는 파일에 대한 썸네일을 가져오는 방법을 보여 줍니다.

// Set query options with filter and sort order for results
List<string> fileTypeFilter = new List<string>();
fileTypeFilter.Add(".jpg");
fileTypeFilter.Add(".png");
fileTypeFilter.Add(".bmp");
fileTypeFilter.Add(".gif");
var queryOptions = new QueryOptions(CommonFileQuery.OrderByName, fileTypeFilter);

// Create query and retrieve files.
var query = KnownFolders.PicturesLibrary.CreateFileQueryWithOptions(queryOptions);
IReadOnlyList<StorageFile> fileList = await query.GetFilesAsync();
// Process results
foreach (StorageFile file in fileList)
{
    // Get thumbnail
    const uint requestedSize = 190;
    const ThumbnailMode thumbnailMode = ThumbnailMode.PicturesView;
    const ThumbnailOptions thumbnailOptions = ThumbnailOptions.UseCurrentScale;
    var thumbnail = await file.GetThumbnailAsync(thumbnailMode, requestedSize, thumbnailOptions);
}

GetThumbnailAsync가 완료되면 썸네일은 StorageItemThumbnail 개체를 가져옵니다.

이 예제에서 변수는 file 썸네일을 검색하려는 각 파일을 나타내는 StorageFile 을 가져옵니다. 쿼리를 사용하여 이러한 파일에 대한 StorageFile 개체(변수에 저장됨)를 얻었지만 앱에서 fileStorageFile 개체(예: 파일 선택기를 통해)를 가져오는 데 가장 적합한 방법을 사용할 수 있습니다.

설명

이를 나타내는 Windows 런타임 개체를 통해 많은 파일 시스템 리소스에 대한 썸네일을 가져올 수 있습니다. 이러한 개체 중 상당수에는 특정 리소스와 연결된 썸네일을 나타내는 StorageItemThumbnail을 가져오고 설정할 수 있는 메서드 또는 속성이 있습니다.

특정 Windows 런타임 개체에 대한 썸네일을 가져오는 방법을 알아보려면 해당 개체에 대한 설명서를 참조하세요. 예를 들어 파일에 대한 썸네일을 가져오려면 StorageFile.getThumbnailAsync 메서드 중 하나를 호출하거나 연락처에 대한 썸네일을 가져오려면 Contact.thumbnail 속성을 사용할 수 있습니다.

썸네일 검색에 대한 자세한 코드 샘플은 폴더 열거형 샘플 및 파일 미리 보기 샘플을 참조하세요.

속성

CanRead	썸네일 스트림을 읽을 수 있는지 여부를 나타내는 값을 가져옵니다.
CanWrite	썸네일 스트림을 쓸 수 있는지 여부를 나타내는 값을 가져옵니다.
ContentType	썸네일 이미지의 MIME 콘텐츠 형식을 가져옵니다.
OriginalHeight	썸네일 이미지의 원래(크기 조정되지 않음) 높이를 가져옵니다.
OriginalWidth	축소판 그림 이미지의 원래 너비(크기 조정되지 않음)를 가져옵니다.
Position	썸네일 스트림의 바이트 오프셋을 가져옵니다.
ReturnedSmallerCachedSize	반환된 썸네일 이미지가 더 작은 크기의 캐시된 버전인지 여부를 나타내는 값을 가져옵니다.
Size	썸네일 이미지의 크기를 가져오거나 설정합니다.
Type	축소판 그림이 아이콘인지 또는 이미지인지를 나타내는 값을 가져옵니다.

메서드

CloneStream()	현재 storageItemThumbnail 개체로 표시되는 썸네일 위에 새 스트림을 만듭니다.
Close()	Windows 런타임 개체에 의해 노출되는 시스템 리소스를 해제합니다.
Dispose()	관리되지 않는 리소스의 확보, 해제 또는 다시 설정과 관련된 애플리케이션 정의 작업을 수행합니다.
FlushAsync()	순차 스트림에서 데이터를 비동기적으로 플러시합니다.
GetInputStreamAt(UInt64)	미리 보기 이미지 데이터를 디코딩되지 않은 스트림으로 검색합니다.
GetOutputStreamAt(UInt64)	썸네일 이미지 데이터를 스토리지 항목에 쓰기 위한 출력 스트림 개체를 검색합니다.
ReadAsync(IBuffer, UInt32, InputStreamOptions)	비동기 바이트 판독기 개체를 반환합니다.
Seek(UInt64)	썸네일 스트림의 오프셋을 지정된 값으로 설정합니다.
WriteAsync(IBuffer)	순차 스트림에 데이터를 비동기적으로 씁니다.

추가 정보

• StorageFile
• 파일 및 폴더 축소판 그림 샘플(Windows 10)