public class CContentArea extends javax.swing.JPanel implements CStationContainer
JFrame
. This component can display
and manage some CDockable
s.SplitDockStation
allowing
to show several CDockable
s at the same time. At each border a
FlapDockStation
allows to show "minimized" CDockable
s.CContentArea
s directly, they should
use CControl.getContentArea()
to get the default content area, or
CControl.createContentArea(String)
to create a new content area.Modifier and Type | Class and Description |
---|---|
static class |
CContentArea.Corner
References a corner of a panel.
|
javax.swing.JPanel.AccessibleJPanel
javax.swing.JComponent.AccessibleJComponent
Modifier and Type | Field and Description |
---|---|
static Path |
TYPE_ID_CENTER
The result of
CStation.getTypeId() for the center station |
static Path |
TYPE_ID_MINIMIZE
The result of
CStation.getTypeId() for the minimize stations |
listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
Constructor and Description |
---|
CContentArea(CControl control,
java.lang.String uniqueId)
Creates a new content area.
|
Modifier and Type | Method and Description |
---|---|
void |
addStationContainerListener(CStationContainerListener listener)
Adds the observer
listener to this container. |
protected void |
addStations(CStation<?>... stations)
|
void |
deploy(CGrid grid)
Exchanges all the
CDockable s on the center panel by
the elements of grid . |
SplitDockStation |
getCenter()
Gets the station in the center of this
CContentArea . |
CGridArea |
getCenterArea()
Gets the station in the center of this
CContentArea . |
java.lang.String |
getCenterIdentifier()
Gets the global identifier for the panel in the center.
|
static java.lang.String |
getCenterIdentifier(java.lang.String uniqueCenterId)
Creates the global identifier of a panel in the center.
|
java.awt.Component |
getComponent()
|
CControl |
getControl()
Gets the
CControl for which this content area was created. |
java.awt.Component |
getCornerComponent(CContentArea.Corner corner,
boolean horizontal)
Gets the component of a corner.
|
CStation<?> |
getDefaultStation()
Gets the preferred default
CStation of this container. |
CStation<?> |
getDefaultStation(ExtendedMode mode)
Gets the preferred default
CStation of this container for children in mode mode . |
FlapDockStation |
getEast()
Gets the station in the east of this
CContentArea |
CMinimizeArea |
getEastArea()
Gets the station in the east of this
CContentArea |
java.lang.String |
getEastIdentifier()
Gets the global identifier for the panel in the east.
|
static java.lang.String |
getEastIdentifier(java.lang.String uniqueCenterId)
Creates the global identifier of a panel in the east.
|
CStation<?> |
getMatchingStation(CStationContainer container,
CStation<?> station)
Assuming
container is a type of CStationContainer that is known to
this , and assuming station is a child of container : this
method returns one of this children that has the same relative location in respect to this
as station has to container . |
FlapDockStation |
getNorth()
Gets the station in the north of this
CContentArea |
CMinimizeArea |
getNorthArea()
Gets the station in the north of this
CContentArea |
java.lang.String |
getNorthIdentifier()
Gets the global identifier for the panel in the north.
|
static java.lang.String |
getNorthIdentifier(java.lang.String uniqueCenterId)
Creates the global identifier of a panel in the north.
|
FlapDockStation |
getSouth()
Gets the station in the south of this
CContentArea |
CMinimizeArea |
getSouthArea()
Gets the station in the south of this
CContentArea |
java.lang.String |
getSouthIdentifier()
Gets the global identifier for the panel in the south.
|
static java.lang.String |
getSouthIdentifier(java.lang.String uniqueCenterId)
Creates the global identifier of a panel in the south.
|
CStation<?> |
getStation(int index)
Gets the index'th child of this container.
|
int |
getStationCount()
Gets the number of
CStation s that are currently in this container. |
CStation<?>[] |
getStations()
Gets an independent array of all stations that are used on this
CContentArea . |
java.lang.String |
getUniqueId()
Gets the unique id of this center.
|
FlapDockStation |
getWest()
Gets the station in the west of this
CContentArea |
CMinimizeArea |
getWestArea()
Gets the station in the west of this
CContentArea |
java.lang.String |
getWestIdentifier()
Gets the global identifier for the panel in the west.
|
static java.lang.String |
getWestIdentifier(java.lang.String uniqueCenterId)
Creates the global identifier of a panel in the west.
|
int |
indexOf(CStation<?> child)
Gets the index of
child . |
void |
removeStationContainerListener(CStationContainerListener listener)
Removes the observer
listener from this container. |
void |
setCornerComponent(java.awt.Component component,
CContentArea.Corner corner,
boolean horizontal)
Puts
component in one corner of this area. |
void |
setMinimumAreaSize(java.awt.Dimension size)
Sets the minimum size of the four areas in which minimized
Dockable s
are shown. |
getAccessibleContext, getUI, getUIClassID, paramString, setUI, updateUI
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
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
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
public static final Path TYPE_ID_CENTER
CStation.getTypeId()
for the center stationpublic static final Path TYPE_ID_MINIMIZE
CStation.getTypeId()
for the minimize stationspublic CContentArea(CControl control, java.lang.String uniqueId)
control
- the control for which this area will be useduniqueId
- a unique identifier of this centerprotected void addStations(CStation<?>... stations)
stations
- the additional stations to storepublic java.lang.String getUniqueId()
getUniqueId
in interface CStationContainer
public java.awt.Component getComponent()
CStationContainer
getComponent
in interface CStationContainer
CStation
s, not null
public void addStationContainerListener(CStationContainerListener listener)
CStationContainer
listener
to this container. The listener is to be informed
whenever a CStation
is added or removed from this container.addStationContainerListener
in interface CStationContainer
listener
- the new listener, not null
public void removeStationContainerListener(CStationContainerListener listener)
CStationContainer
listener
from this container.removeStationContainerListener
in interface CStationContainer
listener
- the listener to removepublic CControl getControl()
CControl
for which this content area was created.public CStation<?>[] getStations()
CContentArea
.public int getStationCount()
CStationContainer
CStation
s that are currently in this container.getStationCount
in interface CStationContainer
public CStation<?> getStation(int index)
CStationContainer
getStation
in interface CStationContainer
index
- the index of the child, between 0 and CStationContainer.getStationCount()
null
public int indexOf(CStation<?> child)
child
.child
- a child CStation
of this area.child
or -1 if not foundpublic CStation<?> getDefaultStation()
CStationContainer
CStation
of this container. Children with no location
are usually made visible on such a default station.getDefaultStation
in interface CStationContainer
null
public CStation<?> getDefaultStation(ExtendedMode mode)
CStationContainer
CStation
of this container for children in mode mode
.getDefaultStation
in interface CStationContainer
mode
- the mode for which a station is searchedCStationContainer
that can show Dockable
s in mode mode
,
can be null
public void deploy(CGrid grid)
CDockable
s on the center panel by
the elements of grid
.grid
- a grid containing some new Dockable
spublic void setCornerComponent(java.awt.Component component, CContentArea.Corner corner, boolean horizontal)
component
in one corner of this area.component
- the component, can be null
corner
- the corner into which to put component
horizontal
- whether component
should be horizontally
or vertically.public java.awt.Component getCornerComponent(CContentArea.Corner corner, boolean horizontal)
corner
- the corner in which to searchhorizontal
- whether the component is horizontally or verticallynull
public void setMinimumAreaSize(java.awt.Dimension size)
Dockable
s
are shown. Clients could also call get'Side'().setMinimumSize( size )
.getMinimumAreaSize
because the result might
not be the same for all stations.size
- the new minimum size or null
to revert to the default
value.FlapDockStation.setMinimumSize(Dimension)
,
FlapDockStation.MINIMUM_SIZE
public SplitDockStation getCenter()
CContentArea
.public CGridArea getCenterArea()
CContentArea
.public FlapDockStation getNorth()
CContentArea
public CMinimizeArea getNorthArea()
CContentArea
public FlapDockStation getSouth()
CContentArea
public CMinimizeArea getSouthArea()
CContentArea
public FlapDockStation getEast()
CContentArea
public CMinimizeArea getEastArea()
CContentArea
public FlapDockStation getWest()
CContentArea
public CMinimizeArea getWestArea()
CContentArea
public java.lang.String getCenterIdentifier()
public static java.lang.String getCenterIdentifier(java.lang.String uniqueCenterId)
uniqueCenterId
- the unique if of the owning CContentArea
.public java.lang.String getNorthIdentifier()
public static java.lang.String getNorthIdentifier(java.lang.String uniqueCenterId)
uniqueCenterId
- the unique id of the owning CContentArea
.public java.lang.String getSouthIdentifier()
public static java.lang.String getSouthIdentifier(java.lang.String uniqueCenterId)
uniqueCenterId
- the unique id of the owning CContentArea
.public java.lang.String getEastIdentifier()
public static java.lang.String getEastIdentifier(java.lang.String uniqueCenterId)
uniqueCenterId
- the unique id of the owning CContentArea
.public java.lang.String getWestIdentifier()
public static java.lang.String getWestIdentifier(java.lang.String uniqueCenterId)
uniqueCenterId
- the unique id of the owning CContentArea
.public CStation<?> getMatchingStation(CStationContainer container, CStation<?> station)
CStationContainer
container
is a type of CStationContainer
that is known to
this
, and assuming station
is a child of container
: this
method returns one of this
children that has the same relative location in respect to this
as station
has to container
. For example if station
is the
center area of a CGridArea
, and this
is a CGridArea
as well, then
this method would return the center area of this
.getMatchingStation
in interface CStationContainer
container
- some kind of CStationContainer
, may be a type that is known to this
or not.station
- some child of container
this
, such that the location of the child in relation to this
is
equivalent to the location of station
in relation to container
. A value of
null
indicates that this method did not find a suitable child. If possible the result of this method
and station
should be of the same type.