Método IDirectDrawSurface7::SetColorKey (ddraw.h)
Establece el valor de clave de color del objeto DirectDrawSurface si el hardware admite teclas de color por superficie.
Sintaxis
HRESULT SetColorKey(
[in] DWORD unnamedParam1,
[in] LPDDCOLORKEY unnamedParam2
);
Parámetros
[in] unnamedParam1
Valor que se puede establecer en una de las marcas siguientes para especificar la clave de color solicitada:
DDCKEY_COLORSPACE
La estructura contiene un espacio de colores. No se establece si la estructura contiene una sola clave de color.
DDCKEY_DESTBLT
Clave de color o espacio de color que se usará como clave de color de destino para las operaciones de transferencia de bloques de bits (bitblt).
DDCKEY_DESTOVERLAY
Clave de color o espacio de color que se usará como clave de color de destino para las operaciones de superposición.
DDCKEY_SRCBLT
Clave de color o espacio de color que se usará como clave de color de origen para las operaciones bitblt.
DDCKEY_SRCOVERLAY
Clave de color o espacio de color que se usará como clave de color de origen para las operaciones de superposición.
[in] unnamedParam2
Puntero a una estructura DDCOLORKEY que contiene los nuevos valores de clave de color para el objeto DirectDrawSurface. Este valor puede ser NULL para quitar una clave de color establecida previamente.
Valor devuelto
Si el método se realiza correctamente, el valor devuelto es DD_OK.
Si se produce un error, el método puede devolver uno de los siguientes valores de error:
- DDERR_GENERIC
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
- DDERR_INVALIDSURFACETYPE
- DDERR_NOOVERLAYHW
- DDERR_NOTAOVERLAYSURFACE
- DDERR_SURFACELOST
- DDERR_UNSUPPORTED
- DDERR_WASSTILLDRAWING
Comentarios
Para operaciones y superposiciones bitblt transparentes, establezca el color de destino en la superficie de destino y el color de origen en la superficie de origen.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | ddraw.h |
| Library | Ddraw.lib |
| Archivo DLL | Ddraw.dll |