Метод IDirectDrawSurface7::SetColorKey (ddraw.h)
Задает значение ключа цвета для объекта DirectDrawSurface, если оборудование поддерживает цветовые клавиши для каждой поверхности.
Синтаксис
HRESULT SetColorKey(
[in] DWORD unnamedParam1,
[in] LPDDCOLORKEY unnamedParam2
);
Параметры
[in] unnamedParam1
Значение, которое можно задать для одного из следующих флагов, чтобы указать запрошенный цветной ключ:
DDCKEY_COLORSPACE
Структура содержит цветовое пространство. Не задано, если структура содержит один цветной ключ.
DDCKEY_DESTBLT
Цветовой ключ или цветовое пространство, которое будет использоваться в качестве ключа цвета назначения для операций передачи битовых блоков (bitblt).
DDCKEY_DESTOVERLAY
Цветовая клавиша или цветовое пространство, используемое в качестве ключа цвета назначения для операций наложения.
DDCKEY_SRCBLT
Цветовая клавиша или цветовое пространство, используемое в качестве исходного ключа цвета для операций bitblt.
DDCKEY_SRCOVERLAY
Цветовой ключ или цветовое пространство, используемое в качестве исходного ключа цвета для операций наложения.
[in] unnamedParam2
Указатель на структуру DDCOLORKEY , содержащую новые значения ключа цвета для объекта DirectDrawSurface. Это значение может иметь значение NULL, чтобы удалить ранее заданный цветной ключ.
Возвращаемое значение
Если метод выполнен успешно, возвращаемое значение будет DD_OK.
В случае сбоя метод может вернуть одно из следующих значений ошибки:
- DDERR_GENERIC
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
- DDERR_INVALIDSURFACETYPE
- DDERR_NOOVERLAYHW
- DDERR_NOTAOVERLAYSURFACE
- DDERR_SURFACELOST
- DDERR_UNSUPPORTED
- DDERR_WASSTILLDRAWING
Комментарии
Для прозрачных операций bitblt и наложения задайте цвет назначения на целевой поверхности и исходный цвет на исходной поверхности.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | ddraw.h |
| Библиотека | Ddraw.lib |
| DLL | Ddraw.dll |