com.zfqjava.swing
Class JCardPane

java.lang.Object
  java.awt.Component
      java.awt.Container
          javax.swing.JComponent
              com.zfqjava.swing.JCardPane

All Implemented Interfaces:

ImageObserver, MenuContainer, Serializable, Accessible

public class JCardPane
extends JComponent
implements Accessible

JCardPane provides a multiple card panel based on CardLayout2.

See Also:

Serialized Form

Nested Class Summary

protected class	JCardPane.AccessibleJCardPane This class implements accessibility support for the JCardPane class.
protected class	JCardPane.ModelListener We pass ModelChanged events along to the listeners with the cardpane (instead of the model itself) as the event source.

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

accessibleContext, 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

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

JCardPane()
Constructs a JCardPane.

Method Summary

void	addChangeListener(ChangeListener l) Adds a ChangeListener to this cardpane.
protected void	addImpl(Component comp, Object constraints, int index)
protected ChangeListener	createChangeListener() Subclasses that want to handle ChangeEvents differently can override this to return a subclass of ModelListener or another ChangeListener implementation.
protected void	fireStateChanged() Sends a ChangeEvent, whose source is this cardpane, to each listener.
AccessibleContext	getAccessibleContext() Gets the AccessibleContext associated with this JCardPane.
ChangeListener[]	getChangeListeners() Returns an array of all the ChangeListeners added to this JCardpane with addChangeListener.
Component	getSelectedComponent() Returns the currently selected component for this cardpane.
int	getSelectedIndex() Returns the currently selected index for this cardpane.
SingleSelectionModel	getSelectionModel() Returns the selectionModel associated with this cardpane.
int	indexOfComponent(Component comp) Gets the component index in this container.
protected String	paramString() Returns a string representation of this JCardPane.
void	remove(int index)
void	removeAll()
void	removeChangeListener(ChangeListener l) Removes a ChangeListener from this cardpane.
void	setSelectedComponent(Component comp) Sets the selected component for this cardpane.
void	setSelectedIndex(int index) Sets the selected index for this cardpane.
void	setSelectionModel(SingleSelectionModel selectionModel) Sets the selectionModel to be used with this cardpane.

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, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, 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, updateUI

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, 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, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusBackward, 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, hide, 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, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Constructor Detail

JCardPane

public JCardPane()

Constructs a JCardPane.

Method Detail

addImpl

protected void addImpl(Component comp,
                       Object constraints,
                       int index)

Overrides:

addImpl in class Container

remove

public void remove(int index)

Overrides:

remove in class Container

removeAll

public void removeAll()

Overrides:

removeAll in class Container

createChangeListener

protected ChangeListener createChangeListener()

Subclasses that want to handle ChangeEvents differently can override this to return a subclass of ModelListener or another ChangeListener implementation.

See Also:

fireStateChanged()

addChangeListener

public void addChangeListener(ChangeListener l)

Adds a ChangeListener to this cardpane.

Parameters:

l - the ChangeListener to add

See Also:

fireStateChanged(), removeChangeListener(javax.swing.event.ChangeListener)

removeChangeListener

public void removeChangeListener(ChangeListener l)

Removes a ChangeListener from this cardpane.

Parameters:

l - the ChangeListener to remove

See Also:

fireStateChanged(), addChangeListener(javax.swing.event.ChangeListener)

getChangeListeners

public ChangeListener[] getChangeListeners()

Returns an array of all the ChangeListeners added to this JCardpane with addChangeListener.

Returns:

all of the ChangeListeners added or an empty array if no listeners have been added

fireStateChanged

protected void fireStateChanged()

Sends a ChangeEvent, whose source is this cardpane, to each listener. This method method is called each time a ChangeEvent is received from the model.

See Also:

addChangeListener(javax.swing.event.ChangeListener), EventListenerList

getSelectionModel

public SingleSelectionModel getSelectionModel()

Returns the selectionModel associated with this cardpane.

See Also:

setSelectionModel(javax.swing.SingleSelectionModel)

setSelectionModel

public void setSelectionModel(SingleSelectionModel selectionModel)

Sets the selectionModel to be used with this cardpane.

Parameters:

selectionModel - the selectionModel to be used

See Also:

getSelectionModel()

setSelectedIndex

public void setSelectedIndex(int index)

Sets the selected index for this cardpane. The index must be a valid component index or -1, which indicates that no component should be selected (can also be used when there are no components in the cardpane). If a -1 value is specified when the cardpane contains one or more components, then the results will be implementation defined.

Parameters:

index - the index to be selected

Throws:

IndexOutOfBoundsException - if index is out of range (index < -1 || index >= component count)

See Also:

getSelectedIndex(), SingleSelectionModel.setSelectedIndex(int)

getSelectedIndex

public int getSelectedIndex()

Returns the currently selected index for this cardpane. Returns -1 if there is no currently selected .

Returns:

the index of the selected component

See Also:

setSelectedIndex(int)

setSelectedComponent

public void setSelectedComponent(Component comp)

Sets the selected component for this cardpane. This will automatically set the selectedIndex to the index corresponding to the specified component.

Throws:

IllegalArgumentException - if component not found in componentbed pane

See Also:

getSelectedComponent()

indexOfComponent

public int indexOfComponent(Component comp)

Gets the component index in this container.

Parameters:

comp - the component

Returns:

the component index, or -1 if no such component

getSelectedComponent

public Component getSelectedComponent()

Returns the currently selected component for this cardpane. Returns null if there is no currently display card.

Returns:

the component corresponding to the selected component

See Also:

setSelectedComponent(java.awt.Component)

paramString

protected String paramString()

Returns a string representation of this JCardPane. This method is intended to be used only for debugging purposes, and the content and format of the returned string may vary between implementations. The returned string may be empty but may not be null.

Overrides:

paramString in class JComponent

Returns:

a string representation of this JCardPane.

getAccessibleContext

public AccessibleContext getAccessibleContext()

Gets the AccessibleContext associated with this JCardPane. For JCardPanes, the AccessibleContext takes the form of an AccessibleJCardPane. A new AccessibleJCardPane instance is created if necessary.

Specified by:

getAccessibleContext in interface Accessible

Overrides:

getAccessibleContext in class JComponent

Returns:

an AccessibleJCardPane that serves as the AccessibleContext of this JCardPane