DirectX SDK

DirectDrawClipper.SetClipList

The DirectDrawClipper.SetClipList method sets or deletes the clip list used by the DirectDrawSurface7.Blt method on surfaces to which the parent DirectDrawClipper object is attached.

object.SetClipList( _ 
    count As Long, _ 
    rects() as RECT)

Parameters

object
Object expression that resolves to a DirectDrawClipper object.
count
Number of RECT types in the rects( ) array.
rects()
Array of RECT types that describe the clip list.

Error Codes

If the method fails, it raises an error, and Err.Number can be set to one of the following values:

DDERR_CLIPPERISUSINGHWND
DDERR_INVALIDCLIPLIST
DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS
DDERR_OUTOFMEMORY

Remarks

The clip list cannot be set if a window handle is already associated with the DirectDrawClipper object. The DirectDrawSurface7.BltFast method cannot clip.

See Also

DirectDrawClipper.GetClipList, DirectDrawSurface7.Blt, DirectDrawSurface7.BltFast