cz.gyarab.util.light

Class SwingLightPanel

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

cz.gyarab.util.swing.SimpleComponent

cz.gyarab.util.light.SwingLightPanel

All Implemented Interfaces:

InteractiveLightPanel, LightPanel, java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable

Direct Known Subclasses:

SwingCircleLightPanel, SwingDiamondLightPanel, SwingRectangleLightPanel

public class SwingLightPanel
extends SimpleComponent
implements InteractiveLightPanel

Implementace LightPanel pro prostředí Swing. Tato základní implementace vykresluje pouze jednobarevné pozadí pro celý panel a, je-li nastavené, pozadí v jednotlivých buňkách. Odvozené typy vykreslují na pozadí buňky vlastní tvary, např. SwingCircleLightPanel vykreslí vepsaný ovál.

Změnit vykreslovaný tvar v třídě Matrix lze změnou továrny na panely voláním Matrix.setLightPanelFactory.

See Also:

Serialized Form

Nested Class Summary

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

javax.swing.JComponent.AccessibleJComponent

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

java.awt.Container.AccessibleAWTContainer

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

java.awt.Component.AccessibleAWTComponent, java.awt.Component.BaselineResizeBehavior, java.awt.Component.BltBufferStrategy, java.awt.Component.FlipBufferStrategy

Nested classes/interfaces inherited from interface cz.gyarab.util.light.InteractiveLightPanel

InteractiveLightPanel.UserSelectionMode

Field Summary

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
SwingLightPanel(BasicLightMatrix matrix) Vytvoří Swingový panel pro zadanou matici.
SwingLightPanel(BasicLightMatrix matrix, java.lang.String title) Vytvoří Swingový panel pro zadanou matici a nastaví titulek.

Method Summary

Modifier and Type	Method and Description
void	addChangeListener(EventListener<LightChangeEvent> listener) Přidá posluchače změny.
void	addKeyListener(EventListener<KeyEvent> listener) Přidá posluchače klávesnice.
void	addSelectListener(EventListener<LightSelectEvent> listener) Přidá posluchače výběru.
protected int	getCellCol(int x) Převede souřadnici x na sloupec.
protected java.awt.Dimension	getCellDimension() Zjistí rozměr buňky.
protected java.awt.Point	getCellLocation(int col, int row) Zjistí pozici levého horního rohu buňky.
protected java.awt.Rectangle	getCellRectangle(int col, int row) Pro určenou buňku zjistí obalující obdélník.
protected int	getCellRow(int y) Převede souřadnici y na řádek.
protected int	getCellX(int col) Převede sloupec na levou souřadnici x.
protected int	getCellY(int row) Převede řádek na horní souřadnici x.
int	getSelectedCol() Zjistí vybraný sloupec.
int	getSelectedRow() Zjistí vybraný řádek.
protected void	paintComponent(java.awt.Graphics g) Vykreslí panel na zadanou grafiku.
protected void	paintLight(java.awt.Graphics g, java.awt.Rectangle rect, int col, int row, LightColor color, LightColor background) Vykreslí jedno světlo na uvedené pozici.
void	removeChangeListener(EventListener<LightChangeEvent> listener) Odebere posluchače změny.
void	removeKeyListener(EventListener<KeyEvent> listener) Odebere posluchače klávesnice.
void	removeSelectListener(EventListener<LightSelectEvent> listener) Odebere posluchače výběru.
void	select(int col, int row) Vybere buňku.
void	setBackground(LightColor background) Nastaví barvu pozadí celého panelu.
void	setSelectionVisible(boolean visible) Zapne nebo vypne zobrazování označení vybrané buňky.
void	setUserSelectionMode(InteractiveLightPanel.UserSelectionMode mode) Nastaví uživatelský režim výběru myší.
void	unselect() Zruší předchozí výběr.

Methods inherited from class cz.gyarab.util.swing.SimpleComponent

getDefaultCloseOperation, getTitle, isAntialiasing, runInEDT, setAntialiasing, setDefaultCloseOperation, setTitle, showWindow

Methods inherited from class javax.swing.JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getUIClassID, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintImmediately, paintImmediately, paramString, print, printAll, printBorder, printComponent, printChildren, 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, update, 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, 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, checkImage, checkImage, 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, 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

Methods inherited from interface cz.gyarab.util.light.LightPanel

getTitle, setTitle, showWindow

Constructor Detail

SwingLightPanel

public SwingLightPanel(BasicLightMatrix matrix,
                       java.lang.String title)

Vytvoří Swingový panel pro zadanou matici a nastaví titulek.

Parameters:

matrix - matice, pro který se panel vytváří

title - počáteční titulek

SwingLightPanel

public SwingLightPanel(BasicLightMatrix matrix)

Vytvoří Swingový panel pro zadanou matici. Titulek bude nullový.

Parameters:

matrix - matice, pro který se panel vytváří

Method Detail

setBackground

public void setBackground(LightColor background)

Description copied from interface: LightPanel

Nastaví barvu pozadí celého panelu.

Specified by:

setBackground in interface LightPanel

Parameters:

background - barva pozadí

paintComponent

protected final void paintComponent(java.awt.Graphics g)

Vykreslí panel na zadanou grafiku. Postupně vykresluje všechny buňky voláním metody paintLight(java.awt.Graphics, java.awt.Rectangle, int, int, cz.gyarab.util.light.LightColor, cz.gyarab.util.light.LightColor), pro kterou vždy spočítá obdélník, do které se má konkrétní buňka vykreslit. Souřadnice obdélníku jsou již přepočítány do souřadného systému Swingu.

Po vykreslení buňky se okolo vybrané zobrazí tečkovaný obdélník světle šedé barvy, pokud je vykreslování povoleno.

Tato metoda je volána, kdykoliv je potřeba překreslit panel nebo jeho část. Nikdy není volána přímo, pouze v důsledku změny barvy světla, výběru světla nebo když to vyžaduje grafické rozhraní (např. po odkrytí plochy dříve zakryté jiným oknem).

Rozšiřující třídy by měly překrýt metodu paintLight(java.awt.Graphics, java.awt.Rectangle, int, int, cz.gyarab.util.light.LightColor, cz.gyarab.util.light.LightColor).

Overrides:

paintComponent in class SimpleComponent

Parameters:

g - grafika, na kterou se komponenta kreslí

paintLight

protected void paintLight(java.awt.Graphics g,
                          java.awt.Rectangle rect,
                          int col,
                          int row,
                          LightColor color,
                          LightColor background)

Vykreslí jedno světlo na uvedené pozici. Implementace v SwingLightPanel pouze vykresluje pozadí, v překrytých metodách by tedy nejprve měl být zavolán super.paintLight() a pak vykresleno v popředí příslušné světlo.

Kromě aktuální barvy je třeba všechny změny v grafice před návratem z metody uvést do původního stavu.

Parameters:

g - grafika, na kterou se kreslí

rect - obdélník odpovídající buňce světla

col - číslo sloupce

row - číslo řádku

color - barva popředí

background - barva pozadí

getCellCol

protected int getCellCol(int x)

Převede souřadnici x na sloupec.

Parameters:

x - souřadnice

Returns:

sloupec

getCellRow

protected int getCellRow(int y)

Převede souřadnici y na řádek.

Parameters:

y - souřadnice

Returns:

řádek

getCellX

protected int getCellX(int col)

Převede sloupec na levou souřadnici x.

Parameters:

col - sloupec

Returns:

souřadnice x

getCellY

protected int getCellY(int row)

Převede řádek na horní souřadnici x.

Parameters:

row - řádek

Returns:

souřadnice x

getCellLocation

protected java.awt.Point getCellLocation(int col,
                                         int row)

Zjistí pozici levého horního rohu buňky.

Parameters:

col - sloupec

row - řádek

Returns:

polohu

getCellDimension

protected java.awt.Dimension getCellDimension()

Zjistí rozměr buňky.

Returns:

rozměr buňky

getCellRectangle

protected java.awt.Rectangle getCellRectangle(int col,
                                              int row)

Pro určenou buňku zjistí obalující obdélník.

Parameters:

col - sloupec

row - řádek

Returns:

obalující obdélník

getSelectedCol

public int getSelectedCol()

Description copied from interface: InteractiveLightPanel

Zjistí vybraný sloupec.

Specified by:

getSelectedCol in interface InteractiveLightPanel

Returns:

vybraný sloupec, nebo -1, pokud není

getSelectedRow

public int getSelectedRow()

Description copied from interface: InteractiveLightPanel

Zjistí vybraný řádek.

Specified by:

getSelectedRow in interface InteractiveLightPanel

Returns:

vybraný řádek, nebo -1, pokud není

select

public void select(int col,
                   int row)

Description copied from interface: InteractiveLightPanel

Vybere buňku.

Specified by:

select in interface InteractiveLightPanel

Parameters:

col - sloupec

row - řádek

unselect

public void unselect()

Description copied from interface: InteractiveLightPanel

Zruší předchozí výběr.

Specified by:

unselect in interface InteractiveLightPanel

setUserSelectionMode

public void setUserSelectionMode(InteractiveLightPanel.UserSelectionMode mode)

Description copied from interface: InteractiveLightPanel

Nastaví uživatelský režim výběru myší.

Specified by:

setUserSelectionMode in interface InteractiveLightPanel

Parameters:

mode - režim

setSelectionVisible

public void setSelectionVisible(boolean visible)

Description copied from interface: InteractiveLightPanel

Zapne nebo vypne zobrazování označení vybrané buňky.

Specified by:

setSelectionVisible in interface InteractiveLightPanel

Parameters:

visible - true při zobrazení

addSelectListener

public void addSelectListener(EventListener<LightSelectEvent> listener)

Description copied from interface: InteractiveLightPanel

Přidá posluchače výběru. Posluchač bude upozorněn, jakmile uživatel vybere nějakou buňku.

Specified by:

addSelectListener in interface InteractiveLightPanel

Parameters:

listener - posluchač

See Also:

InteractiveLightPanel.setUserSelectionMode(cz.gyarab.util.light.InteractiveLightPanel.UserSelectionMode), InteractiveLightPanel.select(int, int), LightSelectEvent

removeSelectListener

public void removeSelectListener(EventListener<LightSelectEvent> listener)

Description copied from interface: InteractiveLightPanel

Odebere posluchače výběru.

Specified by:

removeSelectListener in interface InteractiveLightPanel

Parameters:

listener - posluchač

addChangeListener

public void addChangeListener(EventListener<LightChangeEvent> listener)

Description copied from interface: InteractiveLightPanel

Přidá posluchače změny. Posluchač bude upozorněn, jakmile se změní barva popředí nebo pozadí nějakého světla v poli.

Specified by:

addChangeListener in interface InteractiveLightPanel

Parameters:

listener - posluchač

See Also:

LightChangeEvent

removeChangeListener

public void removeChangeListener(EventListener<LightChangeEvent> listener)

Description copied from interface: InteractiveLightPanel

Odebere posluchače změny.

Specified by:

removeChangeListener in interface InteractiveLightPanel

Parameters:

listener - posluchač

addKeyListener

public void addKeyListener(EventListener<KeyEvent> listener)

Description copied from interface: InteractiveLightPanel

Přidá posluchače klávesnice. Posluchač bude upozorněn, jakmile uživatel stiskne libovolnou klávesu, zatímco je tento panel aktivní (je vybrán, má ohnisko). Události klávesnice se předávají vždy jen aktivnímu oknu, není tedy možné mít např. dvě okna a současně je obě ovládat klávesnicí, přičemž by každé okno mělo svého posluchače (přinejmenším proto, že není možné mít obě okna aktivní - s ohniskem - současně).

Specified by:

addKeyListener in interface InteractiveLightPanel

Parameters:

listener - posluchač

See Also:

KeyEvent

removeKeyListener

public void removeKeyListener(EventListener<KeyEvent> listener)

Description copied from interface: InteractiveLightPanel

Odebere posluchače klávesnice.

Specified by:

removeKeyListener in interface InteractiveLightPanel

Parameters:

listener - posluchač