Функция UnrealizeObject возвращает в исходное положение начало координат кисти или возвращает в исходное положение логическую палитру. Если параметр hgdiobj - дескриптор кисти, UnrealizeObject предписывает системе возвратить в исходное положение начало координат кисти в следующий раз, когда она будет выбрана. Если параметр hgdiobj - дескриптор логической палитры, UnrealizeObject предписывает системе реализовать палитру, как если бы раньше она не была реализована. В следующий раз, когда приложение вызывает функцию RealizePalette для указанной палитры, система полностью повторно отображает логическую палитру в системной палитре.
Синтаксис
BOOL UnrealizeObject( HGDIOBJ hgdiobj // дескриптор логической палитры ); |
hgdiobj
[in] Дескриптор логической палитры, которая будет возвращена в исходное положение.
Если функция завершается успешно, возвращаемое значение - не нуль.
Если функция завершается ошибкой, возвращаемое значение - нуль.
Windows NT/2000/XP: Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.
Функция UnrealizeObject не должна использоваться со стандартными объектами. Например, палитра по умолчанию, полученная при помощи вызова GetStockObject (DEFAULT_PALETTE), является стандартным объектом.
Палитра, идентифицированная параметром hgdiobj может быть в текущий момент выбранной палитрой контекста устройства.
Windows 95/98/Me: Автоматическое слежение за началом координат кисти не поддерживается. Приложения должны использовать функции UnrealizeObject, SetBrushOrgEx и SelectObject, чтобы выровнять кисть перед ее использованием.
Windows 2000/XP: Если параметр hgdiobj определяет кисть, то функция UnrealizeObject ничего не делает и возвращает значение ИСТИНА (TRUE). Используйте функцию SetBrushOrgEx, чтобы установить начало координат кисти.
Обзор Цвета, Функции, используемые цветом, GetStockObject, RealizePalette, SetBrushOrgEx
Размещение и совместимость UnrealizeObject |
||
К | Windows XP | Да |
л | Windows 2000 Professional | Да |
и | Windows NT Workstation | Да версии 3.1 и выше |
е | Windows Me | Да |
н | Windows 98 | Да |
т | Windows 95 | Да |
С | Windows Server 2003 | Да |
е | Windows 2000 Server | Да |
р | Windows NT Server | Да |
в | ||
е | ||
р | ||
Используемая библиотека | Gdi32.lib | |
Используемая DLL | - | |
Заголовочный файл | ||
- объявлено в | Wingdi.h | |
- включено в | Windows.h | |
Unicode | Нет | |
Замечания по платформе | Не имеется |