Méthode IDirectDrawSurface7 ::SetColorKey (ddraw.h)
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.
HRESULT SetColorKey(
[in] DWORD unnamedParam1,
[in] LPDDCOLORKEY unnamedParam2
);
[in] unnamedParam1
Valeur qui peut être définie sur l’un des indicateurs suivants pour spécifier la clé de couleur demandée :
La structure contient un espace de couleurs. Non défini si la structure contient une seule clé de couleur.
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).
Clé de couleur ou espace de couleur à utiliser comme clé de couleur de destination pour les opérations de superposition.
Clé de couleur ou espace de couleur à utiliser comme clé de couleur source pour les opérations bitblt.
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.
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
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.
Condition requise | Valeur |
---|---|
Plateforme cible | Windows |
En-tête | ddraw.h |
Bibliothèque | Ddraw.lib |
DLL | Ddraw.dll |