IShellImageData::ReplaceFrame method (shimgdata.h)

Artikel
08/26/2023

Mengganti bingkai saat ini dengan gambar baru.

Sintaks

HRESULT ReplaceFrame(
  [in] Image *pImg
);

Parameter

[in] pImg

Jenis: Gambar*

Alamat gambar baru.

Nilai kembali

Jenis: HRESULT

Selalu mengembalikan S_OK.

Keterangan

Anda juga harus memanggil IShellImageData::D iscardEdit untuk memastikan bahwa properti gambar asli yang diedit tidak dipertahankan.

Dalam kasus gambar multiframed seperti file .gif, bingkai saat ini diganti. Dalam kasus gambar non-multiframed seperti file .jpg, seluruh gambar diganti.

Mengganti bingkai dalam file .gif animasi menyebabkan animasi file tidak lagi berfungsi. Mengganti bingkai dalam file Format File Gambar Bertag (TIFF) dapat menyebabkan file tersebut kehilangan halaman, terutama jika gambar bingkai TIFF tidak berukuran sama dengan aslinya. Jika memungkinkan, Anda harus selalu mengganti gambar bingkai TIFF dengan TIFF dengan ukuran yang sama.

Implementasi IShellImageData mengambil kepemilikan gambar bernama pImg dan pemanggil tidak boleh mencoba menggunakannya setelah memanggil IShellImageData::ReplaceFrame.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	shimgdata.h
DLL	Shell32.dll

Bagikan melalui