Функция SelectPalette (wingdi.h)
Функция SelectPalette выбирает указанную логическую палитру в контексте устройства.
Синтаксис
HPALETTE SelectPalette(
[in] HDC hdc,
[in] HPALETTE hPal,
[in] BOOL bForceBkgd
);
Параметры
[in] hdc
Дескриптор контекста устройства.
[in] hPal
Дескриптор выбранной логической палитры.
[in] bForceBkgd
Указывает, является ли логическая палитра фоновой. Если это значение равно TRUE, функция RealizePalette наилучшим образом сопоставляет логическую палитру с цветами, уже имеющимися в физической палитре. Это делается всегда, даже если окно, для которого реализована палитра, принадлежит потоку без активного фокуса.
Если это значение равно FALSE, функция RealizePalette будет копировать логическую палитру в палитру устройств, когда приложение находится на переднем плане. (Если параметр hdc является контекстом устройства памяти, этот параметр игнорируется.)
Возвращаемое значение
Если функция выполняется успешно, возвращаемое значение является дескриптором предыдущей логической палитры контекста устройства.
Если функция завершается сбоем, возвращается значение NULL.
Комментарии
Приложение может определить, поддерживает ли устройство операции палитры, вызвав функцию GetDeviceCaps и указав константу RASTERCAPS.
Приложение может выбрать логическую палитру в несколько контекстов устройства, только если контексты устройства совместимы. В противном случае 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 |