Método Metafile::Metafile(IStream,HDC,constRect&,MetafileFrameUnit,EmfType,constWCHAR) (gdiplusheaders.h)

Artigo
01/10/2024

Cria um objeto Metafile::Metafile para gravação em uma interface IStream .

Sintaxe

void Metafile(
  [in]      IStream           *stream,
  [in]      HDC               referenceHdc,
  [in, ref] const Rect &      frameRect,
  [in]      MetafileFrameUnit frameUnit,
  [in]      EmfType           type,
  [in]      const WCHAR       *description
);

Parâmetros

[in] stream

Tipo: IStream*

Ponteiro para uma interface COM IStream que aponta para um fluxo de dados em um arquivo. Quando os comandos forem gravados, eles serão salvos nesse fluxo.

[in] referenceHdc

Tipo: HDC

Identificador do Windows para um contexto de dispositivo que contém atributos do dispositivo de exibição que é usado para registrar o metarquivo.

[in, ref] frameRect

Tipo: const Rect

Referência a um retângulo que vincula a exibição de metarquivo.

[in] frameUnit

Tipo: MetafileFrameUnit

Opcional. Elemento da enumeração MetafileFrameUnit que especifica a unidade de medida para frameRect. O valor padrão é MetafileFrameUnitGdi.

[in] type

Tipo: EmfType

Opcional. Elemento da enumeração EmfType que especifica o tipo de metarquivo que será registrado. O valor padrão é EmfTypeEmfPlusDual.

[in] description

Tipo: const WCHAR*

Opcional. Ponteiro para uma cadeia de caracteres largos que especifica o nome descritivo do metarquivo. O valor padrão é NULL.

Retornar valor

Nenhum

Comentários

Ao gravar em um arquivo, o arquivo deve ser gravável e o Windows GDI+ deve ser capaz de obter um bloqueio exclusivo no arquivo.

Requisitos


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	gdiplusheaders.h (inclua Gdiplus.h)
Biblioteca	Gdiplus.lib
DLL	Gdiplus.dll