org.openide.explorer
Class ExplorerPanel

java.lang.Object
  java.awt.Component
      java.awt.Container
          javax.swing.JComponent
              org.openide.windows.TopComponent
                  org.openide.explorer.ExplorerPanel

All Implemented Interfaces:

ImageObserver, MenuContainer, Externalizable, Serializable, Accessible, ExplorerManager.Provider, HelpCtx.Provider, Lookup.Provider

Deprecated. Use ExplorerUtils.actionCopy(org.openide.explorer.ExplorerManager), etc, see ExplorerUtils javadoc for details

public class ExplorerPanel
extends TopComponent
implements ExplorerManager.Provider

Simple top component capable of displaying an Explorer. Holds one instance of ExplorerManager and implements ExplorerManager.Provider to allow child components to share the same explorer manager.

Uses BorderLayout by default. Pays attention to the selected nodes and explored context as indicated by the manager. Cut/copy/paste actions are sensitive to the activation state of the component.

It is up to you to add a view and other UI apparatus to the panel.

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class org.openide.windows.TopComponent

TopComponent.Cloneable, TopComponent.Description, TopComponent.NodeName, TopComponent.OpenActionRegistration, TopComponent.Registration, TopComponent.Registry, TopComponent.SubComponent

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 org.openide.windows.TopComponent

CLOSE_EACH, CLOSE_LAST, PERSISTENCE_ALWAYS, PERSISTENCE_NEVER, PERSISTENCE_ONLY_OPENED, PROP_CLOSING_DISABLED, PROP_DND_COPY_DISABLED, PROP_DRAGGING_DISABLED, PROP_KEEP_PREFERRED_SIZE_WHEN_SLIDED_IN, PROP_MAXIMIZATION_DISABLED, PROP_SLIDING_DISABLED, PROP_UNDOCKING_DISABLED

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

ExplorerPanel()
Deprecated. Default constructor.

ExplorerPanel(ExplorerManager manager)
Deprecated. Initialize the explorer panel with the provided manager.

Method Summary

protected void	componentActivated() Deprecated. Activates copy/cut/paste actions.
protected void	componentDeactivated() Deprecated.
ExplorerManager	getExplorerManager() Deprecated.
HelpCtx	getHelpCtx() Deprecated. Get context help for an explorer window.
static HelpCtx	getHelpCtx(Node[] sel, HelpCtx def) Deprecated. Utility method to get context help from a node selection.
static boolean	isConfirmDelete() Deprecated. Are deletions confirmed on all Explorer panels?
void	open() Deprecated.
void	open(Workspace workspace) Deprecated.
void	readExternal(ObjectInput oi) Deprecated. Reads the manager.
static void	setConfirmDelete(boolean confirmDelete) Deprecated. Set whether deletions should have to be confirmed on all Explorer panels.
protected void	updateTitle() Deprecated. Called when the explored context changes.
void	writeExternal(ObjectOutput oo) Deprecated. Stores the manager

Methods inherited from class org.openide.windows.TopComponent

addNotify, associateLookup, availableModes, cancelRequestAttention, canClose, canClose, close, close, closeNotify, componentClosed, componentHidden, componentOpened, componentShowing, getAccessibleContext, getActions, getActivatedNodes, getCloseOperation, getDisplayName, getHtmlDisplayName, getIcon, getLookup, getPersistenceType, getRegistry, getShortName, getSubComponents, getSystemActions, getTabPosition, getUndoRedo, isOpened, isOpened, makeBusy, openAction, openAtTabPosition, openNotify, preferredID, processKeyBinding, requestActive, requestAttention, requestFocus, requestFocusInWindow, requestVisible, setActivatedNodes, setCloseOperation, setDisplayName, setHtmlDisplayName, setIcon, setName, setToolTipText, toFront, writeReplace

Methods inherited from class javax.swing.JComponent

addAncestorListener, 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, paramString, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, 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, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update, updateUI

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

Constructor Detail

ExplorerPanel

public ExplorerPanel(ExplorerManager manager)

Deprecated.

Initialize the explorer panel with the provided manager.

Parameters:

manager - the explorer manager to use

ExplorerPanel

public ExplorerPanel()

Deprecated.

Default constructor. Uses newly created manager.

Method Detail

open

public void open()

Deprecated.

Overrides:

open in class TopComponent

open

public void open(Workspace workspace)

Deprecated.

Overrides:

open in class TopComponent

getExplorerManager

public ExplorerManager getExplorerManager()

Deprecated.

Specified by:

getExplorerManager in interface ExplorerManager.Provider

componentActivated

protected void componentActivated()

Deprecated.

Activates copy/cut/paste actions.

Overrides:

componentActivated in class TopComponent

componentDeactivated

protected void componentDeactivated()

Deprecated.

Overrides:

componentDeactivated in class TopComponent

updateTitle

protected void updateTitle()

Deprecated.

Called when the explored context changes. The default implementation updates the title of the window.

getHelpCtx

public HelpCtx getHelpCtx()

Deprecated.

Get context help for an explorer window. Looks at the manager's node selection.

Specified by:

getHelpCtx in interface HelpCtx.Provider

Overrides:

getHelpCtx in class TopComponent

Returns:

the help context

See Also:

getHelpCtx(Node[],HelpCtx)

getHelpCtx

public static HelpCtx getHelpCtx(Node[] sel,
                                 HelpCtx def)

Deprecated.

Utility method to get context help from a node selection. Tries to find context helps for selected nodes. If there are some, and they all agree, uses that. In all other cases, uses the supplied generic help.

Parameters:

sel - a list of nodes to search for help in

def - the default help to use if they have none or do not agree

Returns:

a help context

setConfirmDelete

public static void setConfirmDelete(boolean confirmDelete)

Deprecated.

Set whether deletions should have to be confirmed on all Explorer panels.

Parameters:

confirmDelete - true to confirm, false to delete at once

isConfirmDelete

public static boolean isConfirmDelete()

Deprecated.

Are deletions confirmed on all Explorer panels?

Returns:

true if they must be confirmed

writeExternal

public void writeExternal(ObjectOutput oo)
                   throws IOException

Deprecated.

Stores the manager

Specified by:

writeExternal in interface Externalizable

Overrides:

writeExternal in class TopComponent

Throws:

IOException

readExternal

public void readExternal(ObjectInput oi)
                  throws IOException,
                         ClassNotFoundException

Deprecated.

Reads the manager. Deserialization may throw SafeException in case the manager cannot be loaded correctly but the stream is still uncorrupted.

Specified by:

readExternal in interface Externalizable

Overrides:

readExternal in class TopComponent

Throws:

IOException

ClassNotFoundException