Metodo IDirectDrawSurface7::SetColorKey (ddraw.h)
Imposta il valore della chiave di colore per l'oggetto DirectDrawSurface se l'hardware supporta chiavi di colore in base alla superficie.
Sintassi
HRESULT SetColorKey(
[in] DWORD unnamedParam1,
[in] LPDDCOLORKEY unnamedParam2
);
Parametri
[in] unnamedParam1
Valore che può essere impostato su uno dei flag seguenti per specificare la chiave di colore richiesta:
DDCKEY_COLORSPACE
La struttura contiene uno spazio colore. Non impostato se la struttura contiene una singola chiave di colore.
DDCKEY_DESTBLT
Chiave di colore o spazio colore da usare come chiave di colore di destinazione per operazioni di trasferimento a blocchi di bit (bitblt).
DDCKEY_DESTOVERLAY
Chiave di colore o spazio colore da usare come chiave di colore di destinazione per le operazioni di sovrapposizione.
DDCKEY_SRCBLT
Chiave di colore o spazio colore da usare come chiave di colore di origine per le operazioni bitblt.
DDCKEY_SRCOVERLAY
Chiave di colore o spazio colore da usare come chiave di colore di origine per le operazioni di sovrapposizione.
[in] unnamedParam2
Puntatore a una struttura DDCOLORKEY contenente i nuovi valori di chiave di colore per l'oggetto DirectDrawSurface. Questo valore può essere NULL per rimuovere una chiave di colore impostata in precedenza.
Valore restituito
Se il metodo ha esito positivo, il valore restituito è DD_OK.
Se ha esito negativo, il metodo può restituire uno dei valori di errore seguenti:
- DDERR_GENERIC
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
- DDERR_INVALIDSURFACETYPE
- DDERR_NOOVERLAYHW
- DDERR_NOTAOVERLAYSURFACE
- DDERR_SURFACELOST
- DDERR_UNSUPPORTED
- DDERR_WASSTILLDRAWING
Commenti
Per operazioni e sovrapposizioni bitblt trasparenti, impostare il colore di destinazione sulla superficie di destinazione e sul colore di origine nell'area di origine.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | ddraw.h |
| Libreria | Ddraw.lib |
| DLL | Ddraw.dll |