SurfaceImageSource Kelas

Referensi

Definisi

Ruang nama:: Windows.UI.Xaml.Media.Imaging

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.

Edit

Menyediakan permukaan bersama Microsoft DirectX untuk digambar lalu menyusun bit ke dalam konten aplikasi.

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class SurfaceImageSource : ImageSource

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class SurfaceImageSource : ImageSource

Public Class SurfaceImageSource
Inherits ImageSource

Warisan: Object IInspectable DependencyObject ImageSource SurfaceImageSource

Turunan: Windows.UI.Xaml.Media.Imaging.VirtualSurfaceImageSource

Atribut: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Persyaratan Windows

Rangkaian perangkat	Windows 10 (diperkenalkan dalam 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)

Keterangan

Kelas ini adalah area tampilan untuk interoperasi Microsoft DirectX di mana konten Microsoft DirectX dapat menggambar dalam antarmuka pengguna yang disusam XAML. Salah satu pertimbangan untuk SurfaceImageSource adalah bahwa meskipun dapat menggabungkan konten Microsoft DirectX, siklus penyajian masih berpusat pada XAML. Terlalu banyak Gambar Microsoft DirectX dalam model render ini dapat mengakibatkan latensi atau responsivitas yang buruk. Jika Anda mengantisipasi sejumlah besar gambaran ulang untuk konten Microsoft DirectX Anda, dan Anda berniat untuk menampilkan konten tersebut layar penuh tanpa antarmuka pengguna XAML di sekitarnya, Anda mungkin harus menggunakan teknik SwapChainBackgroundPanel sebagai gantinya. Alternatif lain untuk konten layar non-penuh adalah merender ke permukaan awal terpisah pada utas latar belakang, lalu menyalin isinya ke permukaan yang dikembalikan dari BeginDraw pada utas UI. Ini dapat membuka blokir utas UI dengan biaya penggunaan memori yang lebih tinggi.

Untuk informasi selengkapnya tentang cara menggambar ke SurfaceImageSource, termasuk kode sampel, lihat Interop DirectX dan XAML.

Kelas ini memiliki API tambahan, tetapi API tersebut untuk interoperasi Microsoft DirectX dan bukan bagian dari model pemrograman aplikasi umum yang dijelaskan dalam dokumentasi ini. Misalnya, dari sisi Microsoft DirectX, Anda dapat memanggil BeginDraw.

Kelas turunan SurfaceImageSource

SurfaceImageSource adalah kelas induk untuk VirtualSurfaceImageSource.

Konstruktor

SurfaceImageSource(Int32, Int32)	Menginisialisasi instans baru kelas SurfaceImageSource , yang menentukan ukuran area gambar.
SurfaceImageSource(Int32, Int32, Boolean)	Menginisialisasi instans baru kelas SurfaceImageSource , menentukan ukuran area gambar, dan apakah opasitas diharapkan selalu opasitas penuh. Gunakan ini dengan `isOpaque=true` jika SurfaceImageSource tidak boleh mendukung transparansi; ini dapat meningkatkan performa.

Properti

Dispatcher

Mendapatkan CoreDispatcher yang dikaitkan dengan objek ini. CoreDispatcher mewakili fasilitas yang dapat mengakses DependencyObject pada utas UI bahkan jika kode dimulai oleh utas non-UI.

(Diperoleh dari DependencyObject)

Metode

ClearValue(DependencyProperty)	Menghapus nilai lokal properti dependensi. (Diperoleh dari DependencyObject)
GetAnimationBaseValue(DependencyProperty)	Mengembalikan nilai dasar apa pun yang ditetapkan untuk properti dependensi, yang akan berlaku dalam kasus di mana animasi tidak aktif. (Diperoleh dari DependencyObject)
GetValue(DependencyProperty)	Mengembalikan nilai efektif properti dependensi saat ini dari DependencyObject. (Diperoleh dari DependencyObject)
ReadLocalValue(DependencyProperty)	Mengembalikan nilai lokal properti dependensi, jika nilai lokal ditetapkan. (Diperoleh dari DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	Mendaftarkan fungsi pemberitahuan untuk mendengarkan perubahan pada DependencyProperty tertentu pada instans DependencyObject ini. (Diperoleh dari DependencyObject)
SetValue(DependencyProperty, Object)	Mengatur nilai lokal properti dependensi pada DependencyObject. (Diperoleh dari DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	Membatalkan pemberitahuan perubahan yang sebelumnya terdaftar dengan memanggil RegisterPropertyChangedCallback. (Diperoleh dari DependencyObject)

Berlaku untuk