Compartilhar via


Função GdiComment (wingdi.h)

A função GdiComment copia um comentário de um buffer para um meta-arquivo de formato aprimorado especificado.

Sintaxe

BOOL GdiComment(
  [in] HDC        hdc,
  [in] UINT       nSize,
  [in] const BYTE *lpData
);

Parâmetros

[in] hdc

Um identificador para um contexto de dispositivo de meta-arquivo aprimorado.

[in] nSize

O comprimento do buffer de comentário, em bytes.

[in] lpData

Um ponteiro para o buffer que contém o comentário.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero.

Comentários

Um comentário pode incluir qualquer tipo de informação privada, por exemplo, a origem de uma imagem e a data em que ela foi criada. Um comentário deve começar com uma assinatura de aplicativo, seguida pelos dados.

Os comentários não devem conter dados específicos do aplicativo ou específicos da posição. Dados específicos de posição especificam o local de um registro e não devem ser incluídos porque um meta-arquivo pode ser inserido em outro meta-arquivo.

Um comentário público é um comentário que começa com o identificador de assinatura de comentário GDICOMMENT_IDENTIFIER. Os comentários públicos a seguir são definidos.

GDICOMMENT_WINDOWS_METAFILE O comentário público GDICOMMENT_WINDOWS_METAFILE contém um metarquivo no formato windows equivalente a um metarquivo de formato aprimorado. Este comentário é escrito apenas pela função SetWinMetaFileBits . O registro de comentário, se dado, segue o registro de meta-arquivo ENHMETAHEADER . O comentário tem o seguinte formato:
 

DWORD ident;         // This contains GDICOMMENT_IDENTIFIER.  
DWORD iComment;      // This contains GDICOMMENT_WINDOWS_METAFILE.  
DWORD nVersion;      // This contains the version number of the  
                     // Windows-format metafile.  
DWORD nChecksum;     // This is the additive DWORD checksum for  
                     // the enhanced metafile.  The checksum  
                     // for the enhanced metafile data including  
                     // this comment record must be zero.  
                     // Otherwise, the enhanced metafile has been  
                     //  modified and the Windows-format  
                     // metafile is no longer valid.  
DWORD fFlags;        // This must be zero.  
DWORD cbWinMetaFile; // This is the size, in bytes. of the  
                     // Windows-format metafile data that follows.  

GDICOMMENT_BEGINGROUP O comentário público GDICOMMENT_BEGINGROUP identifica o início de um grupo de registros de desenho. Ele identifica um objeto dentro de um meta-arquivo aprimorado. O comentário tem o seguinte formato:
 

DWORD   ident;         // This contains GDICOMMENT_IDENTIFIER.  
DWORD   iComment;      // This contains GDICOMMENT_BEGINGROUP.  
RECTL   rclOutput;     // This is the bounding rectangle for the  
                       // object in logical coordinates.  
DWORD   nDescription;  // This is the number of characters in the  
                       // optional Unicode description string that  
                       // follows. This is zero if there is no  
                       // description string.  

GDICOMMENT_ENDGROUP O comentário público GDICOMMENT_ENDGROUP identifica o final de um grupo de registros de desenho. O comentário GDICOMMENT_BEGINGROUP e o comentário GDICOMMENT_ENDGROUP devem ser incluídos em um par e podem estar aninhados. O comentário tem o seguinte formato:
 

DWORD   ident;       // This contains GDICOMMENT_IDENTIFIER.  
DWORD   iComment;    // This contains GDICOMMENT_ENDGROUP.  

Requisitos

Requisito Valor
Cliente mínimo com suporte 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 wingdi.h (inclua Windows.h)
Biblioteca Gdi32.lib
DLL Gdi32.dll

Confira também

CreateEnhMetaFile

Funções de metarquivo

Visão geral de meta-arquivos

SetWinMetaFileBits