IShellImageData：：ReplaceFrame 方法 (shimgdata.h)

以新的影像取代目前的框架。

語法

HRESULT ReplaceFrame(
  [in] Image *pImg
);

[in] pImg

類型：影像*

新映像的位址。

類型： HRESULT

一律會傳回S_OK。

您也應該呼叫 IShellImageData：:D iscardEdit ，以確保不會保留原始影像的任何編輯屬性。

在多框架影像的案例中，例如 .gif 檔案，則會取代目前的框架。如果是非多框架映像，例如 .jpg 檔案，則會取代整個映像。

取代動畫 .gif 檔案中的框架會導致該檔案的動畫不再運作。取代標記影像檔格式中的框架 (TIFF) 檔案可能會導致該檔案遺失頁面，特別是當 TIFF 框架的影像大小與原始檔案不同時。可能的話，您應該一律以相同大小的 TIFF 取代 TIFF 框架的影像。

IShellImageData 實作會取得 pImg 中名為的映射擁有權，呼叫端不應在呼叫 IShellImageData：：ReplaceFrame 之後嘗試使用它。