RealizePalette 函式 (wingdi.h)

RealizePalette函式會將調色盤專案從目前的邏輯調色盤對應至系統調色盤。

語法

UINT RealizePalette(
  [in] HDC hdc
);

[in] hdc

已選取邏輯調色盤之裝置內容的控制碼。

如果函式成功，則傳回值是對應至系統調色盤之邏輯調色盤中的專案數。

如果函式失敗，傳回值會GDI_ERROR。

應用程式可以呼叫 GetDeviceCaps 函式並指定 RASTERCAPS 常數，來判斷裝置是否支援調色盤作業。

RealizePalette函式會修改與指定裝置內容相關聯之裝置的調色盤。如果裝置內容是記憶體 DC，則會修改選取至 DC 之點陣圖的色彩表格。如果裝置內容是顯示 DC，則會修改該裝置的實體調色盤。

邏輯調色盤是大量色彩應用程式與系統之間的緩衝區，可讓這些應用程式視需要使用任意數量的色彩，而不會干擾其他視窗所顯示的色彩。

當應用程式的視窗有焦點且呼叫 RealizePalette 函式時，系統會嘗試盡可能實現所要求的色彩數目。對於具有非作用中視窗的應用程式，也是如此。


最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	wingdi.h (包含 Windows.h)
程式庫	Gdi32.lib
Dll	Gdi32.dll