Русский справочник по Win32 API
Шрифт:
Возвращаемые значения
В случае успеха возвращается количество вхождений, извлеченных из палитры.
В случае неудачи возвращается нуль.
Windows NT/2000/XP: Для получения дополнительной информации об ошибке вызовите функцию GetLastError.
Комментарии
Приложение может определить, поддерживает ли устройство операции с палитрой, вызвав функцию GetDeviceCaps
Требования
Windows NT/2000/XP: Включена в Windows NT 3.1 и выше.
Windows 95/98/Me: Включена в Windows 95 и выше.
Заголовок: Объявлена в Wingdi.h; подключатьWindows.h.
Библиотека: Используйте Gdi32.lib.
См. также
GetDeviceCaps, GetPaletteEntries, PALETTEENTRY.
ResizePalette
Функция ResizePalette увеличивает или уменьшает размер логической палитры, основываясь на указанном значении.
BOOL ResizePalette (
HPALETTE hpal , // дескриптор логической палитры
UINT nEntries // число вхождений в логическую палитру
);
Параметры
hpal– идентифицирует изменяемую логическую палитру.
nEntries– определяет число вхождений в палитру после изменения ее размера.
Возвращаемые значения
В случае успеха возвращается ненулевое значение.
В случае неудачи возвращается нуль. Для получения дополнительной информации об ошибке вызовите функцию GetLastError .
Комментарии
Приложение может определить, поддерживает ли устройство операции с палитрой, вызвав функцию GetDeviceCaps с параметром RASTERCAPS .
Если приложение вызывает ResizePalette для уменьшения размера палитры, вхождения, оставшиеся в измененной палитре, не изменяются. Если приложение вызывает ResizePalette для увеличения размера палитры, то новым вхождениям в палитру присваивается черный цвет и их флаги устанавливаются в нуль.
См. также
GetDeviceCaps .
UpdateColors
Функция UpdateColors
BOOL UpdateColors (
HDC hdc // дескриптор контекста устройства
);
Параметры
hdc– идентифицирует контекст устройства.
Возвращаемые значения
В случае успеха возвращается ненулевое значение.
В случае неудачи возвращается нуль. Для получения дополнительной информации вызовите функцию GetLastError .
Комментарии
Приложение может определить, поддерживает ли устройство операции с палитрой, вызвав функцию GetDeviceCaps с параметром RASTERCAPS .
Неактивное окно с реализованной логической палитрой может вызвать функцию UpdateColors в качестве альтернативы перерисовке его клиентской области при смене системной палитры.
Функция UpdateColors обычно обновляет клиентскую область быстрее, чем перерисовка данной области. Тем не менее, поскольку UpdateColors выполняет преобразование цвета, основанное на цвете каждого пикселя перед изменением системной палитры, вызов этой функции приводит к потере цветовой точности.
Функция должна вызываться сразу после получения приложением сообщения WM _ PALETTECHANGED .
См. также
GetDeviceCaps, RealizePalette .
Атомы
Функции
AddAtom
Функция AddAtom добавляет строку символов в таблицу локальных атомов и возвращает уникальное значение (атом), идентифицирующее строку.
ATOM AddAtom (
LPCTSTR lpString // указатель на добавляемую строку
);
Параметры
lpString– указатель на добавляемую строку, завершающуюся нулем. Строка может иметь максимальный размер в 255 байт. Строки, отличающиеся только регистром, считаются идентичными.
Возвращаемые значения