com.jgoodies.uif_lite.panel
Class SimpleInternalFrame

java.lang.Object
  java.awt.Component
      java.awt.Container
          javax.swing.JComponent
              javax.swing.JPanel
                  com.jgoodies.uif_lite.panel.SimpleInternalFrame

All Implemented Interfaces:

javax.accessibility.Accessible, java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable

public class SimpleInternalFrame

extends javax.swing.JPanel

A JPanel subclass that has a drop shadow border and that provides a header with icon, title and tool bar.

This class can be used to replace the JInternalFrame, for use outside of a JDesktopPane. The SimpleInternalFrame is less flexible but often more usable; it avoids overlapping windows and scales well up to IDE size. Several customers have reported that they and their clients feel much better with both the appearance and the UI feel.

The SimpleInternalFrame provides the following bound properties: frameIcon, title, toolBar, content, selected.

By default the SimpleInternalFrame is in selected state. If you don't do anything, multiple simple internal frames will be displayed as selected.

Version:

$Revision: 1.1 $

Author:

Karsten Lentzsch

See Also:

JInternalFrame, JDesktopPane, Serialized Form

Nested Class Summary

Nested classes inherited from class javax.swing.JComponent

javax.swing.JComponent.AccessibleJComponent

Field Summary

Fields inherited from class javax.swing.JComponent

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

SimpleInternalFrame(javax.swing.Icon icon, java.lang.String title)
Constructs a SimpleInternalFrame with the specified icon, and title.

SimpleInternalFrame(javax.swing.Icon icon, java.lang.String title, javax.swing.JToolBar bar, javax.swing.JComponent content)
Constructs a SimpleInternalFrame with the specified icon, title, tool bar, and content panel.

SimpleInternalFrame(java.lang.String title)
Constructs a SimpleInternalFrame with the specified title.

SimpleInternalFrame(java.lang.String title, javax.swing.JToolBar bar, javax.swing.JComponent content)
Constructs a SimpleInternalFrame with the specified title, tool bar, and content panel.

Method Summary

java.awt.Component	getContent() Returns the content - null, if none has been set.
javax.swing.Icon	getFrameIcon() Returns the frame's icon.
java.lang.String	getTitle() Returns the frame's title text.
javax.swing.JToolBar	getToolBar() Returns the current toolbar, null if none has been set before.
boolean	isSelected() Answers if the panel is currently selected (or in other words active) or not.
void	setContent(java.awt.Component newContent) Sets a new panel content; replaces any existing content, if existing.
void	setFrameIcon(javax.swing.Icon newIcon) Sets a new frame icon.
void	setSelected(boolean newValue) This panel draws its title bar differently if it is selected, which may be used to indicate to the user that this panel has the focus, or should get more attention than other simple internal frames.
void	setTitle(java.lang.String newText) Sets a new title text.
void	setToolBar(javax.swing.JToolBar newToolBar) Sets a new tool bar in the header.
void	updateUI() Updates the UI.

Methods inherited from class javax.swing.JPanel

getAccessibleContext, getUI, getUIClassID, setUI

Methods inherited from class javax.swing.JComponent

addAncestorListener, addNotify, addPropertyChangeListener, addPropertyChangeListener, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBorder, getBounds, getClientProperty, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getGraphics, getHeight, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPreferredSize, getPropertyChangeListeners, getPropertyChangeListeners, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isOptimizedDrawingEnabled, isPaintingTile, isPreferredSizeSet, isRequestFocusEnabled, isValidateRoot, paint, paintImmediately, paintImmediately, print, printAll, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFont, setForeground, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, remove, remove, removeAll, removeContainerListener, setFocusCycleRoot, setFocusTraversalKeys, setFocusTraversalPolicy, setLayout, transferFocusBackward, transferFocusDownCycle, validate

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, contains, createImage, createImage, createVolatileImage, createVolatileImage, dispatchEvent, enable, enableInputMethods, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMouseWheelListeners, getName, getParent, getPeer, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, 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

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

SimpleInternalFrame

public SimpleInternalFrame(java.lang.String title)

Constructs a SimpleInternalFrame with the specified title. The title is intended to be non-blank, or in other words should contain non-space characters.

Parameters:

title - the initial title

SimpleInternalFrame

public SimpleInternalFrame(javax.swing.Icon icon,
                           java.lang.String title)

Constructs a SimpleInternalFrame with the specified icon, and title.

Parameters:

icon - the initial icon

title - the initial title

SimpleInternalFrame

public SimpleInternalFrame(java.lang.String title,
                           javax.swing.JToolBar bar,
                           javax.swing.JComponent content)

Constructs a SimpleInternalFrame with the specified title, tool bar, and content panel.

Parameters:

title - the initial title

bar - the initial tool bar

content - the initial content pane

SimpleInternalFrame

public SimpleInternalFrame(javax.swing.Icon icon,
                           java.lang.String title,
                           javax.swing.JToolBar bar,
                           javax.swing.JComponent content)

Constructs a SimpleInternalFrame with the specified icon, title, tool bar, and content panel.

Parameters:

icon - the initial icon

title - the initial title

bar - the initial tool bar

content - the initial content pane

Method Detail

getFrameIcon

public javax.swing.Icon getFrameIcon()

Returns the frame's icon.

Returns:

the frame's icon

setFrameIcon

public void setFrameIcon(javax.swing.Icon newIcon)

Sets a new frame icon.

Parameters:

newIcon - the icon to be set

getTitle

public java.lang.String getTitle()

Returns the frame's title text.

Returns:

String the current title text

setTitle

public void setTitle(java.lang.String newText)

Sets a new title text.

Parameters:

newText - the title text tp be set

getToolBar

public javax.swing.JToolBar getToolBar()

Returns the current toolbar, null if none has been set before.

Returns:

the current toolbar - if any

setToolBar

public void setToolBar(javax.swing.JToolBar newToolBar)

Sets a new tool bar in the header.

Parameters:

newToolBar - the tool bar to be set in the header

getContent

public java.awt.Component getContent()

Returns the content - null, if none has been set.

Returns:

the current content

setContent

public void setContent(java.awt.Component newContent)

Sets a new panel content; replaces any existing content, if existing.

Parameters:

newContent - the panel's new content

isSelected

public boolean isSelected()

Answers if the panel is currently selected (or in other words active) or not. In the selected state, the header background will be rendered differently.

Returns:

boolean a boolean, where true means the frame is selected (currently active) and false means it is not

setSelected

public void setSelected(boolean newValue)

This panel draws its title bar differently if it is selected, which may be used to indicate to the user that this panel has the focus, or should get more attention than other simple internal frames.

Parameters:

newValue - a boolean, where true means the frame is selected (currently active) and false means it is not

updateUI

public void updateUI()

Updates the UI. In addition to the superclass behavior, we need to update the header component.