Функция UnrealizeObject

Функция UnrealizeObject возвращает в исходное положение начало координат кисти или возвращает в исходное положение логическую палитру. Если параметр hgdiobj - дескриптор кисти, UnrealizeObject предписывает системе возвратить в исходное положение начало координат кисти в следующий раз, когда она будет выбрана. Если параметр hgdiobj - дескриптор логической палитры, UnrealizeObject предписывает системе реализовать палитру, как если бы раньше она не была реализована. В следующий раз, когда приложение вызывает функцию RealizePalette для указанной палитры, система полностью повторно отображает логическую палитру в системной палитре.

Синтаксис

Параметры

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, чтобы установить начало координат кисти.

Смотри также