IStorageItemProperties.GetThumbnailAsync Metode

Definisi

Overload

GetThumbnailAsync(ThumbnailMode)

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

GetThumbnailAsync(ThumbnailMode, UInt32)

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

GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)

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

GetThumbnailAsync(ThumbnailMode)

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

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

Mengembalikan

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

Atribut

Keterangan

Di Windows 8, metode GetThumbnailAsync hanya memiliki satu monitor imersif pada satu waktu yang dapat menampilkan antarmuka pengguna aplikasi UWP. Di Windows 8.1, antarmuka pengguna aplikasi UWP dapat muncul di beberapa monitor, dengan opsi untuk menampilkan satu aplikasi di beberapa monitor secara bersamaan. Untuk penskalaan, pertimbangkan beberapa faktor skala sekaligus.

Di Windows 8.1, metode GetThumbnailAsync dapat mengembalikan gambar mini ukuran apa pun. Oleh karena itu, aplikasi yang menampilkan gambar lokal harus memanggil metode ini untuk mendapatkan gambar skala yang ingin mereka tampilkan. Ini memastikan bahwa aplikasi mendapat manfaat dari semua cache dan pengoptimalan performa, termasuk mekanisme khusus untuk mendapatkan gambar mini dari cloud tanpa mengunduh file lengkap.

Lihat juga

Berlaku untuk

GetThumbnailAsync(ThumbnailMode, UInt32)

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

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

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

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

Atribut

Lihat juga

Berlaku untuk

GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)

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

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

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

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

Atribut

Lihat juga

Berlaku untuk