gdicomment

為指定的增強型圖元檔案設備場景添加一條注釋信息

基本介紹

• 外文名：gdicomment
• 對象：指定的增強型圖元檔案設備場景
• 作用：添加一條注釋信息
• 領域：程式設計

聲明信息

Declare Function GdiComment Lib "gdi32" Alias "GdiComment" (ByVal hdc As Long, ByVal cbSize As Long, lpData As Byte) As Long

使用說明

[參數表]

hdc ------------ Long，目標增強型圖元檔案設備場景的句柄

cbSize --------- Long，欲嵌入圖元檔案的數據長度

lpData --------- Byte，一個注釋結構或一個緩衝區的Long記憶體地址，其中包含了欲添加的注釋正文

[返回值]

Long，非零表示成功，零表示失敗

[其它]

儘管可在圖元檔案中嵌入任何專用或私有（Private）信息，但只有幾種全局數據格式能夠嵌入。如將緩衝區看作一個32位Long型值的數組，則全局注釋的值就是下面這個樣子：

第一個條目是常數GDICOMMENT_IDENTIFIER

第二個條目如下所示：

首先是一個GDICOMMENT_WINDOWS_METAFILE——在增強型圖元檔案中嵌入一個標準圖元檔案。它的後面跟隨下述值之一：

□ 標準圖元檔案的版本號

□ 一個校驗和（checksum）值：所有圖元檔案數據的總和——包括這個值——必須是零

□ 零

□ 後面跟隨的視窗圖元檔案的大小

GDICOMMENT_BEGINGROUP——標誌一組繪圖命令在增強型圖元檔案在中的起始處。它的後面跟隨：

□ 四個Long值。定義一個RECT結構。結構中包含了繪圖命令的約束矩形

□ 可選的Unicode字串的長度。字串中包含對命令組的說明文字。如不想提供說明，可設為零

GDICOMMENT_ENDGROUP——標誌增強型圖元檔案中的一組繪圖命令的結尾

GDICOMMENT_MULTIFORMATS——以不同的格式嵌入一幅處理過的圖象。例如，可利用這個注釋在一個增強型圖元檔案中嵌入一個封裝式PostScript圖象。回放這條記錄的時候，windows會重畫它能描繪的第一組格式。它的後面跟隨：

□ 四個Long值。定義一個RECT結構。結構中包含了繪圖命令的約束矩形

□ 包括在注釋中的格式數量

□ 一系列EMRFORMAT結構，每種格式使用一個