描述
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:不支持自动跟踪画笔原点。在使用它之前,应用程序必须使用UnrealizeObject,SetBrushOrgEx和SelectObject函数对齐画笔。
Windows 2000 / XP / Vista / Windows 7:如果hgdiobj是一个画笔,UnrealizeObject什么也不做,该函数返回TRUE。使用SetBrushOrgEx设置画笔的原点。
引用文件 #INCLUDE Once
WinGdi.inc(包括Windows.inc)