ENHMETAHEADER 結構 (wingdi.h)

ENHMETAHEADER 結構包含增強型元文件數據，例如儲存在增強元檔中的圖片維度、增強元檔中的記錄計數、圖片建立所在裝置的解析度等等。

這個結構一律是增強元檔中的第一筆記錄。

語法

typedef struct tagENHMETAHEADER {
  DWORD iType;
  DWORD nSize;
  RECTL rclBounds;
  RECTL rclFrame;
  DWORD dSignature;
  DWORD nVersion;
  DWORD nBytes;
  DWORD nRecords;
  WORD  nHandles;
  WORD  sReserved;
  DWORD nDescription;
  DWORD offDescription;
  DWORD nPalEntries;
  SIZEL szlDevice;
  SIZEL szlMillimeters;
  DWORD cbPixelFormat;
  DWORD offPixelFormat;
  DWORD bOpenGL;
  SIZEL szlMicrometers;
} ENHMETAHEADER, *PENHMETAHEADER, *LPENHMETAHEADER;

成員

iType

記錄類型。 此成員必須指定指派給EMR_HEADER常數的值。

nSize

結構大小，以位元組為單位。

rclBounds

以裝置單位為單位的最小矩形尺寸，可在儲存在元檔中的圖片周圍繪製。 此矩形是由圖形裝置介面提供， (GDI) 。 其維度包含右邊緣和下邊緣。

rclFrame

矩形的維度，以 .01 公厘單位為單位，圍繞儲存在元檔中的圖片。 此矩形必須由建立元檔的應用程式提供。 其維度包含右邊緣和下邊緣。

dSignature

簽章。 此成員必須指定指派給ENHMETA_SIGNATURE常數的值。

nVersion

元檔版本。 目前的版本值0x10000。

nBytes

增強型元檔的大小，以位元組為單位。

nRecords

增強元檔中的記錄數目。

nHandles

增強型元檔句柄數據表中的句柄數目。 (此數據表中的索引零是保留的。)

sReserved

保留;必須是零。

nDescription

陣列中包含增強元檔內容描述的字元數。 如果增強型元檔不包含描述字串，則此成員應該設定為零。

offDescription

從 ENHMETAHEADER 結構的開頭到包含增強元檔內容描述的陣列的位移。 如果增強型元檔不包含描述字串，則此成員應該設定為零。

nPalEntries

增強元檔調色盤中的項目數目。

szlDevice

參考裝置的解析度，以像素為單位。

szlMillimeters

參考裝置的解析度，以公厘為單位。

cbPixelFormat

元檔中最後一個錄製圖元格式的大小。 如果在錄製開始時的參考DC中設定圖元格式， cbPixelFormat 會設定為 PIXELFORMATDESCRIPTOR 的大小。 當記錄元檔時未設定圖元格式時，此成員會設定為零。 如果已設定多個單一像素格式，標頭會指向最後一個像素格式。

offPixelFormat

錄製元檔時所使用的像素格式位移。 如果在錄製開始時或在錄製期間於參考 DC 中設定圖元格式， offPixelFormat 會設定為中繼檔中 PIXELFORMATDESCRIPTOR 的位移。 如果記錄元檔時未設定任何像素格式，則此成員會設定為零。 如果已設定多個單一像素格式，標頭會指向最後一個像素格式。

bOpenGL

指出 Metafile 中是否有任何 OpenGL 記錄。 bOpenGL 是簡單的布爾值旗標，可用來判斷增強型元檔是否需要 OpenGL 處理。 當元檔包含 OpenGL 記錄時， bOpenGL 為 TRUE;否則為 FALSE。

szlMicrometers

參考裝置的大小，以微計為單位。

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
標頭	wingdi.h (包含 Windows.h)

另請參閱

ENHMETARECORD

中繼檔結構

元檔概觀

RECTL