StorageFolder.GetThumbnailAsync Metode

  • Referensi

Definisi

Ruang nama:
Windows.Storage

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)

Edit

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

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 folder.

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

Lihat juga

Berlaku untuk

GetThumbnailAsync(ThumbnailMode, UInt32)

Edit

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

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 folder.

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

Lihat juga

Berlaku untuk

GetThumbnailAsync(ThumbnailMode)

Edit

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

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 folder.

Penerapan

GetThumbnailAsync(ThumbnailMode)
Atribut
OverloadAttribute RemoteAsyncAttribute

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.

Lihat juga

Berlaku untuk