unrealizeObject 函数 (wingdi.h)

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

语法

BOOL UnrealizeObject(
       HGDIOBJ h
);

参数

h

返回值

如果该函数成功,则返回值为非零值。

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

注解

UnrealizeObject 函数不应与常用对象一起使用。 例如,通过调用 GetStockObject (DEFAULT_PALETTE) 获取的默认调色板是一个常用对象。

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

如果 hgdiobj 是画笔, UnrealizeObject 不执行任何操作,并且函数返回 TRUE。 使用 SetBrushOrgEx 设置画笔的原点。

要求

要求
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 wingdi.h (包括 Windows.h)
Library Gdi32.lib
DLL Gdi32.dll

另请参阅

颜色函数

颜色概述

GetStockObject

RealizePalette

SetBrushOrgEx