Platform SDK: DirectX |
DirectDrawSurface7.SetClipper メソッドは、サーフェスにクリッパー オブジェクトをアタッチしたり、サーフェスからクリッパー オブジェクトを削除する。
object.SetClipper(val As DirectDrawClipper)
失敗すればエラーが発生し、Err.Number に次のいずれかの値が設定される。
DDERR_INVALIDOBJECT |
DDERR_INVALIDPARAMS |
DDERR_INVALIDSURFACETYPE |
DDERR_NOCLIPPERATTACHED |
val パラメータとして Nothing を渡す場合、サーフェスからクリッパーが削除される。このメソッドは、プライマリ サーフェスにオーバーレイされるか、ブリットされるサーフェスにより主に使用される。ただし、このメソッドは、どのサーフェス上でも使用できる。DirectDrawClipper オブジェクトがアタッチされて、クリップ リストがそれに関連付けられると、DirectDrawClipper オブジェクトは親の DirectDrawSurface オブジェクトを含む DirectDrawSurface7.Blt 処理で使用される。このメソッドは、DirectDrawSurface オブジェクトの現在の DirectDrawClipper オブジェクトにおけるアタッチも解除できる。