ilog.views.util.swing

Class IlvAbstractRepaintManager

java.lang.Object

javax.swing.RepaintManager

ilog.views.util.swing.IlvAbstractRepaintManager

Direct Known Subclasses:

IlvExpensiveDrawingRepaintManager

public abstract class IlvAbstractRepaintManager
extends RepaintManager

This class is an abstract RepaintManager whose behavior can be customized in subclasses.

Since:

JViews 8.6

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	IlvAbstractRepaintManager() Constructs the repaint manager.

Method Summary

Modifier and Type	Method and Description
void	addDirtyRegion(JComponent c, int x, int y, int w, int h) If the component c is showing: This method must remember that the specified rectangle needs to be repainted.
void	addInvalidComponent(JComponent invalidComponent) This method initiates a delayed re-validation of the first ancestor of the invalidComponent that satisfies the isValidateRoot() or the invalidComponent itself if there is no such ancestor.
protected void	addRectangle(LinkedList<Rectangle> list, int x, int y, int w, int h) Adds a rectangle.
protected JComponent	getDirtyComponentParent(JComponent comp) Returns the parent component of comp if the parent component of comp is an instance of JComponent.
Rectangle	getDirtyRegion(JComponent c) This method must return the smallest rectangle that contains the dirty region of the given component c.
boolean	isCompletelyDirty(JComponent c) This method returns true when it can be quickly determined that the dirty region of the given component c contains the bounds of c.
protected boolean	isTopLevelComponent(Component comp) Determine if the specified component is a top level component.
void	markCompletelyClean(JComponent c) This method removes all rectangles from the dirty region of the given component c.
protected void	paintDirtyComponent(JComponent comp, Rectangle rect) This method arranges for component to paint its contents,limited to designated rectangle.
void	paintDirtyRegions() This method arranges for all dirty regions to be repainted on the screen, without using a separate thread, and removes all rectangles from all dirty regions.
void	removeInvalidComponent(JComponent component) This method withdraws the request that component is in need of being revalidated.
void	validateInvalidComponents() This method calls validate() on all components remembered through addInvalidComponent.

Methods inherited from class javax.swing.RepaintManager

addDirtyRegion, addDirtyRegion, currentManager, currentManager, getDoubleBufferMaximumSize, getOffscreenBuffer, getVolatileOffscreenBuffer, isDoubleBufferingEnabled, markCompletelyDirty, setCurrentManager, setDoubleBufferingEnabled, setDoubleBufferMaximumSize, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

IlvAbstractRepaintManager

protected IlvAbstractRepaintManager()

Constructs the repaint manager.

Method Detail

addRectangle

protected void addRectangle(LinkedList<Rectangle> list,
                            int x,
                            int y,
                            int w,
                            int h)

Adds a rectangle. Arguments: list is a list of rectangles, each with width > 0 and height> 0. (x,y,w,h) describe a rectangle. w > 0 and h > 0. This method assumes that list contains at most one rectangle. If list contains one rectangle, this method extends that rectangle to contain also the given rectangle whose top-left corner is at (x,y), whose width is w and whose height is h. If list is empty this method adds a Rectangle to list equal to the given rectangle.

isTopLevelComponent

protected boolean isTopLevelComponent(Component comp)

Determine if the specified component is a top level component.

Parameters:

comp - The component to check.

Returns:

True if the specified component an instance of java.awt.Window or java.awt.Applet, false otherwise.

getDirtyComponentParent

protected JComponent getDirtyComponentParent(JComponent comp)

Returns the parent component of comp if the parent component of comp is an instance of JComponent.

Parameters:

comp - The component of the parent to check.

Returns:

True if the parenent component of comp is an instance of JComponent, null otherwise.

paintDirtyComponent

protected void paintDirtyComponent(JComponent comp,
                                   Rectangle rect)

This method arranges for component to paint its contents,limited to designated rectangle.

Parameters:

comp - Component that needs to be painted.

rect - Designated Rectangle.

addInvalidComponent

public void addInvalidComponent(JComponent invalidComponent)

This method initiates a delayed re-validation of the first ancestor of the invalidComponent that satisfies the isValidateRoot() or the invalidComponent itself if there is no such ancestor.

Overrides:

addInvalidComponent in class RepaintManager

Parameters:

invalidComponent - Invalid Component.

removeInvalidComponent

public void removeInvalidComponent(JComponent component)

This method withdraws the request that component is in need of being revalidated.

Overrides:

removeInvalidComponent in class RepaintManager

Parameters:

component - Component that needs to be withdrawn to revalidation queue.

validateInvalidComponents

public void validateInvalidComponents()

This method calls validate() on all components remembered through addInvalidComponent.

Overrides:

validateInvalidComponents in class RepaintManager

addDirtyRegion

public void addDirtyRegion(JComponent c,
                           int x,
                           int y,
                           int w,
                           int h)

If the component c is showing: This method must remember that the specified rectangle needs to be repainted. More precisely, it must add the corresponding rectangle to the dirty region of the top-level ancestor in the parent chain.

Overrides:

addDirtyRegion in class RepaintManager

Parameters:

c - Swing Component.

x - X co-ordinate of a Rectangle.

y - Y co-ordinate of a Rectangle.

w - Width of a Rectangle.

h - Height of a Rectangle.

getDirtyRegion

public Rectangle getDirtyRegion(JComponent c)

This method must return the smallest rectangle that contains the dirty region of the given component c. If that region is empty, it must return an empty rectangle. This method must not return null.

Overrides:

getDirtyRegion in class RepaintManager

Parameters:

c - Swing Component.

markCompletelyClean

public void markCompletelyClean(JComponent c)

This method removes all rectangles from the dirty region of the given component c.

Overrides:

markCompletelyClean in class RepaintManager

Parameters:

c - Swing Component.

isCompletelyDirty

public boolean isCompletelyDirty(JComponent c)

This method returns true when it can be quickly determined that the dirty region of the given component c contains the bounds of c.

Overrides:

isCompletelyDirty in class RepaintManager

Parameters:

c - Swing Component.

paintDirtyRegions

public void paintDirtyRegions()

This method arranges for all dirty regions to be repainted on the screen, without using a separate thread, and removes all rectangles from all dirty regions.

Overrides:

paintDirtyRegions in class RepaintManager