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

UnrealizeObject

Previous pageReturn to chapter overviewNext page

描述

 

UnrealizeObject功能重置画笔的原点或复位逻辑调色板。如果hgdiobj参数是画笔的句柄,UnrealizeObject将指示系统在下次选择画笔时重置画笔的原点。如果hgdiobj参数是逻辑调色板的句柄,UnrealizeObject指示系统实现调色板,就好像以前没有实现。下一次应用程序调用指定调色板的RealizePalette函数时,系统会将逻辑调色板完全重新映射到系统调色板。

 

C++ 语法

 

BOOL UnrealizeObject(

__in HGDIOBJ hgdiobj

);

 

PowerBASIC 语法

 

FUNCTION UnrealizeObject ( _

BYVAL hgdiobj AS DWORD _

) AS LONG

 

参数

 

hgdiobj

 

[in]处理逻辑调色板以重置。

 

返回值

 

如果函数成功,返回值不为零。

 

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

 

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

 

备注

 

UnrealizeObject功能不应与库存对象一起使用。例如,通过调用GetStockObject(DEFAULT_PALETTE)获取的默认调色板是库存对象。

 

hgdiobj标识的调色板可以是设备上下文当前选择的调色板。

 

Windows 95/98 / Me:不支持自动跟踪画笔原点。在使用它之前,应用程序必须使用UnrealizeObjectSetBrushOrgExSelectObject函数对齐画笔。

 

Windows 2000 / XP / Vista / Windows 7:如果hgdiobj是一个画笔,UnrealizeObject什么也不做,该函数返回TRUE。使用SetBrushOrgEx设置画笔的原点。

 

引用文件 #INCLUDE Once

 

WinGdi.inc(包括Windows.inc)