Método IDirectDrawSurface7::SetColorKey (ddraw.h)

Define o valor da chave de cor para o objeto DirectDrawSurface se o hardware der suporte a chaves de cor por superfície.

Sintaxe

HRESULT SetColorKey(
  [in] DWORD        unnamedParam1,
  [in] LPDDCOLORKEY unnamedParam2
);

Parâmetros

[in] unnamedParam1

Um valor que pode ser definido como um dos seguintes sinalizadores para especificar a chave de cor solicitada:

DDCKEY_COLORSPACE

A estrutura contém um espaço de cor. Não definido se a estrutura contiver uma única chave de cor.

DDCKEY_DESTBLT

Uma chave de cor ou espaço de cor a ser usado como uma chave de cor de destino para operações de transferência de bloco de bits (bitblt).

DDCKEY_DESTOVERLAY

Uma chave de cor ou espaço de cor a ser usado como uma chave de cor de destino para operações de sobreposição.

DDCKEY_SRCBLT

Uma chave de cor ou espaço de cor a ser usado como uma chave de cor de origem para operações bitblt.

DDCKEY_SRCOVERLAY

Uma chave de cor ou espaço de cor a ser usado como uma chave de cor de origem para operações de sobreposição.

[in] unnamedParam2

Um ponteiro para uma estrutura DDCOLORKEY que contém os novos valores de chave de cor para o objeto DirectDrawSurface. Esse valor pode ser NULL para remover uma chave de cor definida anteriormente.

Retornar valor

Se o método for bem-sucedido, o valor retornado será DD_OK.

Se falhar, o método poderá retornar um dos seguintes valores de erro:

• DDERR_GENERIC
• DDERR_INVALIDOBJECT
• DDERR_INVALIDPARAMS
• DDERR_INVALIDSURFACETYPE
• DDERR_NOOVERLAYHW
• DDERR_NOTAOVERLAYSURFACE
• DDERR_SURFACELOST
• DDERR_UNSUPPORTED
• DDERR_WASSTILLDRAWING

Comentários

Para operações e sobreposições de bitblt transparentes, defina a cor de destino na superfície de destino e a cor da origem na superfície de origem.

Requisitos

Requisito	Valor
Plataforma de Destino	Windows
Cabeçalho	ddraw.h
Biblioteca	Ddraw.lib
DLL	Ddraw.dll

Confira também

IDirectDrawSurface7