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
指向包含 DirectDrawSurface 对象的新颜色键值的 DDCOLORKEY 结构的指针。 此值可以为 NULL，以删除以前设置的颜色键。
返回值
如果该方法成功，则返回值DD_OK。
如果失败，该方法可能会返回以下错误值之一：
- DDERR_GENERIC
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
- DDERR_INVALIDSURFACETYPE
- DDERR_NOOVERLAYHW
- DDERR_NOTAOVERLAYSURFACE
- DDERR_SURFACELOST
- DDERR_UNSUPPORTED
- DDERR_WASSTILLDRAWING
注解
对于透明 bitblt 操作和覆盖，请在目标图面上设置目标颜色，在源图面上设置源颜色。
要求
| 要求 | 值 |
|---|---|
| 目标平台 | Windows |
| 标头 | ddraw.h |
| Library | Ddraw.lib |
| DLL | Ddraw.dll |