IShellImageData：：ReplaceFrame 方法 (shimgdata.h)

将当前帧替换为新图像。

语法

HRESULT ReplaceFrame(
  [in] Image *pImg
);

[in] pImg

类型： Image*

新映像的地址。

类型： HRESULT

始终返回 S_OK。

还应调用 IShellImageData：:D iscardEdit ，以确保不会保留原始图像的任何已编辑属性。

对于多帧图像（例如 .gif 文件），将替换当前帧。对于非多帧图像（例如 .jpg 文件），将替换整个图像。

替换动画 .gif 文件中的帧会导致该文件的动画不再正常工作。替换标记图像文件格式 (TIFF) 文件中的帧可能会导致该文件丢失页，特别是当 TIFF 帧的图像大小与原始图像不同时。如果可能，应始终将 TIFF 帧的图像替换为相同大小的 TIFF。

IShellImageData 实现获取 pImg 中名为的映像的所有权，调用方在调用 IShellImageData：：ReplaceFrame 后不应尝试使用它。