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

Consulte también

IDirectDrawSurface7