共用方式為


wglRealizeLayerPalette 函式 (wingdi.h)

wglRealizeLayerPalette 函式會將指定色彩索引層平面的調色盤項目對應到實體調色盤,或初始化 RGBA 圖層平面的調色盤。

語法

BOOL wglRealizeLayerPalette(
  HDC  unnamedParam1,
  int  unnamedParam2,
  BOOL unnamedParam3
);

參數

unnamedParam1

指定要在實體調色盤中實現圖層平面調色盤之視窗的裝置內容。

unnamedParam2

指定重疊或下層平面。 iLayerPlane 的正值會識別重疊平面,其中 1 是主要平面的第一個重疊平面,2 是第一個重疊平面上的第二個重疊平面,依此類傳。 負值會識別下層平面,其中 1 是主要平面下的第一個下層平面,2 是第一個下層平面底下的第二個下層平面,依此類故。 在 PIXELFORMATDESCRIPTOR 結構的 bReserved 成員中,會提供重疊和下層平面的數目。

unnamedParam3

指出調色盤是否要實現到實體調色盤中。 當 bRealizeTRUE 時,調色盤項目會對應至可用的實體調色盤。 當 bRealizeFALSE 時,不再需要視窗圖層平面的調色盤專案,而且可能會釋出以供另一個前景視窗使用。

傳回值

如果函式成功,則傳回值為 TRUE,即使 bRealizeTRUE 且實體調色盤無法使用也一樣。 如果函式失敗,或未選取任何像素格式時,傳回值為 FALSE。 若要取得擴充的錯誤資訊,請呼叫 GetLastError

備註

層次平面的實體調色盤是具有圖層平面的視窗之間的共享資源。 當多個視窗嘗試實現指定實體層平面的調色盤時,一次只會實現一個調色盤。 當您呼叫 wglRealizeLayerPalette 函式時,前景視窗的圖層調色盤一律會先實現。

當視窗的圖層調色盤實現時,其調色盤專案一律會將一對一對應至實體調色盤。 不同於 GDI 邏輯調色盤, wglRealizeLayerPalette 不會將其他視窗的圖層調色盤對應至目前的實體調色盤。

每當視窗變成前景視窗時,請呼叫 wglRealizeLayerPalette 再次實現其圖層調色盤,即使圖層平面的圖元類型為 RGBA 也一樣。

因為 wglRealizeLayerPalette 無法瞭解主平面的調色盤,所以使用 GDI 調色盤函式來實現主要平面調色盤。

規格需求

需求
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 wingdi.h
程式庫 Opengl32.lib
Dll Opengl32.dll

另請參閱

LAYERPLANEDESCRIPTOR

Windows 上的 OpenGL

PIXELFORMATDESCRIPTOR

WGL 函式

wglDescribeLayerPlane

wglGetLayerPaletteEntries

wglRealizeLayerPalette

wglSetLayerPaletteEntries