IStorageItemProperties.GetThumbnailAsync Metode
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.
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