METODE IDCompositionVisual::SetContent (dcomp.h)
Menyetel properti Isi visual ini ke bitmap atau pembungkus jendela yang ditentukan.
Sintaks
HRESULT SetContent(
[in, optional] IUnknown *content
);
Parameter
[in, optional] content
Jenis: IUnknown*
Objek yang merupakan isi baru dari visual ini. Parameter ini bisa NULL.
Nilai kembali
Jenis: HRESULT
Jika fungsi berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan. Lihat Kode Kesalahan DirectComposition untuk daftar kode kesalahan.
Keterangan
Parameter konten harus menunjuk ke salah satu hal berikut:
- Objek yang mengimplementasikan antarmuka IDCompositionSurface .
- Objek yang mengimplementasikan antarmuka IDXGISwapChain1 .
- Objek pembungkus yang dikembalikan oleh metode CreateSurfaceFromHandle atau CreateSurfaceFromHwnd .
Visual dapat dikaitkan dengan objek bitmap atau pembungkus jendela. Bitmap adalah rantai pertukaran Microsoft DirectX atau permukaan Microsoft DirectComposition.
Pembungkus jendela dibuat dengan metode CreateSurfaceFromHwnd dan merupakan stand-in untuk rasterisasi jendela lain, yang harus merupakan jendela tingkat atas atau jendela anak berlapis. Pembungkus jendela secara konseptual setara dengan bitmap yang merupakan ukuran jendela target tempat isi jendela digambar. Konten termasuk jendela anak jendela target (berlapis atau sebaliknya), dan konten DirectComposition apa pun yang digambar di jendela anak.
Pembungkus permukaan DirectComposition dibuat dengan metode CreateSurfaceFromHandle dan merupakan referensi ke rantai pertukaran. Aplikasi mungkin menggunakan pembungkus permukaan dalam skenario lintas proses di mana satu proses membuat rantai pertukaran dan proses lain mengaitkan bitmap dengan visual.
Bitmap selalu digambar pada posisi (0,0) relatif terhadap sistem koordinat visual, meskipun sistem koordinat dipengaruhi langsung oleh properti OffsetX, OffsetY, dan Transformasi, serta secara tidak langsung oleh transformasi pada visual leluhur. Bitmap visual selalu digambar di belakang anak-anak visual itu.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows 8 [khusus aplikasi desktop] |
Server minimum yang didukung | Windows Server 2012 [hanya aplikasi desktop] |
Target Platform | Windows |
Header | dcomp.h |
Pustaka | Dcomp.lib |
DLL | Dcomp.dll |
Lihat juga
IDXGIFactory2::CreateSwapChain1
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk