Bagikan melalui

StorageFile.GetThumbnailAsync Metode

  • Referensi

Definisi

Ruang nama:
Windows.Storage

Overload

GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)

Mengambil gambar mini yang disesuaikan untuk file, ditentukan oleh tujuan gambar mini, ukuran yang diminta, dan opsi yang ditentukan.
GetThumbnailAsync(ThumbnailMode)

Mengambil gambar mini yang disesuaikan untuk file, yang ditentukan oleh tujuan gambar mini.
GetThumbnailAsync(ThumbnailMode, UInt32)

Mengambil gambar mini yang disesuaikan untuk file, yang ditentukan oleh tujuan gambar mini dan ukuran yang diminta.

GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)

Edit

Mengambil gambar mini yang disesuaikan untuk file, ditentukan oleh tujuan gambar mini, ukuran yang diminta, dan opsi yang ditentukan.

public:
 virtual IAsyncOperation<StorageItemThumbnail ^> ^ GetThumbnailAsync(ThumbnailMode mode, unsigned int requestedSize, ThumbnailOptions options) = GetThumbnailAsync;
/// [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)

Parameter

mode
ThumbnailMode

Nilai enum yang menjelaskan tujuan gambar mini dan menentukan bagaimana gambar mini disesuaikan.

Untuk panduan tentang memilih mode gambar mini terbaik, lihat Panduan dan daftar periksa untuk gambar mini.

requestedSize
UInt32

unsigned int

uint32_t

Ukuran yang diminta, dalam piksel, dari tepi terpanjang gambar mini. Windows menggunakan requestedSize sebagai panduan dan mencoba menskalakan gambar mini tanpa mengurangi kualitas gambar.

Jika Windows tidak dapat menemukan gambar mini yang dapat diskalakan untuk memenuhi ukuran yang diminta, gambar mini yang lebih besar mungkin dikembalikan. Jika tidak ada gambar mini yang lebih besar yang tersedia, gambar mini yang lebih kecil dari ukuran yang diminta mungkin dikembalikan.

options
ThumbnailOptions

Nilai enum yang menjelaskan perilaku yang diinginkan untuk digunakan untuk mengambil gambar mini. Perilaku yang ditentukan dapat memengaruhi ukuran dan/atau kualitas gambar dan seberapa cepat gambar mini diambil.

Mengembalikan

IAsyncOperation<StorageItemThumbnail>

Ketika metode ini berhasil diselesaikan, metode ini mengembalikan StorageItemThumbnail yang mewakili gambar mini atau null jika tidak ada gambar mini yang terkait dengan file.

Penerapan

M:Windows.Storage.IStorageItemProperties.GetThumbnailAsync(Windows.Storage.FileProperties.ThumbnailMode,System.UInt32,Windows.Storage.FileProperties.ThumbnailOptions) M:Windows.Storage.IStorageItemProperties.GetThumbnailAsync(Windows.Storage.FileProperties.ThumbnailMode,unsigned int,Windows.Storage.FileProperties.ThumbnailOptions) M:Windows.Storage.IStorageItemProperties.GetThumbnailAsync(Windows.Storage.FileProperties.ThumbnailMode,uint32_t,Windows.Storage.FileProperties.ThumbnailOptions)
Atribut
OverloadAttribute RemoteAsyncAttribute

Contoh

Contoh ini menunjukkan kepada Anda cara mengambil gambar mini file menggunakan metode [storageFile.getThumbnailAsync(mode, requestedSize, options).

storageFile.getThumbnailAsync(
    Windows.Storage.FileProperties.ThumbnailMode.musicView,
    100,
    Windows.Storage.FileProperties.ThumbnailOptions.useCurrentScale).then(
        function (storageItemThumbnail) {
            // Add code to process thumbnail
        }
    );

Anda harus memiliki objek StorageFile (storageFile dalam contoh) yang mewakili file Anda untuk menggunakan salah satu metode StorageFile.GetThumbnailAsync .

Keterangan

Meskipun GetThumbnailAsync mematuhi ukuran maksimum yang didukung oleh cache disk gambar mini, GetScaledImageAsThumbnailAsync dapat mengekstrak gambar mini yang lebih besar dari apa yang didukung cache disk gambar mini. GetScaledImageAsThumbnailAsync memberikan kualitas optimal tetapi dapat memengaruhi performa dengan tidak menggunakan cache disk jika ukuran gambar mini terlalu besar.

Lihat juga

Berlaku untuk

GetThumbnailAsync(ThumbnailMode)

Edit

Mengambil gambar mini yang disesuaikan untuk file, yang ditentukan oleh tujuan gambar mini.

public:
 virtual IAsyncOperation<StorageItemThumbnail ^> ^ GetThumbnailAsync(ThumbnailMode mode) = GetThumbnailAsync;
/// [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)

Parameter

mode
ThumbnailMode

Nilai enum yang menjelaskan tujuan gambar mini dan menentukan bagaimana gambar mini disesuaikan.

Untuk panduan tentang memilih mode gambar mini terbaik, lihat Panduan dan daftar periksa untuk gambar mini.

Mengembalikan

IAsyncOperation<StorageItemThumbnail>

Ketika metode ini berhasil diselesaikan, metode ini mengembalikan StorageItemThumbnail yang mewakili gambar mini atau null jika tidak ada gambar mini yang terkait dengan file.

Penerapan

GetThumbnailAsync(ThumbnailMode)
Atribut
OverloadAttribute RemoteAsyncAttribute

Keterangan

Meskipun GetThumbnailAsync mematuhi ukuran maksimum yang didukung oleh cache disk gambar mini, GetScaledImageAsThumbnailAsync dapat mengekstrak gambar mini yang lebih besar dari apa yang didukung cache disk gambar mini. GetScaledImageAsThumbnailAsync memberikan kualitas optimal tetapi dapat memengaruhi performa dengan tidak menggunakan cache disk jika ukuran gambar mini terlalu besar.

Lihat juga

Berlaku untuk

GetThumbnailAsync(ThumbnailMode, UInt32)

Edit

Mengambil gambar mini yang disesuaikan untuk file, yang ditentukan oleh tujuan gambar mini dan ukuran yang diminta.

public:
 virtual IAsyncOperation<StorageItemThumbnail ^> ^ GetThumbnailAsync(ThumbnailMode mode, unsigned int requestedSize) = GetThumbnailAsync;
/// [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)

Parameter

mode
ThumbnailMode

Nilai enum yang menjelaskan tujuan gambar mini dan menentukan bagaimana gambar mini disesuaikan.

Untuk panduan tentang memilih mode gambar mini terbaik, lihat Panduan dan daftar periksa untuk gambar mini.

requestedSize
UInt32

unsigned int

uint32_t

Ukuran yang diminta, dalam piksel, dari tepi terpanjang gambar mini. Windows menggunakan requestedSize sebagai panduan dan mencoba menskalakan gambar mini tanpa mengurangi kualitas gambar.

Jika Windows tidak dapat menemukan gambar mini yang dapat diskalakan untuk memenuhi ukuran yang diminta, gambar mini yang lebih besar mungkin dikembalikan. Jika tidak ada gambar mini yang lebih besar yang tersedia, gambar mini yang lebih kecil dari ukuran yang diminta mungkin dikembalikan.

Mengembalikan

IAsyncOperation<StorageItemThumbnail>

Ketika metode ini berhasil diselesaikan, metode ini mengembalikan StorageItemThumbnail yang mewakili gambar mini atau null jika tidak ada gambar mini yang terkait dengan file.

Penerapan

M:Windows.Storage.IStorageItemProperties.GetThumbnailAsync(Windows.Storage.FileProperties.ThumbnailMode,System.UInt32) M:Windows.Storage.IStorageItemProperties.GetThumbnailAsync(Windows.Storage.FileProperties.ThumbnailMode,unsigned int) M:Windows.Storage.IStorageItemProperties.GetThumbnailAsync(Windows.Storage.FileProperties.ThumbnailMode,uint32_t)
Atribut
OverloadAttribute RemoteAsyncAttribute

Keterangan

Meskipun GetThumbnailAsync mematuhi ukuran maksimum yang didukung oleh cache disk gambar mini, GetScaledImageAsThumbnailAsync dapat mengekstrak gambar mini yang lebih besar dari apa yang didukung cache disk gambar mini. GetScaledImageAsThumbnailAsync memberikan kualitas optimal tetapi dapat memengaruhi performa dengan tidak menggunakan cache disk jika ukuran gambar mini terlalu besar.

Lihat juga

Berlaku untuk