METODE ID2D1Bitmap::CopyFromRenderTarget (d2d1.h)

Menyalin wilayah yang ditentukan dari target render yang ditentukan ke dalam bitmap saat ini.

Sintaks

HRESULT CopyFromRenderTarget(
  [in, optional] const D2D1_POINT_2U *destPoint,
  [in]           ID2D1RenderTarget   *renderTarget,
  [in, optional] const D2D1_RECT_U   *srcRect
);

Parameter

[in, optional] destPoint

Jenis: const D2D1_POINT_2U*

Di bitmap saat ini, sudut kiri atas area tempat wilayah yang ditentukan oleh srcRect disalin.

[in] renderTarget

Jenis: ID2D1RenderTarget*

Target render yang berisi wilayah yang akan disalin.

[in, optional] srcRect

Jenis: const D2D1_RECT_U*

Area renderTarget untuk disalin.

Mengembalikan nilai

Jenis: HRESULT

Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Metode ini tidak memperbarui ukuran bitmap saat ini. Jika isi bitmap sumber tidak pas di bitmap saat ini, metode ini gagal. Perhatikan juga bahwa metode ini tidak melakukan konversi format, dan akan gagal jika format bitmap tidak cocok.

Memanggil metode ini dapat menyebabkan batch saat ini memerah jika bitmap aktif dalam batch. Jika batch yang dibersihkan tidak berhasil diselesaikan, metode ini gagal. Namun, metode ini tidak menghapus status kesalahan target render tempat batch dihapus. Status HRESULT dan tag yang gagal akan dikembalikan pada panggilan berikutnya ke EndDraw atau Flush.

Semua klip dan lapisan harus dimunculkan dari target render sebelum memanggil metode ini. Metode mengembalikan D2DERR_RENDER_TARGET_HAS_LAYER_OR_CLIPRECT jika ada klip atau lapisan yang saat ini diterapkan ke target render.

Persyaratan

Klien minimum yang didukung	Windows 7, Windows Vista dengan SP2 dan Pembaruan Platform untuk Windows Vista [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 R2, Windows Server 2008 dengan SP2 dan Pembaruan Platform untuk Windows Server 2008 [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	d2d1.h
Pustaka	D2d1.lib
DLL	D2d1.dll

Lihat juga

ID2D1Bitmap