Graphics::EnumerateMetafile(constMetafile*,constRect&,constRect&,Unit,EnumerateMetafileProc,VOID*,constImageAttributes*) (gdiplusgraphics.h)

Метод Graphics::EnumerateMetafile вызывает определяемую приложением функцию обратного вызова для каждой записи в указанном метафайле. Этот метод можно использовать для отображения метафайла путем вызова PlayRecord в функции обратного вызова.

Синтаксис

Status EnumerateMetafile(
  [in]      const Metafile        *metafile,
  [in, ref] const Rect &          destRect,
  [in, ref] const Rect &          srcRect,
  [in]      Unit                  srcUnit,
  [in]      EnumerateMetafileProc callback,
  [in]      VOID                  *callbackData,
  [in]      const ImageAttributes *imageAttributes
);

Параметры

[in] metafile

Тип: константный метафайл*

Указатель на перечисляемый метафайл.

[in, ref] destRect

Тип: const Rect

Ссылка на объект Rect , указывающий прямоугольник, в котором отображается метафайл.

[in, ref] srcRect

Тип: const Rect

Ссылка на объект Rect , указывающий часть отображаемого метафайла.

[in] srcUnit

Тип: Единица измерения

Элемент перечисления Unit , указывающий единицу измерения для исходного прямоугольника.

[in] callback

Тип: EnumerateMetafileProc

Указатель на функцию обратного вызова, определяемую приложением. Прототип функции обратного вызова предоставляется в Gdiplustypes.h.

[in] callbackData

Тип: VOID*

Необязательный элемент. Указатель на блок данных, передаваемый в функцию обратного вызова. Значение по умолчанию — NULL.

[in] imageAttributes

Тип: ImageAttributes*

Необязательный элемент. Указатель на объект ImageAttributes , указывающий настройки цвета для отображаемого метафайла. Значение по умолчанию — NULL.

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

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

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

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

Требования

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