LoadedImageSurface Kelas

Definisi

Ruang nama:

Windows.UI.Xaml.Media

Mewakili permukaan komposisi yang dapat diunduh, didekodekan, dan dimuat ke dalamnya. Anda dapat memuat gambar menggunakan Pengidentifikasi Sumber Daya Seragam (URI) yang mereferensikan file sumber gambar, atau menyediakan IRandomAccessStream.

public ref class LoadedImageSurface sealed : IClosable, ICompositionSurface

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 262144)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class LoadedImageSurface final : IClosable, ICompositionSurface

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 262144)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class LoadedImageSurface : System.IDisposable, ICompositionSurface

Public NotInheritable Class LoadedImageSurface
Implements ICompositionSurface, IDisposable

Warisan

Object Platform::Object IInspectable LoadedImageSurface

Atribut

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Penerapan

IClosable IDisposable ICompositionSurface

Persyaratan Windows

Rangkaian perangkat	Windows 10 Creators Update (diperkenalkan dalam 10.0.15063.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v4.0)

Contoh

Contoh ini menunjukkan cara memuat gambar dari URI lokal ke permukaan dan menggunakannya dalam CompositionSurfaceBrush.

Compositor compositor = new Compositor();
CompositionSurfaceBrush imageBrush = compositor.CreateSurfaceBrush();

LoadedImageSurface loadedSurface = LoadedImageSurface.StartLoadFromUri(new Uri("ms-appx:///Assets/myPic.jpg"), new Size(200.0, 400.0));

// The loadedSurface currently has a size of 0x0 since it has not been downloaded, decoded and loaded to the surface yet
imageBrush.Surface = loadedSurface;

Keterangan

LoadedImageSurface dapat bersumber dari format file gambar ini:

• Joint Photographic Experts Group (JPEG)
• Grafis Jaringan Portabel (PNG)
• Bitmap (BMP)
• Format Pertukaran Grafis (GIF)
• Format File Gambar Bertag (TIFF)
• JPEG XR
• Ikon (ICO)

[! CATATAN] LoadedImageSurface tidak mendukung gambar GIF animasi, sehingga hanya bingkai pertama GIF animasi yang akan ditampilkan.

Jika sumber gambar adalah aliran, aliran tersebut diharapkan berisi file gambar dalam salah satu format ini.

Pengodean dan pendekodean LoadedImageSurface

Dukungan codec yang mendasari untuk file gambar disediakan oleh WINDOWS Imaging Component (WIC) API di Windows. Untuk informasi selengkapnya tentang format gambar tertentu seperti yang didokumenkan untuk kode, lihat Codec WIC Asli.

Dengan menggunakan salah satu metode pabrik, Anda dapat membuat instans LoadedImageSurface dari berbagai jenis sumber gambar dan mengontrol ukuran maksimum yang didekodekan gambar. Jika tidak ada ukuran maksimum yang ditentukan, maka gambar akan didekode ke ukuran alaminya.

• StartLoadFromUri(Uri)
• StartLoadFromUri(Uri, Ukuran)
• StartLoadFromStream(IRandomAccessStream)
• StartLoadFromStream(IRandomAccessStream, Size)

Manajemen seumur hidup

Ketika LoadedImageSurface dibuat menggunakan salah satu metode pabrik, permukaan yang mendasar segera diinisialisasi ke ukuran 0x0 dan konten gambar mulai mengunduh dan mendekode utas UI. Ketika sumber gambar telah berhasil didekode, sumber tersebut kemudian dimuat ke permukaan dan peristiwa LoadCompleted ditembakkan ketika permukaan telah diisi. Selama proses pemuatan, permukaan akan diubah ukurannya dari 0x0 ke ukuran akhir berdasarkan ukuran sumber gambar yang didekodekan.

LoadedImageSurface secara otomatis mempertahankan semua sumber dayanya sampai kehilangan referensi terakhirnya. Namun, Anda dapat secara eksplisit membuang sumber dayanya melalui metode Tutup .

[! CATATAN] LoadedImageSurface tidak tersedia sebelum Windows 10, versi 1703. Jika pengaturan 'versi platform minum' aplikasi Anda di Microsoft Visual Studio kurang dari 'versi yang diperkenalkan' yang ditampilkan di blok Persyaratan nanti di halaman ini, Anda tidak dapat menggunakan kelas ini.

Properti

DecodedPhysicalSize	Mendapatkan ukuran gambar yang didekodekan dalam piksel fisik.
DecodedSize	Mendapatkan ukuran gambar yang didekodekan dalam piksel independen perangkat.
NaturalSize	Mendapatkan ukuran alami gambar dalam piksel fisik, yang didefinisikan dalam sumber gambar asli.

Metode

Close()	Membuang LoadedImageSurface dan sumber daya terkait.
Dispose()	Melakukan tugas yang ditentukan aplikasi yang terkait dengan membebaskan, merilis, atau mengatur ulang sumber daya yang tidak dikelola.
StartLoadFromStream(IRandomAccessStream)	Memuat gambar ke LoadedImageSurface dari IRandomAccessStream yang disediakan pada ukuran alami yang ditentukan dalam sumber gambar.
StartLoadFromStream(IRandomAccessStream, Size)	Memuat gambar ke dalam LoadedImageSurface dari IRandomAccessStream yang disediakan dengan ukuran maksimum yang diinginkan.
StartLoadFromUri(Uri)	Memuat gambar ke dalam LoadedImageSurface dari Pengidentifikasi Sumber Daya Seragam (URI) yang disediakan pada ukuran alami yang ditentukan dalam sumber gambar.
StartLoadFromUri(Uri, Size)	Memuat gambar ke dalam LoadedImageSurface dari Pengidentifikasi Sumber Daya Seragam (URI) yang disediakan dengan ukuran maksimum yang diinginkan.

Acara

LoadCompleted

Terjadi ketika gambar telah diunduh, didekodekan, dan dimuat ke ICompositionSurface yang mendasar.

Lihat juga

• ICompositionSurface