勇芳软件工作室.汉化:  Colors > Color Functions >

RealizePalette

Previous pageReturn to chapter overviewNext page

描述

 

RealizePalette函数将调色板条目从当前逻辑调色板映射到系统调色板。

 

C++ 语法

 

UINT RealizePalette(

__in HDC hdc

);

 

PowerBASIC 语法

 

FUNCTION RealizePalette ( _

BYVAL hdc AS DWORD _

) AS DWORD

 

参数

 

hdc

 

[in]处理已选择逻辑调色板的设备上下文。

 

返回值

 

如果函数成功,则返回值是映射到系统调色板的逻辑调色板中的条目数。

 

如果函数失败,返回值为GDI_ERROR。

 

Windows NT / 2000 / XP / Vista / Windows 7:要获取扩展的错误信息,请调用GetLastError.

 

备注

 

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

 

RealizePalette功能修改与指定设备上下文关联的设备的调色板。如果设备上下文是存储器DC,则修改选择到DC中的位图的颜色表。如果设备上下文是显示器DC,则该设备的物理调色板将被修改。

 

逻辑调色板是色彩密集型应用程序和系统之间的缓冲区,允许这些应用程序使用所需的颜色,而不会影响其他窗口显示的颜色。

 

当应用程序的窗口具有焦点并调用RealizePalette功能时,系统会尝试尽可能多地实现所请求的颜色。对于具有非活动窗口的应用程序也是如此。

 

引用文件 #INCLUDE Once

 

WinGdi.inc(包括Windows.inc)