Platform SDK: DirectX

DirectDrawSurface7.SetColorKey

DirectDrawSurface7.SetColorKey メソッドは、ハードウェアがサーフェス基準ごとにカラー キーをサポートする場合、DirectDrawSurface オブジェクトに対するカラー キー値を設定する。

object.SetColorKey( _ 
    flags As CONST_DDCKEYFLAGS, _ 
    val As DDCOLORKEY)

パラメータ

object
DirectDrawSurface7 オブジェクトを表すオブジェクト式。
flags
要求されるカラー キーのタイプを指定する CONST_DDCKEYFLAGS 列挙の定数の 1 つ。
val
DirectDrawSurface オブジェクトに対して新しいカラー キー値を含む DDCOLORKEY 型。前もって設定したカラー キーを削除するには、この値を Nothing にする。

エラー コード

失敗すればエラーが発生し、Err.Number に次のいずれかの値が設定される。

DDERR_GENERIC
DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS
DDERR_INVALIDSURFACETYPE
DDERR_NOOVERLAYHW
DDERR_NOTAOVERLAYSURFACE
DDERR_SURFACELOST
DDERR_UNSUPPORTED
DDERR_WASSTILLDRAWING

注意

透過型ブリットとオーバーレイに対して、転送先サーフェスの転送先の色と転送元サーフェスの転送元の色を設定しなくてはならない。

参照

DirectDrawSurface7.GetColorKey