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 |