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

Статья
08/27/2023

Функция SelectPalette выбирает указанную логическую палитру в контексте устройства.

Синтаксис

HPALETTE SelectPalette(
  [in] HDC      hdc,
  [in] HPALETTE hPal,
  [in] BOOL     bForceBkgd
);

Параметры

[in] hdc

Дескриптор контекста устройства.

[in] hPal

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

[in] bForceBkgd

Указывает, является ли логическая палитра фоновой. Если это значение равно TRUE, функция RealizePalette наилучшим образом сопоставляет логическую палитру с цветами, уже имеющимися в физической палитре. Это делается всегда, даже если окно, для которого реализована палитра, принадлежит потоку без активного фокуса.

Если это значение равно FALSE, функция RealizePalette будет копировать логическую палитру в палитру устройств, когда приложение находится на переднем плане. (Если параметр hdc является контекстом устройства памяти, этот параметр игнорируется.)

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

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

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

Приложение может выбрать логическую палитру в несколько контекстов устройства, только если контексты устройства совместимы. В противном случае selectPalette завершается ошибкой . Чтобы создать контекст устройства, совместимый с другим контекстом устройства, вызовите CreateCompatibleDC с первым контекстом устройства в качестве параметра . Если логическая палитра выбрана в нескольких контекстах устройств, изменения в логической палитре повлияют на все контексты устройств, для которых она выбрана.

Приложение может вызывать функцию SelectPalette с параметром bForceBackground , имеющим значение TRUE , если дочерние окна окна верхнего уровня реализуют собственные палитры. Однако только дочернее окно, которое должно реализовать свою палитру, должно задать для bForceBackground значение TRUE; другие дочерние окна должны задать для этого значения значение FALSE.

Требования

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