unrealizeObject 函式 (wingdi.h)

發行項
03/13/2024

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)
程式庫	Gdi32.lib
Dll	Gdi32.dll