Tableau ( Frame4J -- the Java framework de.frame4j... )

java.lang.Object
- java.awt.Component
- - java.awt.Container
  - - javax.swing.JComponent
    - - de.frame4j.graf.Tableau

All Implemented Interfaces:

MouseListener, MouseMotionListener, ImageObserver, MenuContainer, Serializable, EventListener

Direct Known Subclasses:

TvH
```
public class Tableau
extends JComponent
implements MouseListener, MouseMotionListener, Serializable
```
A picture or tableau for graphical Java applications.

An object of this class is a JComponent (and hence a Component), enhanced by some features:
- An optional image from a file, a stream or another resource (.gif, .png or .jpg) as ImageInfo object,
- serving as permanent background image, that may be added to and optionally changed.
- A list of paintable elements respectively Paintable objects assigned to a given spot and dimension within the image. Such element is once or multiple times tight to the image with Anchor objects.
- Embedded classes respectively interfaces Anchor, Paintable, Element and Listener.
- Double buffering for flicker changes.
- Assigning of mouse events to paintable elements and forwarding the event, with element and anchor to a registered Tableau.Listener.
- Possibility to draw an auxiliary grid (10*10 pixel) within the (optional) margins of the ImageInfo object.
Anchor is an inner class of Tableau. A Tableau.Anchor object hence knows its Tableau object and moors one Paintable in it.

Tableau processes mouse events and assigns them to moored Paintable objects, within the dimensions of wich the mouse was.
Mouse events pre-processed this way may be consumed by a registered Tableau.Listener.

Tableau.Element is an implementation of Paintable that may be extended. Even as is, it can act as respectively replace Labels and Buttons.

Organisation of "Pictures in Picture"

Tableau organises its presentment as a sequence of pictures starting with
- an ImageInfo object as background image
  img, set and modifiable at construction
via
- a permanent background image
  (imgPBg, modifiable for mid term changes
and
- the double buffer image
  (imgDBu, internal use only, serving for flicker free presentment
up to
- the final presentment including all moored Paintable objects (mostly on screen) via a Graphics object provided by the run time
  may be manipulated via extraPaint().
The image presented finally may, by copyImage() or by copyImageInfo(), be extracted as copy.

This (internal) organisation of Tableau allows firstly to avoid multiple drawing of (mid term) stable elements and additionally a presentment totally free of flicker. This, as well as the possibility to get actual copies, to serialise and de-serialise require no extra programming at all when using or extending this class.

© Copyright 1998 - 2002, 2004 Albrecht Weinert
Version:

33 (27.03.2021)

Author:

Albrecht Weinert

See Also:

Serialized Form

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`class`	`Tableau.Anchor` The anchorage of a Paintable element in the Tableau.
`static class`	`Tableau.Element` An element paintable and "moorable" (fixable) within a tableau.
`static interface`	`Tableau.Listener` Information on control actions within the Tableau (by mouse).

Nested classes/interfaces inherited from class javax.swing.JComponent
JComponent.AccessibleJComponent

Nested classes/interfaces inherited from class java.awt.Container
Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

Fields
Modifier and Type	Field and Description
`protected Tableau.Anchor[]`	`anchorList` The List (set) of moored Elements.
`protected Graphics`	`grDBu` The double buffer image's graphic context.
`protected Graphics`	`grPBg` The permanent background image's graphic context.
`protected ImageInfo`	`img` The optional background image.
`protected BufferedImage`	`imgDBu` The double buffer image.
`protected BufferedImage`	`imgPBg` The background as image (colour + optional image).
`protected static Tableau`	`lastTableau` The Tableau last made.
`static Tableau.Anchor[]`	`NO_ANCHOR` Empty array of Anchor.

Fields inherited from class javax.swing.JComponent
listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Fields inherited from class java.awt.Component
accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

Constructors
Constructor and Description
`Tableau(Color bgColor, int width, int heigth)` Constructor with background colour und size.
`Tableau(Color bgColor, String imgFile)` Constructor with background colour and background image.
`Tableau(Color bgColor, String imgFile, Class<?> klass, int oR, int uR, int lR, int rR)` Constructor with background colour, background image and margins.
`Tableau(Color bgColor, String imgFile, int oR, int uR, int lR, int rR)` Constructor with background colour, background image and margins.
`Tableau(Color bgColor, String imgFile, Prop prop, int oR, int uR, int lR, int rR)` Constructor with background colour, background image and margins.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`addAnchor(Tableau.Anchor a)` Add one Anchor.
`void`	`addAnchor(Tableau.Anchor[] aa)` Add multiple Anchors.
`void`	`addAnchorReverse(Tableau.Anchor[] aa)` Add multiple Anchors.
`void`	`addListener(Tableau.Listener l)` Set a Tableau listener.
`void`	`clearAnchor()` Clear all Anchors.
`boolean`	`contains(Tableau.Anchor a)` Check if an Anchor is moored in this Tableau.
`BufferedImage`	`copyImage()` Copy the Tableau's actual content.
`ImageInfo`	`copyImageInfo()` Copy the actual Tableau content.
`void`	`ensureCapacity(int absMin, int minInc)` Ensure or increase the Anchor list's reserve capacity.
`void`	`extraPaint(Graphics g, boolean beforElements)` Paint method.
`float`	`getAlignmentX()` Get the preferred X alignment (0.5F).
`float`	`getAlignmentY()` Get the preferred Y alignment (0.5F).
`int`	`getAnchorCount()` Number of Anchor objects.
`Tableau.Anchor[]`	`getAnchorInside(Point p1, Point p2)` Get all Anchors within a range.
`Tableau.Anchor[]`	`getAnchorListe()` Get the complete list of Anchor objects.
`int`	`getHeight()` The Tableau's height.
`Dimension`	`getMaximumSize()` Get the maximal size.
`Dimension`	`getMinimumSize()` Get the minimal size.
`Graphics`	`getPermBgGraphics()` The permanent background's graphic context.
`Dimension`	`getPreferredSize()` Get the preferred size.
`int`	`getWidth()` The Tableau's width.
`boolean`	`isGrid()` An auxiliary grid (raster 10 pixel) shall be painted.
`void`	`mouseClicked(MouseEvent m)` Mouse clicked.
`void`	`mouseDragged(MouseEvent m)` Mouse dragged (moved with key pressed).
`void`	`mouseEntered(MouseEvent m)` Mouse entered.
`void`	`mouseExited(MouseEvent m)` Mouse exited.
`void`	`mouseMoved(MouseEvent m)` Mouse moved.
`void`	`mousePressed(MouseEvent m)` Mouse pressed.
`void`	`mouseReleased(MouseEvent m)` Mouse released.
`void`	`paint(Graphics g)` Paint method.
`void`	`removeAnchor(Tableau.Anchor a)` Remove an Anchor.
`void`	`restorePermBg()` Re-making the permanent background.
`void`	`retouche(Graphics g, int width, int height)` One time change (retouching) the loaded and margined Tableau.
`void`	`setGrid(boolean grid)` An auxiliary grid (raster 10 pixel) shall be painted.
`void`	`setMotion(boolean motion)` Mouse motion shall be used or not.
`void`	`setSize(Dimension d)` Set the size.
`void`	`trimToSize()` Remove the Anchor list's reserve capacity empty.
`void`	`update(Graphics g)` Update method.

Methods inherited from class javax.swing.JComponent
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getNextFocusableComponent, getPopupLocation, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getUIClassID, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, paramString, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, updateUI

Methods inherited from class java.awt.Container
add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree

Methods inherited from class java.awt.Component
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getAccessibleContext, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Field Detail
  - lastTableau
```
protected static Tableau lastTableau
```
    The Tableau last made.
    
    The Tableau object referred to ba lastTableau will be used by some Tableau.Element constructors for mooring the new element there with spot and dimension.
    
    Hint / warning: This procedere is in no way (!) threadsafe. It works well (and is operationally well-tried with automation applications) if a factory application constructs one Tableau object with all moored elements in one run (single threaded) and then serialises it for later use in the target (automation) application.
  - img
```
protected ImageInfo img
```
    The optional background image.
    
    If given this image as well as the background colour (setBackground()) determines the so called permanent background image.
    Set finally on construction and fitted with margins if given this also determines this Tableau's size.
    
    See Also:
    
    setSize(Dimension)
  - imgPBg
```
protected transient BufferedImage imgPBg
```
    The background as image (colour + optional image).
    
    This image constructed will be the "permanent background". It can, by an own graphic context getPermBgGraphics() be retouched or reset by restorePermBg() to the construction state.
    
    This permanent background image will be made on first demand, i.e. on the Tableau's first paint after construction, de-serialising or reset by restorePermBg(). Than only it may be manipulated via getPermBgGraphics().
  - grPBg
```
protected transient Graphics grPBg
```
    The permanent background image's graphic context.
  - imgDBu
```
protected transient BufferedImage imgDBu
```
    The double buffer image.
    
    The double buffer image is on one hand for flicker free animations:
    Tableau.paint() and Tableau.update() do paint the permanent background image imgPBg an all moored Paintable Elements at first on the double buffer image. Afterwards in one beat and without clearing the background the whole bunch will be painted to the target graphic context. On a target (Tableau) screen one sees just the changes without flicker.
    
    The same complete actual content can, with copyImageInfo(), got as copy.
  - grDBu
```
protected transient Graphics grDBu
```
    The double buffer image's graphic context.
  - anchorList
```
protected Tableau.Anchor[] anchorList
```
    The List (set) of moored Elements.
    
    Internal Implementation hints:
    After two other approaches in past Frame4J versions the direct implementation as array was the fastest. This was crucial to some automation applications.
  - NO_ANCHOR
```
public static final Tableau.Anchor[] NO_ANCHOR
```
    Empty array of Anchor.
- Constructor Detail
  - Tableau
```
public Tableau(Color bgColor,
               int width,
               int heigth)
```
    Constructor with background colour und size.
    
    This constructor does NOT call retouche().
    
    Parameters:
    
    bgColor - background colour
    
    width - Tableau's width
    
    heigth - Tableau's height
  - Tableau
```
public Tableau(Color bgColor,
               String imgFile)
```
    Constructor with background colour and background image.
    
    The background image without margins determines this Tableau's size.
    
    This is:
    Tableau(bgColor, imgFile, null, -1,0, 0,0) // no margin
    
    Parameters:
    
    imgFile - file name (.gif, .png oder .jpg) of background images
    
    bgColor - colour for background and or margins (default ws/white).
    
    Throws:
    
    NoSuchElementException - if no file can be loaded
  - Tableau
```
public Tableau(Color bgColor,
               String imgFile,
               int oR,
               int uR,
               int lR,
               int rR)
```
    Constructor with background colour, background image and margins.
    
    The background image and the margins determine the Tableau object's size. The Tableau img will be made in that size (from imgFile and the margins given). Under this construction the Tableau img may be retouched once by the method retouche(). The image made so will be the part of a Tableau object's serialisation state and is the blue print for the permanent background image imgPBg.
    
    If just one of the margins is outside the allowed range 0 .. 400 there will be no margins at all.
    
    This is:
    Tableau(bgColor, imgFile, null, oR, uR, lR, rR).
    
    Parameters:
    
    imgFile - file name (.gif, .png oder .jpg) of background images
    
    bgColor - colour for background and or margins (default ws/white).
    
    oR - upper margin in pixel (0..400).
    
    uR - lR - rR - dto. low (unten), left and right.
    
    Throws:
    
    NoSuchElementException - if no file can be loaded
    
    See Also:
    
    GrafHelper.surrondImage()
  - Tableau
```
public Tableau(Color bgColor,
               String imgFile,
               Prop prop,
               int oR,
               int uR,
               int lR,
               int rR)
```
    Constructor with background colour, background image and margins.
    
    This constructor is mostly like the one without the Prop parameter prop.
    
    The difference is in case of failure to get the image from the file named and if prop is not null it will be tried to load the background image with Prop.getAsStream(). By this one could get is as resource from the application's .jar file. Additionally an image file name not given by parameter imgFile will be determined by the property bgFile in prop.
    
    Parameters:
    
    imgFile - file name (.gif, .png oder .jpg) of background images
    
    bgColor - colour for background and or margins (default ws/white).
    
    prop - A Prop object as has to find values and resources.
    
    oR - upper margin in pixel (0..400).
    
    uR - lR - rR - dto low (unten), left and right.
    
    Throws:
    
    NoSuchElementException - if no file or ressource can be loaded
    
    See Also:
    
    GrafHelper.surrondImage()
  - Tableau
```
public Tableau(Color bgColor,
               String imgFile,
               Class<?> klass,
               int oR,
               int uR,
               int lR,
               int rR)
```
    Constructor with background colour, background image and margins.
    
    This constructor is mostly like the one without the parameter klass.
    
    The difference is in case of failure to get the image from the file named and if prop is not null it will be tried to load the background image with Prop.getAsStream(). By this one could get is as resource from the application's .jar file. Additionally an image file name not given by parameter imgFile will be determined by the property bgFile in prop.
    
    Parameters:
    
    imgFile - file name (.gif, .png oder .jpg) of background images
    
    bgColor - colour for background and or margins (default ws/white).
    
    klass - A Class object to find resources.
    
    oR - upper margin in pixel (0..400).
    
    uR - lR - rR - dto low (unten), left and right.
    
    Throws:
    
    NoSuchElementException - if no file or ressource can be loaded
    
    See Also:
    
    GrafHelper.surrondImage()
- Method Detail
  - setSize
```
public final void setSize(Dimension d)
```
    Set the size.
    
    The size will be set finally on construction by the size of an image and margins given.
    
    This (java.awt.Component) method hence never has to be called.
    
    This implementation ignores the parameter d and calls super.setsize() (again) with the size determined on construction.
    
    Overrides:
    
    setSize in class Component
    
    Parameters:
    
    d - ignored
  - getWidth
```
public final int getWidth()
```
    The Tableau's width.
    
    Overrides:
    
    getWidth in class JComponent
  - getHeight
```
public final int getHeight()
```
    The Tableau's height.
    
    Overrides:
    
    getHeight in class JComponent
  - getAnchorCount
```
public final int getAnchorCount()
```
    Number of Anchor objects.
  - contains
```
public final boolean contains(Tableau.Anchor a)
```
    Check if an Anchor is moored in this Tableau.
  - addAnchor
```
public final void addAnchor(Tableau.Anchor a)
```
    Add one Anchor.
    
    The same Anchor object will not be added twice. The Anchor list is a set.
    null will not be added.
    
    See Also:
    
    contains(Tableau.Anchor), removeAnchor(Tableau.Anchor), clearAnchor(), ensureCapacity(int, int), addAnchor(Tableau.Anchor[]), addAnchorReverse(Tableau.Anchor[])
  - ensureCapacity
```
public final void ensureCapacity(int absMin,
                                 int minInc)
```
    Ensure or increase the Anchor list's reserve capacity.
    
    This method will be called internally in an appropriate way. Normally it will never be called directly by the application.
    
    Factory programs knowing big capacity demand beforehand may get small improvements by avoiding incremental and non fitting increases.
    
    Parameters:
    
    absMin - Minimal required capacity (absolut)
    
    minInc - Minimal required capacity increase relative to the actual (anchorageCount)
  - trimToSize
```
public final void trimToSize()
```
    Remove the Anchor list's reserve capacity empty.
    
    The (internal) list of Anchor objects will be reduced the exact size (@link #getAnchorCount()}) actually needed. This method may be called after adding the very last Anchor to improve the footprint of very long running application (automation applications).
    
    This method will be called internally before serialisation.
  - addAnchor
```
public final void addAnchor(Tableau.Anchor[] aa)
```
    Add multiple Anchors.
    
    The Anchor objects given in the array aa will be put in this Tableau's Anchor list in ascending order. Overlapping Elements intended to be in the foreground have to have higher indices in aa.
    
    An Anchor object will not be added twice. A null entry will be ignored also.
    
    Parameters:
    
    aa - Ein Feld von Anchor
    
    See Also:
    
    addAnchor(Tableau.Anchor), addAnchorReverse(Tableau.Anchor[]), removeAnchor(Tableau.Anchor)
  - addAnchorReverse
```
public final void addAnchorReverse(Tableau.Anchor[] aa)
```
    Add multiple Anchors.
    
    The Anchor objects given in the array aa will be put in this Tableau's Anchor list in reverse order. Overlapping Elements intended to be in the foreground have to have lower indices in aa.
    
    An Anchor object will not be added twice. A null entry will be ignored also.
    
    Parameters:
    
    aa - an array of Anchor objects
    
    See Also:
    
    addAnchor(Tableau.Anchor), addAnchor(Tableau.Anchor[]), removeAnchor(Tableau.Anchor)
  - removeAnchor
```
public final void removeAnchor(Tableau.Anchor a)
```
    Remove an Anchor.
    
    See Also:
    
    addAnchor(Tableau.Anchor), clearAnchor()
  - clearAnchor
```
public final void clearAnchor()
```
    Clear all Anchors.
    
    The list of Anchor objects will be emptied.
  - getAnchorListe
```
public final Tableau.Anchor[] getAnchorListe()
```
    Get the complete list of Anchor objects.
    
    This method returns a new array of fitting length giving a copy of the actual internal list of Anchor objects.
    
    Since:
    
    V00.05 (07.08.01)
    
    See Also:
    
    clearAnchor(), addAnchor(Tableau.Anchor)
  - getAnchorInside
```
public Tableau.Anchor[] getAnchorInside(Point p1,
                                        Point p2)
```
    Get all Anchors within a range.
    
    Ale Anchor objects, fitting completely within the rectangle given by p1 and p2 will be returned in paint order.
    
    p1 is the upper left point and p2 right lower.
    This method facilitates multiple selects (in GUIs) significantly.
    
    The returned array's length is (exactly) the number of Anchors fitting into to the given rectangle if any. If none fits or exists null is returned.
    
    Parameters:
    
    p1 - left upper; default (0, 0)
    
    p2 - right lower; default the Tableau's dimension
    
    Returns:
    
    A new array of the fitting Anchors or null if none fits
    
    Since:
    
    V00.05 (07.08.2001)
  - isGrid
```
public final boolean isGrid()
```
    An auxiliary grid (raster 10 pixel) shall be painted.
    
    If there are margins around the Tableau img the auxiliary grid will be within the margins only. The raster's upper left corner is (ImageInfo.leM , ImageInfo.upM).
    
    See Also:
    
    ImageInfo.surrondImage(), setGrid()
  - setGrid
```
public void setGrid(boolean grid)
```
    An auxiliary grid (raster 10 pixel) shall be painted.
    
    See Also:
    
    isGrid()
  - retouche
```
public void retouche(Graphics g,
                     int width,
                     int height)
```
    One time change (retouching) the loaded and margined Tableau.
    
    The constructors loading and marginising a background image will call this method only once to enable final manipulations of this Tableau before use (in an extending class). This implementation does nothing.
    
    Parameters:
    
    g - Malen in img
    
    width - width in pixels
    
    height - height in pixels
  - getPreferredSize
```
public final Dimension getPreferredSize()
```
    Get the preferred size.
    
    The methods getPreferredSize(), getMaximumSize() and getMinimumSize() return the same size set at construction. (see img).
    
    Overrides:
    
    getPreferredSize in class JComponent
    
    See Also:
    
    getHeight(), getWidth()
  - getMinimumSize
```
public final Dimension getMinimumSize()
```
    Get the minimal size.
    
    Overrides:
    
    getMinimumSize in class JComponent
    
    See Also:
    
    getPreferredSize()
  - getMaximumSize
```
public final Dimension getMaximumSize()
```
    Get the maximal size.
    
    Overrides:
    
    getMaximumSize in class JComponent
    
    See Also:
    
    getPreferredSize()
  - getAlignmentX
```
public float getAlignmentX()
```
    Get the preferred X alignment (0.5F).
    
    Overrides:
    
    getAlignmentX in class JComponent
  - getAlignmentY
```
public float getAlignmentY()
```
    Get the preferred Y alignment (0.5F).
    
    Overrides:
    
    getAlignmentY in class JComponent
  - update
```
public final void update(Graphics g)
```
    Update method.
    
    This method will be called by the underlying (Windows) system, too. It shall renew the presentment.
    
    Hint: This method has not to be called directly and this should not be done, at least never with the double buffer's graphic context. Doing so would spoil all the organisation; see also paint().
    
    Overrides:
    
    update in class JComponent
  - copyImage
```
public final BufferedImage copyImage()
```
    Copy the Tableau's actual content.
    
    This method returns the Tableau's actual look as a BufferedImage object. The content will be the same as the last double buffer image imgDBu shown by this Tableau.
    
    See Also:
    
    copyImageInfo()
  - copyImageInfo
```
public final ImageInfo copyImageInfo()
```
    Copy the actual Tableau content.
    
    This method returns the Tableaue's actual look as an ImageInfo object getting the same information on margins, filename etc. as img. The content will be the same as the last double buffer image imgDBu shown by this Tableau.
    
    See Also:
    
    copyImage()
  - getPermBgGraphics
```
public Graphics getPermBgGraphics()
```
    The permanent background's graphic context.
    
    This graphic context allows to manipulate or modify the permanent background imgPBg in an arbitrary way. Synchronising this manipulation with other activities concerning the Tableau is the user's responsibility.
    
    Returns:
    
    null if there's no permanent background available (yet).
  - restorePermBg
```
public void restorePermBg()
```
    Re-making the permanent background.
    
    If the permanent background has been modified or supplied with an auxiliary grid it will be re-build according to constructor settings (colour and optional Tableau img) on next paint(), update() or getPermBgGraphics().
  - paint
```
public final void paint(Graphics g)
```
    Paint method.
    
    Only on request by the underlying system this method updates the the permanent background and all moored Paintable elements.
    
    Generally in an application this look should be determined only by the moored Paintable elements Paintable.paint() methods. Hence to protect this internal organisation this method and update() cannot be overridden (final).
    
    If the paint procedure has to be modified one has to ovveride th method extraPaint().
    
    Overrides:
    
    paint in class JComponent
  - extraPaint
```
public void extraPaint(Graphics g,
                       boolean beforElements)
```
    Paint method.
    
    This method will be called by paint() (see dort) before (beforElements = true) or after (beforElements = false) the painting of all moored Paintable elements.
    
    This implementation does nothing with is good for all ausual cases.
  - addListener
```
public final void addListener(Tableau.Listener l)
```
    Set a Tableau listener.
  - setMotion
```
public final void setMotion(boolean motion)
```
    Mouse motion shall be used or not.
    
    Parameters:
    
    motion - true: mouse motions will be captured and forwarded;
    false: mouse motions will be ignored for this Tableau.
  - mouseEntered
```
public final void mouseEntered(MouseEvent m)
```
    Mouse entered.
    
    This event will be forwarded to a Tableau listener (with Element == null).
    
    Specified by:
    
    mouseEntered in interface MouseListener
  - mouseExited
```
public final void mouseExited(MouseEvent m)
```
    Mouse exited.
    
    This event will be forwarded to a Tableau listener (with Element == null) and leads to repaint() afterwards.
    
    Specified by:
    
    mouseExited in interface MouseListener
  - mouseMoved
```
public final void mouseMoved(MouseEvent m)
```
    Mouse moved.
    
    The event will be forwarded with Element==null.
    
    Specified by:
    
    mouseMoved in interface MouseMotionListener
  - mouseDragged
```
public final void mouseDragged(MouseEvent m)
```
    Mouse dragged (moved with key pressed).
    
    The event will be forwarded with with the Element determined with the last (connected) pressed event.
    
    Specified by:
    
    mouseDragged in interface MouseMotionListener
  - mouseClicked
```
public final void mouseClicked(MouseEvent m)
```
    Mouse clicked.
    
    The event will be forwarded with with the Element determined.
    
    Elements, last put in the Anchor list, will be painted later, that is more prominent, in the Tableau. To get the most prominent Element this method searches the Anchor list backwards until the the first match.
    
    Specified by:
    
    mouseClicked in interface MouseListener
  - mousePressed
```
public final void mousePressed(MouseEvent m)
```
    Mouse pressed.
    
    The event will be forwarded with with the Element determined to a Tableau listener.
    
    Specified by:
    
    mousePressed in interface MouseListener
  - mouseReleased
```
public final void mouseReleased(MouseEvent m)
```
    Mouse released.
    
    The event will be forwarded with with the Element determined to a Tableau listener.
    
    Specified by:
    
    mouseReleased in interface MouseListener

Class Tableau

Nested Class Summary

Nested classes/interfaces inherited from class javax.swing.JComponent

Nested classes/interfaces inherited from class java.awt.Container

Nested classes/interfaces inherited from class java.awt.Component

Field Summary

Fields inherited from class javax.swing.JComponent

Fields inherited from class java.awt.Component

Fields inherited from interface java.awt.image.ImageObserver

Constructor Summary

Method Summary

Methods inherited from class javax.swing.JComponent

Methods inherited from class java.awt.Container

Methods inherited from class java.awt.Component

Methods inherited from class java.lang.Object

Field Detail

lastTableau

img

imgPBg

grPBg

imgDBu

grDBu

anchorList

NO_ANCHOR

Constructor Detail

Tableau

Tableau

Tableau

Tableau

Tableau

Method Detail

setSize

getWidth

getHeight

getAnchorCount

contains

addAnchor

ensureCapacity

trimToSize

addAnchor

addAnchorReverse

removeAnchor

clearAnchor

getAnchorListe

getAnchorInside

isGrid

setGrid

retouche

getPreferredSize

getMinimumSize

getMaximumSize

getAlignmentX

getAlignmentY

update

copyImage

copyImageInfo

getPermBgGraphics

restorePermBg

paint

extraPaint

addListener

setMotion

mouseEntered

mouseExited

mouseMoved

mouseDragged

mouseClicked

mousePressed

mouseReleased