Поделиться через

Функция GdiComment (wingdi.h)

  • Статья

Функция GdiComment копирует комментарий из буфера в указанный метафайл расширенного формата.

Синтаксис

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

Параметры

[in] hdc

Дескриптор контекста устройства с расширенным метафайлом.

[in] nSize

Длина буфера комментариев в байтах.

[in] lpData

Указатель на буфер, содержащий комментарий.

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

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение.

Комментарии

Комментарий может содержать любые личные сведения, например источник изображения и дату его создания. Комментарий должен начинаться с подписи приложения, за которой следуют данные.

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

Общедоступный комментарий — это комментарий, который начинается с идентификатора подписи комментария GDICOMMENT_IDENTIFIER. Определены следующие общедоступные комментарии.

GDICOMMENT_WINDOWS_METAFILE Общедоступный комментарий GDICOMMENT_WINDOWS_METAFILE содержит метафайл в формате Windows, эквивалентный метафайлу расширенного формата. Этот комментарий написан только функцией SetWinMetaFileBits . Запись комментария, если она указана, следует за записью метафайла ENHMETAHEADER . Комментарий имеет следующую форму:
  

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 В GDICOMMENT_BEGINGROUP публичного комментария указывается начало группы записей рисования. Он идентифицирует объект в расширенном метафайле. Комментарий имеет следующую форму:
  

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 В GDICOMMENT_ENDGROUP публичного комментария указывается конец группы записей о рисовании. Комментарий GDICOMMENT_BEGINGROUP и комментарий GDICOMMENT_ENDGROUP должны быть включены в пару и могут быть вложенными. Комментарий имеет следующую форму:
  

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

Требования

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

См. также раздел

CreateEnhMetaFile

Функции метафайлов

Общие сведения о метафайлах

SetWinMetaFileBits