Функция RealizePalette (wingdi.h)

Статья
08/27/2023

Функция RealizePalette сопоставляет элементы палитры из текущей логической палитры с системной палитрой.

Синтаксис

UINT RealizePalette(
  [in] HDC hdc
);

Параметры

[in] hdc

Дескриптор контекста устройства, в котором была выбрана логическая палитра.

Возвращаемое значение

Если функция выполняется успешно, возвращаемое значение — это количество записей в логической палитре, сопоставленных с системной палитрой.

Если функция завершается сбоем, возвращаемое значение будет GDI_ERROR.

Функция RealizePalette изменяет палитру для устройства, связанного с указанным контекстом устройства. Если контекст устройства является контроллером домена памяти, таблица цветов для растрового рисунка, выбранного в контроллере домена, изменяется. Если контекст устройства является дисплеем контроллера домена, физическая палитра для этого устройства изменяется.

Логическая палитра — это буфер между ресурсоемкими приложениями и системой, что позволяет этим приложениям использовать столько цветов, сколько требуется, не мешая цветам, отображаемым другими окнами.

Когда окно приложения находится в фокусе и вызывает функцию RealizePalette , система пытается реализовать как можно больше запрошенных цветов. То же самое относится и к приложениям с неактивными окнами.

Требования


Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	wingdi.h (включая Windows.h)
Библиотека	Gdi32.lib
DLL	Gdi32.dll