Функция UpdateColors (wingdi.h)
Функция UpdateColors обновляет клиентную область указанного контекста устройства, переназначая текущие цвета в клиентской области с текущей реализованной логической палитрой.
Синтаксис
BOOL UpdateColors(
[in] HDC hdc
);
Параметры
[in] hdc
Дескриптор контекста устройства.
Возвращаемое значение
Если функция выполняется успешно, возвращается ненулевое значение.
Если функция выполняется неудачно, возвращается нулевое значение.
Комментарии
Приложение может определить, поддерживает ли устройство операции палитры, вызвав функцию GetDeviceCaps и указав константу RASTERCAPS.
Неактивное окно с реализованной логической палитрой может вызывать UpdateColors в качестве альтернативы перерисовке клиентской области при изменении системной палитры.
Функция UpdateColors обычно обновляет клиентную область быстрее, чем перерисовка области. Однако, поскольку UpdateColors выполняет преобразование цвета на основе цвета каждого пикселя до изменения системной палитры, каждый вызов этой функции приводит к потере некоторой точности цвета.
Эта функция должна вызываться вскоре после получения WM_PALETTECHANGED сообщения.
Требования
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | wingdi.h (включая Windows.h) |
| Библиотека | Gdi32.lib |
| DLL | Gdi32.dll |