Warning: Serialized objects of this class will not be compatible with future Swing releases. The current serialization support is appropriate for short term storage or RMI between applications running the same version of Swing. As of 1.4, support for long term storage of all JavaBeans^TM has been added to the java.beans package. Please see {@link java.beans.XMLEncoder}. 

Also see:

OUTLINE_DRAG_MODE
setDragMode

Also see:

LIVE_DRAG_MODE
setDragMode

 public JDesktopPane() 
{
        setUIProperty("opaque", Boolean.TRUE);
        setFocusCycleRoot(true);
        setFocusTraversalPolicy(new LayoutFocusTraversalPolicy() {
            public Component getDefaultComponent(Container c) {
                JInternalFrame jifArray[] = getAllFrames();
                Component comp = null;
                for (JInternalFrame jif : jifArray) {
                    comp = jif.getFocusTraversalPolicy().getDefaultComponent(jif);
                    if (comp != null) {
                        break;
                    }
                }
                return comp;
            }
        });
        updateUI();
}

Creates a new JDesktopPane.

 protected  void addImpl(Component comp,
    Object constraints,
    int index) 
{
        super.addImpl(comp, constraints, index);
        if (componentOrderCheckingEnabled) {
            if (comp instanceof JInternalFrame ||
                comp instanceof JInternalFrame.JDesktopIcon) {
                componentOrderChanged = true;
            }
        }
}

{@inheritDoc}

 public AccessibleContext getAccessibleContext() 
{
        if (accessibleContext == null) {
            accessibleContext = new AccessibleJDesktopPane();
        }
        return accessibleContext;
}

Gets the AccessibleContext associated with this JDesktopPane. For desktop panes, the AccessibleContext takes the form of an AccessibleJDesktopPane. A new AccessibleJDesktopPane instance is created if necessary.

 public JInternalFrame[] getAllFrames() 
{
        int i, count;
        JInternalFrame[] results;
        Vector< JInternalFrame > vResults = new Vector< JInternalFrame >(10);
        count = getComponentCount();
        for(i = 0; i <  count; i++) {
            Component next = getComponent(i);
            if(next instanceof JInternalFrame)
                vResults.addElement((JInternalFrame) next);
            else if(next instanceof JInternalFrame.JDesktopIcon)  {
                JInternalFrame tmp = ((JInternalFrame.JDesktopIcon)next).getInternalFrame();
                if(tmp != null)
                    vResults.addElement(tmp);
            }
        }
        results = new JInternalFrame[vResults.size()];
        vResults.copyInto(results);
        return results;
}

Returns all JInternalFrames currently displayed in the desktop. Returns iconified frames as well as expanded frames.

 public JInternalFrame[] getAllFramesInLayer(int layer) 
{
        int i, count;
        JInternalFrame[] results;
        Vector< JInternalFrame > vResults = new Vector< JInternalFrame >(10);
        count = getComponentCount();
        for(i = 0; i <  count; i++) {
            Component next = getComponent(i);
            if(next instanceof JInternalFrame) {
                if(((JInternalFrame)next).getLayer() == layer)
                    vResults.addElement((JInternalFrame) next);
            } else if(next instanceof JInternalFrame.JDesktopIcon)  {
                JInternalFrame tmp = ((JInternalFrame.JDesktopIcon)next).getInternalFrame();
                if(tmp != null && tmp.getLayer() == layer)
                    vResults.addElement(tmp);
            }
        }
        results = new JInternalFrame[vResults.size()];
        vResults.copyInto(results);
        return results;
}

Returns all JInternalFrames currently displayed in the specified layer of the desktop. Returns iconified frames as well expanded frames.

 public DesktopManager getDesktopManager() 
{
        return desktopManager;
}

Returns the DesktopManger that handles desktop-specific UI actions.

 public int getDragMode() 
{
         return dragMode;
}

Gets the current "dragging style" used by the desktop pane.

 JInternalFrame getNextFrame(JInternalFrame f) 
{
        return getNextFrame(f, true);
}

 public JInternalFrame getSelectedFrame() 
{
      return selectedFrame;
}

Returns the currently active JInternalFrame in this JDesktopPane, or null if no JInternalFrame is currently active.

 public DesktopPaneUI getUI() 
{
        return (DesktopPaneUI)ui;
}

Returns the L&F object that renders this component.

 public String getUIClassID() 
{
        return uiClassID;
}

Returns the name of the L&F class that renders this component.

 protected String paramString() 
{
        String desktopManagerString = (desktopManager != null ?
                                       desktopManager.toString() : "");
        return super.paramString() +
        ",desktopManager=" + desktopManagerString;
}

Returns a string representation of this JDesktopPane. 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.

 public  void remove(int index) 
{
        if (componentOrderCheckingEnabled) {
            Component comp = getComponent(index);
            if (comp instanceof JInternalFrame ||
                comp instanceof JInternalFrame.JDesktopIcon) {
                componentOrderChanged = true;
            }
        }
        super.remove(index);
}

{@inheritDoc}

 public  void removeAll() 
{
        if (componentOrderCheckingEnabled) {
            int count = getComponentCount();
            for (int i = 0; i <  count; i++) {
                Component comp = getComponent(i);
                if (comp instanceof JInternalFrame ||
                    comp instanceof JInternalFrame.JDesktopIcon) {
                    componentOrderChanged = true;
                    break;
                }
            }
        }
        super.removeAll();
}

{@inheritDoc}

 public JInternalFrame selectFrame(boolean forward) 
{
        JInternalFrame selectedFrame = getSelectedFrame();
        JInternalFrame frameToSelect = getNextFrame(selectedFrame, forward);
        if (frameToSelect == null) {
            return null;
        }
        // Maintain navigation traversal order until an
        // external stack change, such as a click on a frame.
        setComponentOrderCheckingEnabled(false);
        if (forward && selectedFrame != null) {
            selectedFrame.moveToBack();  // For Windows MDI fidelity.
        }
        try { frameToSelect.setSelected(true);
        } catch (PropertyVetoException pve) {}
        setComponentOrderCheckingEnabled(true);
        return frameToSelect;
}

Selects the next JInternalFrame in this desktop pane.

  void setComponentOrderCheckingEnabled(boolean enable) 
{
        componentOrderCheckingEnabled = enable;
}

 public  void setComponentZOrder(Component comp,
    int index) 
{
        super.setComponentZOrder(comp, index);
        if (componentOrderCheckingEnabled) {
            if (comp instanceof JInternalFrame ||
                comp instanceof JInternalFrame.JDesktopIcon) {
                componentOrderChanged = true;
            }
        }
}

{@inheritDoc}

 public  void setDesktopManager(DesktopManager d) 
{
        DesktopManager oldValue = desktopManager;
        desktopManager = d;
        firePropertyChange("desktopManager", oldValue, desktopManager);
}

Sets the DesktopManger that will handle desktop-specific UI actions. This may be overridden by {@code LookAndFeel}.

 public  void setDragMode(int dragMode) 
{
        int oldDragMode = this.dragMode;
        this.dragMode = dragMode;
        firePropertyChange("dragMode", oldDragMode, this.dragMode);
        dragModeSet = true;
}

Sets the "dragging style" used by the desktop pane. You may want to change to one mode or another for performance or aesthetic reasons.

 public  void setSelectedFrame(JInternalFrame f) 
{
      selectedFrame = f;
}

Sets the currently active JInternalFrame in this JDesktopPane. This method is used to bridge the package gap between JDesktopPane and the platform implementation code and should not be called directly. To visually select the frame the client must call JInternalFrame.setSelected(true) to activate the frame.

 public  void setUI(DesktopPaneUI ui) 
{
        super.setUI(ui);
}

Sets the L&F object that renders this component.

  void setUIProperty(String propertyName,
    Object value) 
{
        if (propertyName == "dragMode") {
            if (!dragModeSet) {
                setDragMode(((Integer)value).intValue());
                dragModeSet = false;
            }
        } else {
            super.setUIProperty(propertyName, value);
        }
}

 public  void updateUI() 
{
        setUI((DesktopPaneUI)UIManager.getUI(this));
}

Notification from the UIManager that the L&F has changed. Replaces the current UI object with the latest version from the UIManager.