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.
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 |