Compartilhar via


Método Graphics::EnumerateMetafile(constMetafile*,constPoint*,INT,constRect&,Unit,EnumerateMetafileProc,VOID*,constImageAttributes*) (gdiplusgraphics.h)

O método Graphics::EnumerateMetafile chama uma função de retorno de chamada definida pelo aplicativo para cada registro em um meta-arquivo especificado. Você pode usar esse método para exibir um metarquivo chamando PlayRecord na função de retorno de chamada.

Sintaxe

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

Parâmetros

[in] metafile

Tipo: const Metafile*

Ponteiro para um meta-arquivo a ser enumerado.

[in] destPoints

Tipo: const Point*

Ponteiro para uma matriz de pontos de destino. Essa é uma matriz de três pontos que define o paralelismo de destino para o metarquivo exibido.

[in] count

Tipo: INT

Inteiro que especifica o número de pontos na matriz destPoints .

[in, ref] srcRect

Tipo: const Rect

Referência a um retângulo que especifica a parte do metarquivo que é exibida.

[in] srcUnit

Tipo: Unidade

Elemento da enumeração Unit que especifica a unidade de medida para o retângulo de origem.

[in] callback

Tipo: EnumerateMetafileProc

Ponteiro para uma função de retorno de chamada definida pelo aplicativo. O protótipo da função de retorno de chamada é dado em Gdiplustypes.h.

[in] callbackData

Tipo: VOID*

Opcional. Ponteiro para um bloco de dados que é passado para a função de retorno de chamada. O valor padrão é NULL.

[in] imageAttributes

Tipo: ImageAttributes*

Opcional. Ponteiro para um objeto ImageAttributes que especifica ajustes de cor para o metarquivo exibido. O valor padrão é NULL.

Retornar valor

Tipo: Status

Se o método for bem-sucedido, ele retornará Ok, que é um elemento da enumeração Status .

Se o método falhar, ele retornará um dos outros elementos da enumeração Status .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP, Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho gdiplusgraphics.h (inclua Gdiplus.h)
Biblioteca Gdiplus.lib
DLL Gdiplus.dll