BITMAPINFO 結構 (wingdi.h)

發行項
03/04/2024

BITMAPINFO 結構會定義 DIB 的維度和色彩資訊。

語法

typedef struct tagBITMAPINFO {
  BITMAPINFOHEADER bmiHeader;
  RGBQUAD          bmiColors[1];
} BITMAPINFO, *LPBITMAPINFO, *PBITMAPINFO;

成員

bmiHeader

BITMAPINFOHEADER 結構，其中包含色彩格式維度的相關信息。

bmiColors[1]

bmiColors 成員包含下列其中一項：

RGBQUAD 的陣列。組成色彩數據表之陣列的專案。
16 位無符號整數的陣列，指定目前實現邏輯調色盤中的索引。對於使用 DIB 的函式，允許使用 bmiColors 。 當 bmiColors 元素包含已實現邏輯調色盤的索引時，它們也必須呼叫下列點陣圖函式：
CreateDIBitmap

CreateDIBPatternBrush

CreateDIBSection

CreateDIBSection 的 iUsage 參數必須設定為 DIB_PAL_COLORS。

陣列中的項目數目取決於 BITMAPINFOHEADER 結構的 biBitCount 和 biClrUsed 成員的值。

bmiColors 數據表中的色彩會依重要性順序顯示。如需詳細資訊，請參閱＜備註＞一節。

備註

DIB 包含兩個不同的部分：描述位圖維度和色彩的 BITMAPINFO 結構，以及定義點陣圖圖元的位元陣陣陣陣。陣列中的位會封裝在一起，但每個掃描行都必須填補零，以結束 於LONG 資料類型界限。如果點的高度為正數，則點陣圖為由下至下 DIB，其原點為左下角。如果高度為負數，則點為由上而下DIB，其原點為左上角。

位圖陣陣組緊接在 BITMAPINFO 標頭之後時，會封裝點陣圖。封裝的點陣圖是由單一指標參考。對於封裝的位陣圖，當使用 DIB_PAL_COLORS 模式時， biClrUsed 成員必須設定為偶數，如此 DIB 位陣陣陣才會在 DWORD 界限上啟動。

注意

如果點圖要儲存在檔案中或傳送至另一個應用程式， bmiColors 成員不應包含調色盤索引。

除非應用程式具有位圖的獨佔用途和控制，否則點圖色彩表格應該包含明確的 RGB 值。

規格需求

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