Функция UnrealizeObject

Функция 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 Нет
 Замечания по платформе Не имеется

 

Назад в оглавление
На главную страницу
В оглавление справки

Hosted by uCoz