Bagikan melalui

METODE IDCompositionVisual::SetContent (dcomp.h)

  • Artikel

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:

Konten baru menggantikan konten apa pun yang sebelumnya terkait dengan visual. Jika parameter konten NULL, visual tidak memiliki konten terkait.

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

IDCompositionVisual

IDXGIFactory2::CreateSwapChain1