Metode ID2D1Bitmap::CopyFromBitmap (d2d1.h)

  • Artikel

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

Sintaks

HRESULT CopyFromBitmap(
  [in, optional] const D2D1_POINT_2U *destPoint,
  [in]           ID2D1Bitmap         *bitmap,
  [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] bitmap

Jenis: ID2D1Bitmap*

Bitmap untuk disalin.

[in, optional] srcRect

Jenis: const D2D1_RECT_U*

Area bitmap yang akan disalin.

Mengembalikan nilai

Jenis: HRESULT

Jika metode ini berhasil, metode ini 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. Selain itu, perhatikan 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 dibersihkan. Status HRESULT dan tag yang gagal akan dikembalikan pada panggilan berikutnya ke EndDraw atau Flush.

Dimulai dengan Windows 8.1, metode ini mendukung bitmap terkompresi blok. Jika Anda menggunakan format terkompresi blok, koordinat akhir parameter srcRect harus kelipatan 4 atau metode mengembalikan E_INVALIDARG.

Persyaratan

Persyaratan Nilai
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