StorageFolder.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, UInt32, ThumbnailOptions) |
Mendapatkan gambar mini untuk folder saat ini, berukuran untuk tujuan gambar mini yang ditentukan dan disesuaikan dengan ukuran yang diminta dengan opsi yang ditentukan. |
GetThumbnailAsync(ThumbnailMode, UInt32) |
Mendapatkan gambar mini untuk folder saat ini, berukuran untuk tujuan gambar mini yang ditentukan dan disesuaikan dengan ukuran yang diminta. |
GetThumbnailAsync(ThumbnailMode) |
Mendapatkan gambar mini untuk folder saat ini, berukuran untuk tujuan gambar mini yang ditentukan. |
GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)
Mendapatkan gambar mini untuk folder saat ini, berukuran untuk tujuan gambar mini yang ditentukan dan disesuaikan dengan ukuran yang diminta dengan 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 dari enumerasi 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 gambar mini terpanjang. Metode ini menggunakan requestedSize sebagai panduan dan mencoba menskalakan gambar mini tanpa mengurangi kualitas gambar.
Jika metode ini tidak dapat menemukan gambar mini yang dapat diskalakan ke ukuran yang diminta, metode ini dapat mengembalikan gambar mini yang lebih besar. Jika tidak ada gambar mini yang lebih besar yang tersedia, gambar mini dapat mengembalikan gambar mini yang lebih kecil dari ukuran yang diminta.
- options
- ThumbnailOptions
Nilai dari enumerasi yang menentukan cara mengambil dan mengukur gambar. Nilai default, UseCurrentScale, cocok untuk sebagian besar aplikasi.
Mengembalikan
Ketika metode ini berhasil diselesaikan, metode ini mengembalikan StorageItemThumbnail yang mewakili gambar mini, atau null jika tidak ada gambar mini yang terkait dengan folder.
Penerapan
- Atribut
Lihat juga
Berlaku untuk
GetThumbnailAsync(ThumbnailMode, UInt32)
Mendapatkan gambar mini untuk folder saat ini, berukuran untuk tujuan gambar mini yang ditentukan dan disesuaikan dengan 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 dari enumerasi 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 gambar mini terpanjang. Metode ini menggunakan requestedSize sebagai panduan dan mencoba menskalakan gambar mini tanpa mengurangi kualitas gambar.
Jika metode ini tidak dapat menemukan gambar mini yang dapat diskalakan ke ukuran yang diminta, metode ini dapat mengembalikan gambar mini yang lebih besar. Jika tidak ada gambar mini yang lebih besar yang tersedia, gambar mini dapat mengembalikan gambar mini yang lebih kecil dari ukuran yang diminta.
Mengembalikan
Ketika metode ini berhasil diselesaikan, metode ini mengembalikan StorageItemThumbnail yang mewakili gambar mini, atau null jika tidak ada gambar mini yang terkait dengan folder.
Penerapan
- Atribut
Lihat juga
Berlaku untuk
GetThumbnailAsync(ThumbnailMode)
Mendapatkan gambar mini untuk folder saat ini, berukuran untuk tujuan gambar mini yang ditentukan.
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 dari enumerasi 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
Ketika metode ini berhasil diselesaikan, metode ini mengembalikan StorageItemThumbnail yang mewakili gambar mini, atau null jika tidak ada gambar mini yang terkait dengan folder.
Penerapan
- Atribut
Contoh
Contoh berikut mendapatkan gambar mini untuk folder Gambar pengguna dan menampilkan gambar mini dalam kontrol Gambar . Contoh ini juga meminta gambar yang sisi terpanjangnya adalah 64 piksel, dan meminta gambar hanya jika sudah di-cache pada perangkat. Contoh mengasumsikan bahwa ada kontrol Gambar bernama ImageControl di halaman saat ini.
Sebelum Anda menjalankan contoh berikut, aktifkan kemampuan Pustaka Gambar dalam file manifes aplikasi.
using Windows.Storage;
using Windows.Storage.FileProperties;
using System.Threading.Tasks;
using Windows.UI.Xaml.Media.Imaging; // For the Bitmap object.
// Get the user's Pictures folder.
// Enable the corresponding capability in the app manifest file.
StorageFolder picturesFolder = KnownFolders.PicturesLibrary;
// Get a thumbnail for the current folder.
StorageItemThumbnail thumb =
await picturesFolder.GetThumbnailAsync(ThumbnailMode.SingleItem,
64, ThumbnailOptions.ReturnOnlyIfCached);
// Display the thumbnail in an Image control
// named ImageControl on the current page.
BitmapImage bitmapImage = new BitmapImage();
bitmapImage.SetSource(thumb);
ImageControl.Source = bitmapImage;
Keterangan
Untuk sampel yang menunjukkan metode GetThumbnailAsync , lihat Sampel gambar mini file dan folder.
Untuk panduan tentang memilih mode gambar mini terbaik, lihat Panduan dan daftar periksa untuk gambar mini.
Metode StorageFolder.GetThumbnailAsync terkadang mengembalikan gambar default folder. Untuk aplikasi Windows Phone 8.x, metode ini mengabaikan tema saat ini saat mengembalikan gambar default ini. Gambar yang dikembalikan selalu merupakan gambar untuk tema gelap; artinya, folder transparan dengan batas putih. Jika Anda ingin mengembalikan gambar untuk tema cahaya, Anda harus membuat gambar Anda sendiri yang terlihat di latar belakang cahaya. Kemudian Anda harus menggunakan logika bersyarah untuk memeriksa tema aktif. Jika tema aktif adalah tema terang, gunakan metode selain GetThumbnailAsync untuk mengambil gambar kustom Anda.