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 后不应尝试使用它。

要求

要求 值
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 shimgdata.h
DLL Shell32.dll