StorageItemThumbnail Kelas

Definisi

Ruang nama:

Windows.Storage.FileProperties

Mewakili gambar mini yang terkait dengan sumber daya sistem (seperti file atau folder).

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

Warisan

Object Platform::Object IInspectable StorageItemThumbnail

Atribut

ContractVersionAttribute

Penerapan

IClosable IDisposable IContentTypeProvider IInputStream IOutputStream IRandomAccessStream IRandomAccessStreamWithContentType

Persyaratan Windows

Rangkaian perangkat	Windows 10 (diperkenalkan dalam 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)

Contoh

Contoh ini menunjukkan cara mendapatkan gambar mini untuk file.

// 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);
}

Setelah GetThumbnailAsync selesai, gambar mini mendapatkan objek StorageItemThumbnail.

Dalam contoh, file variabel mendapatkan StorageFile yang mewakili setiap file yang ingin kita ambil gambar mininya. Kami menggunakan kueri untuk mendapatkan objek StorageFile untuk file-file ini (disimpan dalam file variabel), tetapi Anda dapat menggunakan pendekatan apa pun yang terbaik bagi aplikasi Anda untuk mendapatkan objek StorageFile (seperti melalui pemilih file).

Keterangan

Anda bisa mendapatkan gambar mini untuk banyak sumber daya sistem file melalui objek Windows Runtime yang mewakilinya. Banyak dari objek ini memiliki metode atau properti yang memungkinkan Anda mendapatkan (dan terkadang mengatur) StorageItemThumbnail yang mewakili gambar mini yang terkait dengan sumber daya tertentu.

Untuk mengetahui cara mendapatkan gambar mini untuk objek Windows Runtime tertentu, lihat dokumentasi untuk objek tersebut. Misalnya, untuk mendapatkan gambar mini untuk file, Anda dapat memanggil salah satu metode StorageFile.getThumbnailAsync , atau untuk mendapatkan gambar mini untuk kontak, Anda dapat menggunakan properti Contact.thumbnail .

Untuk sampel kode lainnya tentang mengambil gambar mini, lihat Sampel enumerasi folder dan sampel gambar mini File.

Properti

CanRead	Mendapatkan nilai yang menunjukkan apakah aliran gambar mini dapat dibaca.
CanWrite	Mendapatkan nilai yang menunjukkan apakah aliran gambar mini dapat ditulis.
ContentType	Mendapatkan tipe konten MIME dari gambar mini.
OriginalHeight	Mendapatkan tinggi asli (tidak diskalakan) dari gambar mini.
OriginalWidth	Mendapatkan lebar asli (tidak diskalakan) dari gambar mini.
Position	Mendapatkan offset byte dari aliran gambar mini.
ReturnedSmallerCachedSize	Mendapatkan nilai yang menunjukkan apakah gambar mini yang dikembalikan adalah versi cache dengan ukuran yang lebih kecil.
Size	Mendapatkan atau mengatur ukuran gambar mini.
Type	Mendapatkan nilai yang menunjukkan apakah gambar mini adalah ikon atau gambar.

Metode

CloneStream()	Membuat aliran baru melalui gambar mini yang diwakili oleh objek storageItemThumbnail saat ini.
Close()	Merilis sumber daya sistem yang diekspos oleh objek Windows Runtime.
Dispose()	Melakukan tugas yang ditentukan aplikasi yang terkait dengan membebaskan, melepaskan, atau mereset sumber daya yang tidak terkelola.
FlushAsync()	Menghapus data secara asinkron dalam aliran berurutan.
GetInputStreamAt(UInt64)	Mengambil data gambar mini sebagai aliran yang tidak didekodekan.
GetOutputStreamAt(UInt64)	Mengambil objek aliran output untuk menulis data gambar mini ke item penyimpanan.
ReadAsync(IBuffer, UInt32, InputStreamOptions)	Mengembalikan objek pembaca byte asinkron.
Seek(UInt64)	Mengatur offset aliran gambar mini ke nilai yang ditentukan.
WriteAsync(IBuffer)	Menulis data secara asinkron dalam aliran berurutan.

Lihat juga

• StorageFile
• Sampel gambar mini file dan folder (Windows 10)