wglGetLayerPaletteEntries 函式 (wingdi.h)
從指定裝置內容的指定色彩索引層平面擷取調色盤專案。
語法
int wglGetLayerPaletteEntries(
HDC unnamedParam1,
int unnamedParam2,
int unnamedParam3,
int unnamedParam4,
COLORREF *unnamedParam5
);
參數
unnamedParam1
類型： HDC
要描述圖層平面的視窗裝置內容。
unnamedParam2
類型： int
重疊或下層平面。 iLayerPlane 的正值會識別重疊平面，其中 1 是主要平面的第一個重疊平面，2 是第一個重疊平面上的第二個重疊平面，依此類傳。 負值會識別下層平面，其中 1 是主要平面下的第一個下層平面，2 是第一個下層平面底下的第二個下層平面，依此類故。 在 PIXELFORMATDESCRIPTOR 結構的 bReserved 成員中，會提供重疊和下層平面的數目。
unnamedParam3
類型： int
要擷取的第一個調色盤專案。
unnamedParam4
類型： int
要擷取的調色盤項目數目。
unnamedParam5
類型： COLORREF*
結構陣列，包含調色盤 RGB 色彩值。 數位必須至少包含 cEntries 所指定的結構數目。
傳回值
類型： int
如果函式成功，則傳回值是視窗指定圖層平面的調色盤中所設定的項目數。
如果函式失敗，或未選取任何像素格式時，傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。
備註
視窗中的每個色彩索引層平面都有大小為 2^n 的調色盤，其中 n 是圖層平面中的位平面數目。 您無法修改調色盤的透明索引。
使用 wglRealizeLayerPalette 函式來實現圖層調色盤。 一開始，圖層調色盤只包含白色的專案。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | wingdi.h |
| 程式庫 | Opengl32.lib |
| Dll | Opengl32.dll |