Platform SDK: DirectX

DirectDrawSurface7.SetClipper

DirectDrawSurface7.SetClipper メソッドは、サーフェスにクリッパー オブジェクトをアタッチしたり、サーフェスからクリッパー オブジェクトを削除する。

object.SetClipper(val As DirectDrawClipper)

パラメータ

object
DirectDrawSurface7 オブジェクトを表すオブジェクト式。
val
DirectDrawSurface オブジェクトにアタッチされる DirectDrawClipper オブジェクトに対する DirectDrawClipper オブジェクト。このパラメータが Nothing の場合、現在の DirectDrawClipper オブジェクトはアタッチを解除される。

エラー コード

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

DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS
DDERR_INVALIDSURFACETYPE
DDERR_NOCLIPPERATTACHED

注意

val パラメータとして Nothing を渡す場合、サーフェスからクリッパーが削除される。このメソッドは、プライマリ サーフェスにオーバーレイされるか、ブリットされるサーフェスにより主に使用される。ただし、このメソッドは、どのサーフェス上でも使用できる。DirectDrawClipper オブジェクトがアタッチされて、クリップ リストがそれに関連付けられると、DirectDrawClipper オブジェクトは親の DirectDrawSurface オブジェクトを含む DirectDrawSurface7.Blt 処理で使用される。このメソッドは、DirectDrawSurface オブジェクトの現在の DirectDrawClipper オブジェクトにおけるアタッチも解除できる。

参照

DirectDrawSurface7.GetClipper