EMRGRADIENTFILL 結構（wingdi.h）

發行項
07/16/2024

EMRGRADIENTFILL 結構包含 GradientFill 增強元文件記錄的成員。

語法

typedef struct tagEMRGRADIENTFILL {
  EMR       emr;
  RECTL     rclBounds;
  DWORD     nVer;
  DWORD     nTri;
  ULONG     ulMode;
  TRIVERTEX Ver[1];
} EMRGRADIENTFILL, *PEMRGRADIENTFILL;

成員

emr

所有記錄類型的基底結構。

rclBounds

周框，以裝置單位為單位。

nVer

頂點數目。

nTri

要傳遞至 gradientFill 的矩形或三角形數目。

ulMode

漸層填滿模式。這個成員可以是下列其中一個值。

價值	意義
GRADIENT_FILL_RECT_H	在此模式中，兩個端點會描述矩形。矩形定義為具有左右邊緣的常數色彩（由 TRIVERTEX 結構指定）。 GDI 會從左到右邊緣插補色彩，並填滿內部。
GRADIENT_FILL_RECT_V	在此模式中，兩個端點會描述矩形。矩形定義為具有頂端和下邊緣的常數色彩（由 TRIVERTEX 結構指定）。 GDI 會從上到下邊緣插補色彩，並填滿內部。
GRADIENT_FILL_TRIANGLE	在此模式中，會傳遞 TRIVERTEX 結構的陣列，以及描述個別三角形的陣列索引清單。 GDI 會在三角形頂點之間執行線性插補，並填滿內部。繪圖會以 24 和 32-bpp 模式直接完成。 Dithering 是以 16、8、4 和 1-bpp 模式執行。

Ver[1]

TRIVERTEX 結構陣列，每個結構都會定義頂點。

言論

這是可變長度的結構。 Ver 成員會指定可變長度區域的開頭。首先，nVerTRIVERTEX 結構陣列來傳遞頂點。接下來會根據 ulMode ulMode 的值，nTriGRADIENT_TRIANGLE 結構或 nTriGRADIENT_RECT 結構數位。

此結構將在元檔播放期間使用。

要求

要求	價值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器	Windows 2000 Server [僅限傳統型應用程式]
標頭	wingdi.h （包括 Windows.h）