IDirectDrawSurface7::SetColorKey-Methode (ddraw.h)
Legt den Wert des Farbschlüssels für das DirectDrawSurface-Objekt fest, wenn die Hardware Farbtasten pro Oberfläche unterstützt.
Syntax
HRESULT SetColorKey(
[in] DWORD unnamedParam1,
[in] LPDDCOLORKEY unnamedParam2
);
Parameter
[in] unnamedParam1
Ein Wert, der auf eines der folgenden Flags festgelegt werden kann, um den angeforderten Farbschlüssel anzugeben:
DDCKEY_COLORSPACE
Die Struktur enthält einen Farbraum. Nicht festgelegt, wenn die Struktur einen einzelnen Farbschlüssel enthält.
DDCKEY_DESTBLT
Ein Farbschlüssel oder Farbraum, der als Zielfarbschlüssel für Bitblockübertragungsvorgänge (Bitblt) verwendet werden soll.
DDCKEY_DESTOVERLAY
Eine Farbtaste oder ein Farbraum, der als Zielfarbschlüssel für Überlagerungsvorgänge verwendet werden soll.
DDCKEY_SRCBLT
Ein Farbschlüssel oder Farbraum, der als Quellfarbschlüssel für Bitblt-Vorgänge verwendet werden soll.
DDCKEY_SRCOVERLAY
Eine Farbtaste oder ein Farbraum, der als Quellfarbschlüssel für Überlagerungsvorgänge verwendet werden soll.
[in] unnamedParam2
Ein Zeiger auf eine DDCOLORKEY-Struktur , die die neuen Farbschlüsselwerte für das DirectDrawSurface-Objekt enthält. Dieser Wert kann NULL sein, um einen zuvor festgelegten Farbschlüssel zu entfernen.
Rückgabewert
Wenn die Methode erfolgreich ist, wird der Rückgabewert DD_OK.
Wenn ein Fehler auftritt, kann die Methode einen der folgenden Fehlerwerte zurückgeben:
- DDERR_GENERIC
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
- DDERR_INVALIDSURFACETYPE
- DDERR_NOOVERLAYHW
- DDERR_NOTAOVERLAYSURFACE
- DDERR_SURFACELOST
- DDERR_UNSUPPORTED
- DDERR_WASSTILLDRAWING
Hinweise
Legen Sie für transparente Bitbltvorgänge und -überlagerungen die Zielfarbe auf der Zieloberfläche und die Quellfarbe auf der Quelloberfläche fest.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | ddraw.h |
| Bibliothek | Ddraw.lib |
| DLL | Ddraw.dll |