Метод Image::SelectActiveFrame (gdiplusheaders.h)

Статья
08/24/2023

Метод Image::SelectActiveFrame выбирает кадр в этом объекте Image , заданный измерением и индексом.

Синтаксис

Status SelectActiveFrame(
  [in] const GUID *dimensionID,
  [in] UINT       frameIndex
);

Параметры

[in] dimensionID

Тип: const GUID*

Указатель на GUID , указывающий измерение кадра. Идентификаторы GUID, идентифицирующие различные размеры кадра, определяются в Gdiplusimaging.h.

[in] frameIndex

Тип: UINT

Целое число, указывающее индекс кадра в пределах указанного измерения кадра.

Возвращаемое значение

Тип: Состояние

В случае успешного выполнения метода возвращается ОК, который является элементом перечисления Status .

Если метод завершается сбоем, он возвращает один из других элементов перечисления Status .

Замечания

При вызове метода Image::SelectActiveFrame все изменения, внесенные в ранее активный кадр, удаляются. Если вы хотите сохранить изменения, внесенные в кадр, вызовите метод Save , прежде чем переключаться на другой кадр.

Среди всех форматов изображений, поддерживаемых в настоящее время GDI+, единственными форматами, поддерживающими многокадровые изображения, являются GIF и TIFF. При вызове метода Image::SelectActiveFrame для ИЗОБРАЖЕНИЯ GIF следует использовать FrameDimensionTime. При вызове метода Image::SelectActiveFrame для изображения TIFF следует использовать FrameDimensionPage.

Требования


Минимальная версия клиента	Windows XP, Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	gdiplusheaders.h (включая Gdiplus.h)
Библиотека	Gdiplus.lib
DLL	Gdiplus.dll