Microsoft SDK for Java

setClipper

This method of the DirectDrawSurface Class attaches a DirectDrawClipper object to a DirectDrawSurface object.

Syntax

public void setClipper(DirectDrawClipper val);

Parameters

val The DirectDrawClipper object that will be attached to the DirectDrawSurface object. If this parameter is null, the current DirectDrawClipper object will be detached.

Remarks

This method is primarily used by surfaces that are being overlaid on or blitted to the primary surface. However, it can be used on any surface. After a DirectDrawClipper object has been attached and a clip list is associated with it, the DirectDrawClipper object will be used for the blt and updateOverlay operations involving the parent DirectDrawSurface object. This method can also detach a DirectDrawSurface object's current DirectDrawClipper object.

If this method is called several times consecutively on the same surface for the same DirectDrawClipper object, the reference count for the object is incremented only once. Subsequent calls do not affect the object's reference count.

See Also

getClipper

© 1999 Microsoft Corporation. All rights reserved. Terms of use.