Compartilhar via

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

  • Artigo

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