csbase.client.util.gui

Class CardPanel

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JPanel

csbase.client.util.gui.CardPanel

All Implemented Interfaces:

ImageObserver, MenuContainer, Serializable, Accessible

public class CardPanel
extends JPanel

A classe CardPanel é um painel que simplifica o uso do CardLayout, além de adicionar funcionalidades ao uso deste. Todos os métodos de CardLayout para navegação entre "cartas" (componentes) tem métodos equivalentes nesta classe.
Funcionalidades adicionadas:

• Possibilidade de tamanho horizontal e/ou vertical dinâmico, ou seja, redimensionamento horizontal e/ou vertical do painel a cada troca de "carta".
• Manipulação dos componentes sem precisar atribuir nome a estes; basta passar a referência para o componente.
• Recuperação do componente que está em exibição

See Also:

Serialized Form

Nested Class Summary

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

JPanel.AccessibleJPanel

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 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
CardPanel() Cria um CardPanel com dimensões estáticas.
CardPanel(boolean dynamicVSize, boolean dynamicHSize) Cria um CardPanel que pode ter tamanho horizontal e/ou vertical dinâmico, de acordo com o valor dos parâmetros deste construtor.

Method Summary

Modifier and Type	Method and Description
Component	add(Component comp) Adiciona o componente à lista de componentes (cartas) deste painel, associando-o a um nome criado arbitrariamente pelo método CardsList.add(Component).
Component	add(Component comp, int index) Adiciona o componente à lista de componentes (cartas) deste painel, associando-o a um nome criado arbitrariamente pelo método CardsList.add(Component).
void	add(Component comp, Object name) Adiciona o componente à lista de componentes (cartas) deste painel, associando-o ao nome recebido como parâmetro.
void	add(Component comp, Object name, int index) Adiciona o componente à lista de componentes (cartas) deste painel, associando-o ao nome recebido como parâmetro.
Component	first() Exibe o primeiro componente da lista de "cartas".
Component	getCurrentCard()
String	getCurrentCardName()
boolean	has(String name) Verifica se existe um componente associado ao nome.
Component	last() Exibe o último componente da lista de "cartas".
Component	next() Exibe o componente seguinte da lista de "cartas".
Component	previous() Exibe o componente anterior da lista de "cartas".
void	remove(Component comp) Remove o componente correspondente à referência recebida como parâmetro da lista de "cartas" deste painel.
void	remove(String name) Remove o componente correspondente à este nome da lista de "cartas" deste painel.
void	setLayout(LayoutManager mgr)
boolean	show(Component comp) Muda o componente em exibição para o componente cuja referência foi recebida como parâmetro, caso o componente a ser exibido tenha sido previamente adicionado à este painel.
Component	show(String name) Muda o componente em exibição para o componente cujo nome corresponde ao nome recebido como parâmetro, caso o componente a ser exibido tenha sido previamente adicionado à este painel.

Methods inherited from class javax.swing.JPanel

getAccessibleContext, getUI, getUIClassID, paramString, setUI, updateUI

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, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, 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, update

Methods inherited from class java.awt.Container

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, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, 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, 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, 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

Constructor Detail

CardPanel

public CardPanel()

Cria um CardPanel com dimensões estáticas.

CardPanel

public CardPanel(boolean dynamicVSize,
                 boolean dynamicHSize)

Cria um CardPanel que pode ter tamanho horizontal e/ou vertical dinâmico, de acordo com o valor dos parâmetros deste construtor.

Parameters:

dynamicVSize - Valor boleano que indica se o tamanho vertical deste painel é dinâmico, ou seja, se é reajustado a cada troca de "carta".

dynamicHSize - Valor boleano que indica se o tamanho horizontal deste painel é dinâmico, ou seja, se é reajustado a cada troca de "carta".

Method Detail

getCurrentCard

public Component getCurrentCard()

Returns:

O componente correspondente à "carta" que está em exibição, ou null, caso a lista de "cartas" esteja vazia.

getCurrentCardName

public String getCurrentCardName()

Returns:

O nome correspondente à "carta" que está em exibição, ou null, caso a lista de "cartas" esteja vazia.

show

public Component show(String name)

Muda o componente em exibição para o componente cujo nome corresponde ao nome recebido como parâmetro, caso o componente a ser exibido tenha sido previamente adicionado à este painel. Se o nome recebido não corresponder a um componente adicionado à este painel, nada acontecerá, e o método retornará null.
Obs.: A utilização deste método é recomendada apenas se, ao adicionar o componente à este painel, um nome foi associado à este.

Parameters:

name - Nome associado ao componente a ser exibido.

Returns:

Referência para o componente exibido, caso o nome recebido corresponda a um componente adicionado à este painel, ou null, caso contrário.

See Also:

add(Component, Object), show(String)

show

public boolean show(Component comp)

Muda o componente em exibição para o componente cuja referência foi recebida como parâmetro, caso o componente a ser exibido tenha sido previamente adicionado à este painel. Se a referência recebida não corresponder a um componente adicionado à este painel, nada acontecerá, e o método retornará false.

Parameters:

comp - Referência ao componente a ser exibido.

Returns:

True, caso a referência recebida corresponda a um componente adicionado à este painel. False, caso contrário.

See Also:

add(Component), show(String)

add

public void add(Component comp,
                Object name)

Adiciona o componente à lista de componentes (cartas) deste painel, associando-o ao nome recebido como parâmetro. Caso já exista referência ao componente ou nome recebido na lista de "cartas" deste painel, nada acontecerá.

Overrides:

add in class Container

Parameters:

comp - Referência ao componente a ser adicionado à este painel.

name - Nome associado ao componente.

See Also:

add(Component)

add

public Component add(Component comp)

Adiciona o componente à lista de componentes (cartas) deste painel, associando-o a um nome criado arbitrariamente pelo método CardsList.add(Component). Caso já exista referência ao componente recebido na lista de "cartas" deste painel, nada acontecerá, e o método retornará null.

Overrides:

add in class Container

Parameters:

comp - Referência ao componente a ser adicionado à este painel.

Returns:

O componente inserido, caso o componente tenha sido adicionado com sucesso, ou null, caso contrário.

See Also:

add(Component, Object)

add

public Component add(Component comp,
                     int index)

Adiciona o componente à lista de componentes (cartas) deste painel, associando-o a um nome criado arbitrariamente pelo método CardsList.add(Component). Caso já exista referência ao componente recebido na lista de "cartas" deste painel, nada acontecerá, e o método retornará null.

Overrides:

add in class Container

Parameters:

comp - Referência ao componente a ser adicionado à este painel.

index - Índice da posição na lista de componentes onde este componente será inserido. -1 significa que o componente será inserido ao final da lista.

Returns:

O componente inserido, caso o componente tenha sido adicionado com sucesso, ou null, caso contrário.

See Also:

add(Component, Object)

add

public void add(Component comp,
                Object name,
                int index)

Adiciona o componente à lista de componentes (cartas) deste painel, associando-o ao nome recebido como parâmetro. Caso já exista referência ao componente ou nome recebido na lista de "cartas" deste painel, nada acontecerá.

Overrides:

add in class Container

Parameters:

comp - Referência ao componente a ser adicionado à este painel.

name - Nome associado ao componente.

index - Índice da posição na lista de componentes onde este componente será inserido. -1 significa que o componente será inserido ao final da lista.

See Also:

add(Component)

remove

public void remove(String name)

Remove o componente correspondente à este nome da lista de "cartas" deste painel. Caso a carta removida seja a carta corrente, a carta corrente passará a ser a próxima.

Parameters:

name - Nome do componente a ser removido.

remove

public void remove(Component comp)

Remove o componente correspondente à referência recebida como parâmetro da lista de "cartas" deste painel. Caso a carta removida seja a carta corrente, a carta corrente passará a ser a próxima.

Overrides:

remove in class Container

Parameters:

comp - Referência ao componente a ser removido.

next

public Component next()

Exibe o componente seguinte da lista de "cartas". Se o componente corrente for o último da lista, o componente corrente passa a ser o primeiro componente da lista.

Returns:

O componente exibido, ou null, caso a lista de "cartas" esteja vazia.

previous

public Component previous()

Exibe o componente anterior da lista de "cartas". Se o componente corrente for o primeiro da lista, o componente corrente passa a ser o ultimo componente da lista.

Returns:

O componente exibido, ou null, caso a lista de "cartas" esteja vazia.

first

public Component first()

Exibe o primeiro componente da lista de "cartas".

Returns:

O componente exibido, ou null, caso a lista de "cartas" esteja vazia.

last

public Component last()

Exibe o último componente da lista de "cartas".

Returns:

O componente exibido, ou null, caso a lista de "cartas" esteja vazia.

has

public boolean has(String name)

Verifica se existe um componente associado ao nome.

Parameters:

name - - nome do componente.

Returns:

true se existir um componente associado ao nome, false caso contrário.

setLayout

public void setLayout(LayoutManager mgr)

Overrides:

setLayout in class Container