SelectPalette

【勇芳软件工作室】汉化HomePreviousNext

SelectPalette功能将指定的逻辑调色板选择到设备上下文中。

HPALETTE SelectPalette(

HDC 【HDC】,//设备上下文的句柄
HPALETTE 【HPAL】,//逻辑调色板的句柄
BOOL 【bForceBackground】//前景/背景模式
); 

参数

【HDC】

标识设备上下文。

【HPAL】

标识要选择的逻辑调色板。

【bForceBackground】

指定逻辑调色板是否被强制为背景调色板。如果此值为TRUE,则RealizePalette功能会使逻辑调色板以最佳方式映射到物理调色板中已经存在的颜色。这总是完成,即使实现调色板的窗口属于没有主动对焦的线程。

如果此值为FALSE,则当应用程序处于前台时,RealizePalette将使逻辑调色板复制到设备调色板中。(如果【HDC】参数是内存设备上下文,则忽略该参数。)

返回值

如果函数成功,则返回值标识设备上下文的上一个逻辑调色板。

如果函数失败,返回值为NULL。要获取扩展错误信息,请调用GetLastError.

备注

应用程序可以通过调用GetDeviceCaps函数并指定RASTERCAPS常数来确定设备是否支持调色板操作。

应用程序可以将逻辑调色板选择到多个设备上下文中。但是,对逻辑调色板的更改将影响所选择的所有设备上下文。

如果顶级窗口的子窗口各自实现自己的调色板,则应用程序可能会调用SelectPalette函数,将【bForceBackground】参数设置为TRUE。但是,只有需要实现其调色板的子窗口必须将【bForceBackground】设置为TRUE;其他子窗口必须将此值设置为FALSE。

也可以看看

CreatePalette, GetDeviceCaps, RealizePalette