| 术语 | gdicomment |
| 释义 | GdiComment 语法： BOOL GdiComment( __in HDC hdc, __in UINT cbSize, __in const BYTE *lpData ); GdiComment功能 复制的GdiComment函数从一个缓冲区指定的增强型图元文件格式的评论。 参数 hdc [in] 的句柄增强型图元文件设备上下文。 cbSize [in] 该评论的缓冲区的长度，以字节为单位。 lpData [in] 一个缓冲区，它包含注释指针。 返回值 如果函数成功，返回值为非零。 如果函数失败，返回值是零。 备注 注释可以包括任何种类的私人信息，例如图片的来源和它的创建日期。注释应该从一个应用程序的签名，其次是数据。 评论不应该包含应用程序或特定位置的数据。位置特定的数据指定一个记录的位置，不应该包括在内，因为一个图元文件可以嵌入在另一个图元文件。 一个公开评论是一个注释，注释的签名与标识符GDICOMMENT_IDENTIFIER开始。市民的意见如下定义。 GDICOMMENT_WINDOWS_METAFILEThe GDICOMMENT_WINDOWS_METAFILE公开评论包含一个Windows格式元文件相当于一个增强型图元文件格式。这句话是只写了SetWinMetaFileBits功能。注释记录，如果有，遵循ENHMETAHEADER图元文件记录。注释有以下形式： 双字节值IDENT公司; / /这包含GDICOMMENT_IDENTIFIER。 双字节值iComment; / /这包含GDICOMMENT_WINDOWS_METAFILE。 双字节值nVersion; / /这包含版本号 / /的Windows图元文件格式。 双字节值nChecksum; / /这是为添加剂双字节值校验 / /增强型图元文件。校验 / /使用，包括增强型图元数据 / /此评论记录必须为零。 / /否则，增强型图元已 / /修改和Windows格式 / /图元文件不再有效。 双字节值fFlags; / /这个必须为零。 双字节值cbWinMetaFile; / /这是大小，以字节。的 / /的Windows图元文件格式的数据如下。 GDICOMMENT_BEGINGROUPThe GDICOMMENT_BEGINGROUP公众意见确定的图画组记录的开始。它确定了在一个增强型图元对象。注释有以下形式： 双字节值IDENT公司; / /这包含GDICOMMENT_IDENTIFIER。 双字节值iComment; / /这包含GDICOMMENT_BEGINGROUP。 RECTL rclOutput; / /这是边界矩形 / /在逻辑坐标的对象。 双字节值nDescription; / /这是字符数 / /可选的Unicode字符串描述 / /如下。这是零，如果没有 / /描述字符串。 GDICOMMENT_ENDGROUPThe GDICOMMENT_ENDGROUP公众意见确定的图画组记录结束。在GDICOMMENT_BEGINGROUP意见和GDICOMMENT_ENDGROUP评论必须包含在一对，可以嵌套。注释有以下形式： 双字节值IDENT公司; / /这包含GDICOMMENT_IDENTIFIER。 双字节值iComment; / /这包含GDICOMMENT_ENDGROUP。 要求： 最低支持：client－Windows 2000专业版 最低支持server－Windows 2000服务器 HeaderWingdi.h(头文件：winuser.h) LibraryGdi32.lib DLLGdi32.dll 参见 图元文件概述 图元文件函数 CreateEnhMetaFile SetWinMetaFileBits 如果有任何问题和意见，请发送给微软(wsddocfb@microsoft.com) 生成日期：2009年7月11日 ＝＝英文原文＝＝GdiComment Function The GdiComment function copies a comment from a buffer into a specified enhanced-format metafile. Syntax BOOL GdiComment( __in HDC hdc, __in UINT cbSize, __in const BYTE *lpData ); Parameters hdc [in] A handle to an enhanced-metafile device context. cbSize [in] The length of the comment buffer, in bytes. lpData [in] A pointer to the buffer that contains the comment. Return Value If the function succeeds, the return value is nonzero. If the function fails, the return value is zero. Remarks A comment can include any kind of private information, for example, the source of a picture and the date it was created. A comment should begin with an application signature, followed by the data. Comments should not contain application-specific or position-specific data. Position-specific data specifies the location of a record, and it should not be included because one metafile may be embedded within another metafile. A public comment is a comment that begins with the comment signature identifier GDICOMMENT_IDENTIFIER. The following public comments are defined. GDICOMMENT_WINDOWS_METAFILEThe GDICOMMENT_WINDOWS_METAFILE public comment contains a Windows-format metafile that is equivalent to an enhanced-format metafile. This comment is written only by the SetWinMetaFileBits function. The comment record, if given, follows the ENHMETAHEADER metafile record. The comment has the following form: 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_BEGINGROUPThe GDICOMMENT_BEGINGROUP public comment identifies the beginning of a group of drawing records. It identifies an object within an enhanced metafile. The comment has the following form: 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_ENDGROUPThe GDICOMMENT_ENDGROUP public comment identifies the end of a group of drawing records. The GDICOMMENT_BEGINGROUP comment and the GDICOMMENT_ENDGROUP comment must be included in a pair and may be nested. The comment has the following form: DWORD ident; // This contains GDICOMMENT_IDENTIFIER. DWORD iComment; // This contains GDICOMMENT_ENDGROUP. Requirements Minimum supported clientWindows 2000 Professional Minimum supported serverWindows 2000 Server HeaderWingdi.h (include Windows.h) LibraryGdi32.lib DLLGdi32.dll See Also Metafiles Overview Metafile Functions CreateEnhMetaFile SetWinMetaFileBits Send comments about this topic to Microsoft Build date: 7/11/2009 ＝＝原始网址＝＝http://msdn.microsoft.com/en-us/library/dd144843(VS.85).aspx\n |
| 随便看 |
|
windows api函数参考手册包含2258条windows api函数文档，详细介绍nodejs、java、rust调用windows api的方法技巧，是学习windows api编程的入门中文文档。