Метод 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.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	shimgdata.h
DLL	Shell32.dll