StorageItemThumbnail Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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
- Atribut
- Penerapan
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. |