wglRealizeLayerPalette 函式 (wingdi.h)
wglRealizeLayerPalette 函式會將指定色彩索引層平面的調色盤項目對應到實體調色盤,或初始化 RGBA 圖層平面的調色盤。
語法
BOOL wglRealizeLayerPalette(
HDC unnamedParam1,
int unnamedParam2,
BOOL unnamedParam3
);
參數
unnamedParam1
指定要在實體調色盤中實現圖層平面調色盤之視窗的裝置內容。
unnamedParam2
指定重疊或下層平面。 iLayerPlane 的正值會識別重疊平面,其中 1 是主要平面的第一個重疊平面,2 是第一個重疊平面上的第二個重疊平面,依此類傳。 負值會識別下層平面,其中 1 是主要平面下的第一個下層平面,2 是第一個下層平面底下的第二個下層平面,依此類故。 在 PIXELFORMATDESCRIPTOR 結構的 bReserved 成員中,會提供重疊和下層平面的數目。
unnamedParam3
指出調色盤是否要實現到實體調色盤中。 當 bRealize 為 TRUE 時,調色盤項目會對應至可用的實體調色盤。 當 bRealize 為 FALSE 時,不再需要視窗圖層平面的調色盤專案,而且可能會釋出以供另一個前景視窗使用。
傳回值
如果函式成功,則傳回值為 TRUE,即使 bRealize 為 TRUE 且實體調色盤無法使用也一樣。 如果函式失敗,或未選取任何像素格式時,傳回值為 FALSE。 若要取得擴充的錯誤資訊,請呼叫 GetLastError。
備註
層次平面的實體調色盤是具有圖層平面的視窗之間的共享資源。 當多個視窗嘗試實現指定實體層平面的調色盤時,一次只會實現一個調色盤。 當您呼叫 wglRealizeLayerPalette 函式時,前景視窗的圖層調色盤一律會先實現。
當視窗的圖層調色盤實現時,其調色盤專案一律會將一對一對應至實體調色盤。 不同於 GDI 邏輯調色盤, wglRealizeLayerPalette 不會將其他視窗的圖層調色盤對應至目前的實體調色盤。
每當視窗變成前景視窗時,請呼叫 wglRealizeLayerPalette 再次實現其圖層調色盤,即使圖層平面的圖元類型為 RGBA 也一樣。
因為 wglRealizeLayerPalette 無法瞭解主平面的調色盤,所以使用 GDI 調色盤函式來實現主要平面調色盤。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | wingdi.h |
程式庫 | Opengl32.lib |
Dll | Opengl32.dll |