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

  • Article

Définit la valeur de clé de couleur de l’objet DirectDrawSurface si le matériel prend en charge les clés de couleur par surface.

Syntaxe

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

Paramètres

[in] unnamedParam1

Valeur qui peut être définie sur l’un des indicateurs suivants pour spécifier la clé de couleur demandée :

DDCKEY_COLORSPACE

La structure contient un espace de couleurs. Non défini si la structure contient une seule clé de couleur.

DDCKEY_DESTBLT

Clé de couleur ou espace de couleur à utiliser comme clé de couleur de destination pour les opérations de transfert de bloc de bits (bitblt).

DDCKEY_DESTOVERLAY

Clé de couleur ou espace de couleur à utiliser comme clé de couleur de destination pour les opérations de superposition.

DDCKEY_SRCBLT

Clé de couleur ou espace de couleur à utiliser comme clé de couleur source pour les opérations bitblt.

DDCKEY_SRCOVERLAY

Clé de couleur ou espace de couleur à utiliser comme clé de couleur source pour les opérations de superposition.

[in] unnamedParam2

Pointeur vers une structure DDCOLORKEY qui contient les nouvelles valeurs de clé de couleur pour l’objet DirectDrawSurface. Cette valeur peut être NULL pour supprimer une clé de couleur précédemment définie.

Valeur retournée

Si la méthode réussit, la valeur de retour est DD_OK.

En cas d’échec, la méthode peut retourner l’une des valeurs d’erreur suivantes :

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

Remarques

Pour les opérations de bitblt transparentes et les superpositions, définissez la couleur de destination sur la surface de destination et la couleur source sur la surface source.

Configuration requise

Condition requise Valeur
Plateforme cible Windows
En-tête ddraw.h
Bibliothèque Ddraw.lib
DLL Ddraw.dll

Voir aussi

IDirectDrawSurface7