oracle.ide.panels
Class MDDPanel

java.lang.Object
  java.awt.Component
      java.awt.Container
          javax.swing.JComponent
              javax.swing.JPanel
                  oracle.ide.panels.DefaultTraversablePanel
                      oracle.ide.panels.MDDPanel

All Implemented Interfaces:

java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable, java.util.EventListener, javax.accessibility.Accessible, GridBagConstants, ApplyListener, Traversable

public class MDDPanel
extends DefaultTraversablePanel

This implementation of NavigableUIContainer is a "master-detail-detail" panel, hence the name MDDPanel. It subdivides its contents into three areas:

    ------------------------------------------------------
    |            |                                       |
    |            |                                       |
    |   master   |                                       |
    |    tree    |                                       |
    |            |                                       |
    |            |             detail-detail             |
    |            |                 panel                 |
    |            |                                       |
    |------------|                                       |
    |            |                                       |
    |   detail   |                                       |
    |    tree    |                                       |
    |            |                                       |
    |            |                                       |
    |            |                                       |
    ------------------------------------------------------

Each area is contained by a JSplitPane so they are all resizeable. There is a flag in one of the constructors that is used to disable the detail tree if it is not needed; when the detail tree is hidden, then any tree nodes that would normally be shown in the detail tree will be shown as child nodes in the master tree instead, with the detail nodes appearing before child nodes.

When a dialog is required, an instance of MDDPanel should be hosted by a TDialogLauncher. Certain MDDPanel methods cannot be be called until the MDDPanel's onEntry method has been called. If a panel that will be displayed by the MDDPanel has hint text that should be read for accessibility purposes, that hint text needs to be put into the TraversableContext by the panel using the key MDDPanel.CURRENT_TRAVERSABLE_HINT_TEXT

See Also:

Serialized Form

Nested Class Summary

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

javax.swing.JPanel.AccessibleJPanel

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

Field Summary

static java.lang.String	CURRENT_TRAVERSABLE
static java.lang.String	CURRENT_TRAVERSABLE_HINT_TEXT
static java.lang.String	CURRENT_TREE1
static java.lang.String	CURRENT_TREE1_MODEL
static java.lang.String	CURRENT_TREE1_NODE
static java.lang.String	NAVIGABLE_UI_CONTAINER Constant used to get an instance of NavigableUIContainer from TraversableContext.getDesignTimeObject(String).
static java.lang.String	TREE_PANEL_EAST Layout constraint for addTreePanelComponent(..).
static java.lang.String	TREE_PANEL_NORTH Layout constraint for addTreePanelComponent(..).
static java.lang.String	TREE_PANEL_SOUTH Layout constraint for addTreePanelComponent(..).
static java.lang.String	TREE_PANEL_WEST Layout constraint for addTreePanelComponent(..).

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 oracle.ide.controls.GridBagConstants

ANCHOR_C, ANCHOR_E, ANCHOR_N, ANCHOR_NE, ANCHOR_NW, ANCHOR_S, ANCHOR_SE, ANCHOR_SW, ANCHOR_W, FILL_NONE, FILL_X, FILL_XY, FILL_Y

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

protected	MDDPanel() This constructor should only be used by subclasses that will build the Navigable list from within the onEntry method.
	MDDPanel(Navigable rootNavigable) Constructs a new MDDPanel with a single root node in the master tree.
	MDDPanel(Navigable[] rootNavigables) Constructs a new MDDPanel with the specified nodes as root nodes in the master tree.
	MDDPanel(Navigable[] rootNavigables, boolean useDetailTree) Constructs a new MDDPanel with the specified nodes as root nodes in the master tree.

Method Summary

void	addApplyListener(ApplyListener applyListener) Adds an ApplyListener that will be called when the user applies or cancels changes.
protected void	addListener(java.lang.Class eventClass, java.util.EventListener listener)
void	addMDDListener(oracle.ide.panels.MDDListener listener)
void	addTreePanelComponent(java.awt.Component comp, java.lang.Object layoutConstraint)
void	apply(ApplyEvent e) This method is called when the changes made in the NavigableUIContainer are to be committed to the original data structures.
void	cancel(ApplyEvent e) This method is called when the changes made in the NavigableUIContainer are to be discarded.
protected TitledPanel	createTitledPanel(javax.swing.JPanel pnl) Wraps the supplied panel in a new TitledPanel.
boolean	displayDetailNodesAsChildren() Returns true if the UI container is displaying detail nodes with the children rather than in a separate tree.
boolean	enableSelectionDelay(boolean selectionDelay)
void	expandAll(javax.swing.JTree tree, boolean expand)
void	expandTree1Path(java.lang.String[] expandPath) Expands the specified path.
void	expandTree1ToDepth(int depth) Expands the master tree up to and including the number of levels specified by the depth parameter.
protected void	fireApply(ApplyEvent event) Fires the "apply" message to all registered ApplyListener objects.
protected void	fireCancel(ApplyEvent event) Fires the "cancel" message to all registered ApplyListener objects.
protected void	fireTraversableEntered(TraversableContext tc)
java.util.Comparator	getChildComparator() Returns the Comparator to use for sorting the root Navigable children of this MDDPanel.
protected Navigable	getCurrentNavigable() Concrete subclasses must implement this method to return the Navigable that is currently selected in the UI.
protected Traversable	getCurrentTraversable() Concrete subclasses must implement this method to return the Traversable that is currently selected in the UI.
java.util.Comparator	getDefaultChildComparator() Returns the Comparator to use for sorting Navigable children for this MDDPanel.
protected javax.swing.JPanel	getDetailPanel() Gets the detail-detail panel that is used in the card layout.
protected javax.swing.JSplitPane	getDetailSplitPane()
java.lang.String	getHelpID() This method allows a subclass to implement a dynamic means of determining the help ID.
protected java.util.Iterator	getListenerIterator(java.lang.Class listenerClass)
protected javax.swing.JSplitPane	getMainSplitPane()
protected Navigable[]	getRootNavigables()
int	getTitleDepth() Returns the number of levels in the master tree that will be used when generating the titlebar for the detail-detail panel.
protected ControlBar	getTree1ControlBar()
java.lang.String[]	getTree1SelectionPath() Note: The onEntry must have already been called before this method will have an effect.
protected javax.swing.JLabel	getTree1TitleLabel()
boolean	isFilterAllowed() Gets whether the filter control is allowed on this panel.
protected void	maybeRefreshUI(TraversableContext tc)
protected TraversableContext	newTraversableContext() Adds design-time objects to the TraversableContext.
void	onEntry(TraversableContext tc) Does nothing by default.
void	onExit(TraversableContext tc) Does nothing by default.
protected void	refreshUI(TraversableContext dataScope)
void	removeApplyListener(ApplyListener applyListener) Removes a previously added ApplyListener so that it no longer receives notification when the user applies or cancels changes.
protected void	removeListener(java.lang.Class eventClass, java.util.EventListener listener)
void	removeMDDListener(oracle.ide.panels.MDDListener listener)
void	setChildComparator(java.util.Comparator childComparator) Sets the Comparator to use for sorting just the root Navigable children of this MDDPanel; if null is specified, then the root Navigable children will not be sorted.
void	setDefaultChildComparator(java.util.Comparator defaultChildComparator) Sets the Comparator to use for sorting Navigable children for this MDDPanel; if null is specified, then no Navigable children will be sorted.
void	setDetailDividerLocation(double proportionalLocation) Sets the position of the detail divider bar as a percentage of the detail split pane's size.
void	setDetailDividerSize(int dividerSize) Sets the size of the divider bar that separates the master tree from the detail tree.
void	setDetailResizeWeight(double weight) Sets the initial resize weight of the detail divider bar.
void	setFilterAllowed(boolean filterAllowed) Sets whether the filter control is allowed in this panel.
void	setMainDividerLocation(double proportionalLocation) Sets the position of the main divider bar as a percentage of the main split pane's size.
void	setMainDividerSize(int dividerSize) Sets the size of the divider bar that separates the master tree from the detail-detail content area.
void	setMainResizeWeight(double weight) Sets the initial resize weight of the main divider bar.
void	setName(java.lang.String name)
void	setRootNavigables(Navigable[] rootNavigables) Sets the root-level Navigable instances for the UI.
void	setTitleDepth(int titleDepth) Sets the number of levels in the master tree to use when generating the titlebar for the detail-detail panel.
protected void	setTree1ControlBar(ControlBar controlBar)
void	setTree1SelectionPath(java.lang.String[] selectionPath)
void	setTree1SelectionPath(java.lang.String[] selectionPath, boolean expandPath) Note: The onEntry must have already been called before this method will have an effect.
void	setTree1SelectionRow(int row) Changes the selection in the master tree to the specified row.
protected void	setTree1TitleLabel(javax.swing.JLabel label)

Methods inherited from class oracle.ide.panels.DefaultTraversablePanel

gbc, gbc, getComponent, getDefaultTitle, getExitTransition, getText, setDefaultTitle, setHelpID

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

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

Methods inherited from interface oracle.ide.panels.Traversable

getComponent, getExitTransition

Field Detail

CURRENT_TREE1

public static final java.lang.String CURRENT_TREE1

See Also:

Constant Field Values

CURRENT_TREE1_MODEL

public static final java.lang.String CURRENT_TREE1_MODEL

See Also:

Constant Field Values

CURRENT_TREE1_NODE

public static final java.lang.String CURRENT_TREE1_NODE

See Also:

Constant Field Values

CURRENT_TRAVERSABLE

public static final java.lang.String CURRENT_TRAVERSABLE

See Also:

Constant Field Values

CURRENT_TRAVERSABLE_HINT_TEXT

public static final java.lang.String CURRENT_TRAVERSABLE_HINT_TEXT

See Also:

Constant Field Values

TREE_PANEL_NORTH

public static final java.lang.String TREE_PANEL_NORTH

Layout constraint for addTreePanelComponent(..).

See Also:

Constant Field Values

TREE_PANEL_SOUTH

public static final java.lang.String TREE_PANEL_SOUTH

Layout constraint for addTreePanelComponent(..).

See Also:

Constant Field Values

TREE_PANEL_EAST

public static final java.lang.String TREE_PANEL_EAST

Layout constraint for addTreePanelComponent(..).

See Also:

Constant Field Values

TREE_PANEL_WEST

public static final java.lang.String TREE_PANEL_WEST

Layout constraint for addTreePanelComponent(..).

See Also:

Constant Field Values

NAVIGABLE_UI_CONTAINER

public static final java.lang.String NAVIGABLE_UI_CONTAINER

Constant used to get an instance of NavigableUIContainer from TraversableContext.getDesignTimeObject(String).

See Also:

Constant Field Values

Constructor Detail

MDDPanel

protected MDDPanel()

This constructor should only be used by subclasses that will build the Navigable list from within the onEntry method.

MDDPanel

public MDDPanel(Navigable rootNavigable)

Constructs a new MDDPanel with a single root node in the master tree.

MDDPanel

public MDDPanel(Navigable[] rootNavigables)

Constructs a new MDDPanel with the specified nodes as root nodes in the master tree.

MDDPanel

public MDDPanel(Navigable[] rootNavigables,
                boolean useDetailTree)

Constructs a new MDDPanel with the specified nodes as root nodes in the master tree. Any Navigable's that have detail Navigables will have additional nodes shown in the detail tree.

Method Detail

setFilterAllowed

public final void setFilterAllowed(boolean filterAllowed)

Sets whether the filter control is allowed in this panel.

Parameters:

filterAllowed - if true, the panel will provide a filter control for the primary tree.

Since:

11.0

isFilterAllowed

public final boolean isFilterAllowed()

Gets whether the filter control is allowed on this panel.

Returns:

true if the filter control is present on this panel.

Since:

11.0

expandAll

public void expandAll(javax.swing.JTree tree,
                      boolean expand)

createTitledPanel

protected TitledPanel createTitledPanel(javax.swing.JPanel pnl)

Wraps the supplied panel in a new TitledPanel.

Returns:

the TitledPanel

getTree1ControlBar

protected ControlBar getTree1ControlBar()

setTree1ControlBar

protected void setTree1ControlBar(ControlBar controlBar)

getTree1TitleLabel

protected javax.swing.JLabel getTree1TitleLabel()

setTree1TitleLabel

protected void setTree1TitleLabel(javax.swing.JLabel label)

displayDetailNodesAsChildren

public boolean displayDetailNodesAsChildren()

Returns true if the UI container is displaying detail nodes with the children rather than in a separate tree. That is:

• When the UI container is displaying two trees, where the second tree shows the "detail" of a selected node in the first tree, this method returns false.
• When the UI container is displaying only one tree, where the "detail" of the selected node is to be rendered as children of the selected node (instead of nodes in a separate tree), this method returns true. That is, the tree displays detail nodes as children.

onEntry

public void onEntry(TraversableContext tc)

Description copied from class: DefaultTraversablePanel

Does nothing by default.

Specified by:

onEntry in interface Traversable

Parameters:

tc - The data wrapper where the Traversable locates the data that it needs to populate the UI.

See Also:

Traversable.onEntry(TraversableContext)

onExit

public void onExit(TraversableContext tc)
            throws TraversalException

Description copied from class: DefaultTraversablePanel

Does nothing by default.

Specified by:

onExit in interface Traversable

Parameters:

tc - The data object where changes made in the UI should be copied so that the changes can be accessed by other Traversables.

Throws:

TraversalException - if the user has entered either incomplete, invalid, or inconsistent data. This exception prevents the property dialog or wizard from continuing and forces the user to stay on the current Traversable until the data entered is valid or the user cancels. The exception class itself is capable of carrying an error message that will be shown to the user. Refer to its javadoc for details.

See Also:

Traversable.onExit(TraversableContext)

expandTree1ToDepth

public void expandTree1ToDepth(int depth)

Expands the master tree up to and including the number of levels specified by the depth parameter.

Note: The onEntry must have already been called before this method will have an effect. The most common way that the onEntry method gets called is by passing the MDDPanel instance into the TDialogLauncher constructor. Once the MDDPanel has been associated with a TDialogLauncher, then this method may be called.

expandTree1Path

public void expandTree1Path(java.lang.String[] expandPath)

Expands the specified path. Note: The onEntry must have already been called before this method will have an effect. The most common way that the onEntry method gets called is by passing the MDDPanel instance into the TDialogLauncher constructor. Once the MDDPanel has been associated with a TDialogLauncher, then this method may be called.

setTree1SelectionRow

public void setTree1SelectionRow(int row)

Changes the selection in the master tree to the specified row. Note: The onEntry must have already been called before this method will have an effect. The most common way that the onEntry method gets called is by passing the MDDPanel instance into the TDialogLauncher constructor. Once the MDDPanel has been associated with a TDialogLauncher, then this method may be called.

setTree1SelectionPath

public void setTree1SelectionPath(java.lang.String[] selectionPath,
                                  boolean expandPath)

Note: The onEntry must have already been called before this method will have an effect. The most common way that the onEntry method gets called is by passing the MDDPanel instance into the TDialogLauncher constructor. Once the MDDPanel has been associated with a TDialogLauncher, then this method may be called.

setTree1SelectionPath

public void setTree1SelectionPath(java.lang.String[] selectionPath)

getTree1SelectionPath

public java.lang.String[] getTree1SelectionPath()

Note: The onEntry must have already been called before this method will have an effect. The most common way that the onEntry method gets called is by passing the MDDPanel instance into the TDialogLauncher constructor. Once the MDDPanel has been associated with a TDialogLauncher, then this method may be called.

setMainDividerLocation

public void setMainDividerLocation(double proportionalLocation)

Sets the position of the main divider bar as a percentage of the main split pane's size.

setMainDividerSize

public void setMainDividerSize(int dividerSize)

Sets the size of the divider bar that separates the master tree from the detail-detail content area.

setMainResizeWeight

public void setMainResizeWeight(double weight)

Sets the initial resize weight of the main divider bar.

setDetailDividerLocation

public void setDetailDividerLocation(double proportionalLocation)

Sets the position of the detail divider bar as a percentage of the detail split pane's size.

setDetailDividerSize

public void setDetailDividerSize(int dividerSize)

Sets the size of the divider bar that separates the master tree from the detail tree.

setDetailResizeWeight

public void setDetailResizeWeight(double weight)

Sets the initial resize weight of the detail divider bar.

setTitleDepth

public void setTitleDepth(int titleDepth)

Sets the number of levels in the master tree to use when generating the titlebar for the detail-detail panel. This method has no effect when both a master and a detail tree are being used.

getTitleDepth

public int getTitleDepth()

Returns the number of levels in the master tree that will be used when generating the titlebar for the detail-detail panel. The default number of levels is 1.

setChildComparator

public void setChildComparator(java.util.Comparator childComparator)

Sets the Comparator to use for sorting just the root Navigable children of this MDDPanel; if null is specified, then the root Navigable children will not be sorted.

If no child Comparator is specified, then the root Navigable children will be sorted using the default child Comparator, if one has been specified via setDefaultChildComparator(Comparator).

getChildComparator

public java.util.Comparator getChildComparator()

Returns the Comparator to use for sorting the root Navigable children of this MDDPanel.

setDefaultChildComparator

public void setDefaultChildComparator(java.util.Comparator defaultChildComparator)

Sets the Comparator to use for sorting Navigable children for this MDDPanel; if null is specified, then no Navigable children will be sorted. If no default child Comparator is specified, then no Navigable children will be sorted; the root Navigable children will be sorted, however, if a Comparator has been specified via setChildComparator(Comparator). This method assumes that the Navigable.createTreeNode(NavigableContext) method for each Navigable in the panel uses this Comparator to order its Navigable children before creating its tree nodes. The default Navigable does this sorting.

getDefaultChildComparator

public java.util.Comparator getDefaultChildComparator()

Returns the Comparator to use for sorting Navigable children for this MDDPanel.

addMDDListener

public void addMDDListener(oracle.ide.panels.MDDListener listener)

removeMDDListener

public void removeMDDListener(oracle.ide.panels.MDDListener listener)

addTreePanelComponent

public void addTreePanelComponent(java.awt.Component comp,
                                  java.lang.Object layoutConstraint)

enableSelectionDelay

public boolean enableSelectionDelay(boolean selectionDelay)

getCurrentNavigable

protected Navigable getCurrentNavigable()

Concrete subclasses must implement this method to return the Navigable that is currently selected in the UI.

Returns:

the current navigable or null if no navigable is current.

getCurrentTraversable

protected Traversable getCurrentTraversable()

Concrete subclasses must implement this method to return the Traversable that is currently selected in the UI.

Returns:

the current traversable, or null if no tranversable is current.

newTraversableContext

protected TraversableContext newTraversableContext()

Adds design-time objects to the TraversableContext.

refreshUI

protected void refreshUI(TraversableContext dataScope)

fireTraversableEntered

protected void fireTraversableEntered(TraversableContext tc)

getMainSplitPane

protected javax.swing.JSplitPane getMainSplitPane()

getDetailSplitPane

protected javax.swing.JSplitPane getDetailSplitPane()

getDetailPanel

protected javax.swing.JPanel getDetailPanel()

Gets the detail-detail panel that is used in the card layout.

Returns:

a JPanel

setName

public void setName(java.lang.String name)

Overrides:

setName in class java.awt.Component

getHelpID

public java.lang.String getHelpID()

Description copied from class: DefaultTraversablePanel

This method allows a subclass to implement a dynamic means of determining the help ID.

Specified by:

getHelpID in interface Traversable

Overrides:

getHelpID in class DefaultTraversablePanel

addApplyListener

public void addApplyListener(ApplyListener applyListener)

Description copied from interface: ApplyNotifier

Adds an ApplyListener that will be called when the user applies or cancels changes.

removeApplyListener

public void removeApplyListener(ApplyListener applyListener)

Description copied from interface: ApplyNotifier

Removes a previously added ApplyListener so that it no longer receives notification when the user applies or cancels changes.

apply

public void apply(ApplyEvent e)

Description copied from interface: ApplyListener

This method is called when the changes made in the NavigableUIContainer are to be committed to the original data structures. This normally occurs when the user pushes the "OK", "Apply", or "Finish" button.

This method is called as soon as the user's action is recognized. Typically, if the NavigableUIContainer is editing a copy of the original data, there will be an ApplyListener registered that is responsible for flushing the changes from the edited data copy back to the original data structure. The API in the oracle.ide.panels package does not specify when such an ApplyListener is registered or whether one is registered at all.

If you are writing code that must depend on the registration order of such an ApplyListener, you will need to consult the documentation for the code that instantiates the NavigableUIContainer to determine if the registration order for ApplyListeners is specified there.

Specified by:

apply in interface ApplyListener

Parameters:

e - The ApplyEvent that provides contextual information about when the ApplyEvent was fired.

cancel

public void cancel(ApplyEvent e)

Description copied from interface: ApplyListener

This method is called when the changes made in the NavigableUIContainer are to be discarded. This normally occurs when the user pushes the "Cancel" button.

No data validation occurs when the user cancels, and the NavigableUIContainer may or may not call the onExit method of the currently showing Traversable. In general, onExit will not be called.

Specified by:

cancel in interface ApplyListener

Parameters:

e - The ApplyEvent that provides contextual information about when the ApplyEvent was fired.

setRootNavigables

public void setRootNavigables(Navigable[] rootNavigables)

Sets the root-level Navigable instances for the UI.

addListener

protected void addListener(java.lang.Class eventClass,
                           java.util.EventListener listener)

removeListener

protected void removeListener(java.lang.Class eventClass,
                              java.util.EventListener listener)

getRootNavigables

protected Navigable[] getRootNavigables()

maybeRefreshUI

protected final void maybeRefreshUI(TraversableContext tc)

getListenerIterator

protected java.util.Iterator getListenerIterator(java.lang.Class listenerClass)

fireApply

protected void fireApply(ApplyEvent event)

Fires the "apply" message to all registered ApplyListener objects.

fireCancel

protected void fireCancel(ApplyEvent event)

Fires the "cancel" message to all registered ApplyListener objects.