public class

DefaultDesktopManager

extends Object
implements Serializable DesktopManager
java.lang.Object
   ↳ javax.swing.DefaultDesktopManager
Known Direct Subclasses

Class Overview

This is an implementation of the DesktopManager. It currently implements the basic behaviors for managing JInternalFrames in an arbitrary parent. JInternalFrames that are not children of a JDesktop will use this component to handle their desktop-like actions.

This class provides a policy for the various JInternalFrame methods, it is not meant to be called directly rather the various JInternalFrame methods will call into the DesktopManager.

Summary

Public Constructors
DefaultDesktopManager()
Public Methods
void activateFrame(JInternalFrame f)
This will activate f moving it to the front.
void beginDraggingFrame(JComponent f)
This method is normally called when the user has indicated that they will begin dragging a component around.
void beginResizingFrame(JComponent f, int direction)
This methods is normally called when the user has indicated that they will begin resizing the frame.
void closeFrame(JInternalFrame f)
Removes the frame, and, if necessary, the desktopIcon, from its parent.
void deactivateFrame(JInternalFrame f)
Generally, indicate that this frame has lost focus.
void deiconifyFrame(JInternalFrame f)
Removes the desktopIcon from its parent and adds its frame to the parent.
void dragFrame(JComponent f, int newX, int newY)
Moves the visible location of the frame being dragged to the location specified.
void endDraggingFrame(JComponent f)
This method signals the end of the dragging session.
void endResizingFrame(JComponent f)
This method signals the end of the resize session.
void iconifyFrame(JInternalFrame f)
Removes the frame from its parent and adds its desktopIcon to the parent.
void maximizeFrame(JInternalFrame f)
Resizes the frame to fill its parents bounds.
void minimizeFrame(JInternalFrame f)
Restores the frame back to its size and position prior to a maximizeFrame call.
void openFrame(JInternalFrame f)
Normally this method will not be called.
void resizeFrame(JComponent f, int newX, int newY, int newWidth, int newHeight)
Calls setBoundsForFrame with the new values.
void setBoundsForFrame(JComponent f, int newX, int newY, int newWidth, int newHeight)
This moves the JComponent and repaints the damaged areas.
Protected Methods
Rectangle getBoundsForIconOf(JInternalFrame f)
The iconifyFrame() code calls this to determine the proper bounds for the desktopIcon.
Rectangle getPreviousBounds(JInternalFrame f)
Gets the normal bounds of the component prior to the component being maximized.
void removeIconFor(JInternalFrame f)
Convenience method to remove the desktopIcon of f is necessary.
void setPreviousBounds(JInternalFrame f, Rectangle r)
Stores the bounds of the component just before a maximize call.
void setWasIcon(JInternalFrame f, Boolean value)
Sets that the component has been iconized and the bounds of the desktopIcon are valid.
boolean wasIcon(JInternalFrame f)
Returns true if the component has been iconized and the bounds of the desktopIcon are valid, otherwise returns false.
[Expand]
Inherited Methods
From class java.lang.Object
From interface javax.swing.DesktopManager

Public Constructors

public DefaultDesktopManager ()

Public Methods

public void activateFrame (JInternalFrame f)

This will activate f moving it to the front. It will set the current active frame's (if any) IS_SELECTED_PROPERTY to false. There can be only one active frame across all Layers.

Parameters
f the JInternalFrame to be activated

public void beginDraggingFrame (JComponent f)

This method is normally called when the user has indicated that they will begin dragging a component around. This method should be called prior to any dragFrame() calls to allow the DesktopManager to prepare any necessary state. Normally f will be a JInternalFrame.

public void beginResizingFrame (JComponent f, int direction)

This methods is normally called when the user has indicated that they will begin resizing the frame. This method should be called prior to any resizeFrame() calls to allow the DesktopManager to prepare any necessary state. Normally f will be a JInternalFrame.

public void closeFrame (JInternalFrame f)

Removes the frame, and, if necessary, the desktopIcon, from its parent.

Parameters
f the JInternalFrame to be removed

public void deactivateFrame (JInternalFrame f)

Generally, indicate that this frame has lost focus. This is usually called after the JInternalFrame's IS_SELECTED_PROPERTY has been set to false.

public void deiconifyFrame (JInternalFrame f)

Removes the desktopIcon from its parent and adds its frame to the parent.

Parameters
f the JInternalFrame to be de-iconified

public void dragFrame (JComponent f, int newX, int newY)

Moves the visible location of the frame being dragged to the location specified. The means by which this occurs can vary depending on the dragging algorithm being used. The actual logical location of the frame might not change until endDraggingFrame is called.

public void endDraggingFrame (JComponent f)

This method signals the end of the dragging session. Any state maintained by the DesktopManager can be removed here. Normally f will be a JInternalFrame.

public void endResizingFrame (JComponent f)

This method signals the end of the resize session. Any state maintained by the DesktopManager can be removed here. Normally f will be a JInternalFrame.

public void iconifyFrame (JInternalFrame f)

Removes the frame from its parent and adds its desktopIcon to the parent.

Parameters
f the JInternalFrame to be iconified

public void maximizeFrame (JInternalFrame f)

Resizes the frame to fill its parents bounds.

Parameters
f the frame to be resized

public void minimizeFrame (JInternalFrame f)

Restores the frame back to its size and position prior to a maximizeFrame call.

Parameters
f the JInternalFrame to be restored

public void openFrame (JInternalFrame f)

Normally this method will not be called. If it is, it try to determine the appropriate parent from the desktopIcon of the frame. Will remove the desktopIcon from its parent if it successfully adds the frame.

public void resizeFrame (JComponent f, int newX, int newY, int newWidth, int newHeight)

Calls setBoundsForFrame with the new values.

Parameters
f the component to be resized
newX the new x-coordinate
newY the new y-coordinate
newWidth the new width
newHeight the new height

public void setBoundsForFrame (JComponent f, int newX, int newY, int newWidth, int newHeight)

This moves the JComponent and repaints the damaged areas.

Protected Methods

protected Rectangle getBoundsForIconOf (JInternalFrame f)

The iconifyFrame() code calls this to determine the proper bounds for the desktopIcon.

protected Rectangle getPreviousBounds (JInternalFrame f)

Gets the normal bounds of the component prior to the component being maximized.

Parameters
f the JInternalFrame of interest
Returns
  • the normal bounds of the component

protected void removeIconFor (JInternalFrame f)

Convenience method to remove the desktopIcon of f is necessary.

protected void setPreviousBounds (JInternalFrame f, Rectangle r)

Stores the bounds of the component just before a maximize call.

Parameters
f the component about to be resized
r the normal bounds to be saved away

protected void setWasIcon (JInternalFrame f, Boolean value)

Sets that the component has been iconized and the bounds of the desktopIcon are valid.

protected boolean wasIcon (JInternalFrame f)

Returns true if the component has been iconized and the bounds of the desktopIcon are valid, otherwise returns false.

Parameters
f the JInternalFrame of interest
Returns
  • true if the component has been iconized; otherwise returns false