javax.swing
Interface DesktopManager

All Known Implementing Classes:
DefaultDesktopManager

public interface DesktopManager

DesktopManagers are responsible for implementing the behaviours for the JInternalFrames that belong to JDesktopPanes. Actions such as maximizing, minimizing, iconifying, etc will be delegated to the DesktopManager.


Method Summary
 void activateFrame(JInternalFrame vframe)
          This method should give focus to the JInternalFrame and its default focus owner.
 void beginDraggingFrame(JComponent frame)
          This method should be called in preparation for dragging.
 void beginResizingFrame(JComponent frame, int direction)
          This method should be called prior to any resizeFrame calls.
 void closeFrame(JInternalFrame frame)
          This method should remove the JInternalFrame from its parent.
 void deactivateFrame(JInternalFrame frame)
          This method should be called when the JInternalFrame gets deselected and subsequently loses focus.
 void deiconifyFrame(JInternalFrame frame)
          This method should remove the JDesktopIcon from its parent and replace it with the JInternalFrame that the JDesktopIcon represents.
 void dragFrame(JComponent frame, int x, int y)
          This method drags the given JInternalFrame to the given x and y coordinates.
 void endDraggingFrame(JComponent frame)
          This method should be called after dragFrame calls.
 void endResizingFrame(JComponent frame)
          This method is called to signify that the resize is finished.
 void iconifyFrame(JInternalFrame frame)
          This method should remove the JInternalFrame from its parent and replace it with a JDesktopIcon.
 void maximizeFrame(JInternalFrame frame)
          This method should maximize the JInternalFrame to match its parent's bounds.
 void minimizeFrame(JInternalFrame frame)
          This method should restore the JInternalFrame to its normal bounds.
 void openFrame(JInternalFrame frame)
          This method will cause the JInternalFrame to be displayed in the set location.
 void resizeFrame(JComponent frame, int x, int y, int width, int height)
          This method is called to resize the given JInternalFrame to the given bounds.
 void setBoundsForFrame(JComponent frame, int x, int y, int width, int height)
          This method does the actual work for reshaping the JInternalFrame.
 

Method Detail

openFrame

void openFrame(JInternalFrame frame)
This method will cause the JInternalFrame to be displayed in the set location. This usually is not needed since the user will add the JInternalFrame to a Container separately.

Parameters:
frame - The JInternalFrame to open.

closeFrame

void closeFrame(JInternalFrame frame)
This method should remove the JInternalFrame from its parent.

Parameters:
frame - The JInternalFrame to close.

maximizeFrame

void maximizeFrame(JInternalFrame frame)
This method should maximize the JInternalFrame to match its parent's bounds.

Parameters:
frame - The JInternalFrame to maximize.

minimizeFrame

void minimizeFrame(JInternalFrame frame)
This method should restore the JInternalFrame to its normal bounds.

Parameters:
frame - The JInternalFrame to minimize.

iconifyFrame

void iconifyFrame(JInternalFrame frame)
This method should remove the JInternalFrame from its parent and replace it with a JDesktopIcon.

Parameters:
frame - The JInternalFrame to iconify.

deiconifyFrame

void deiconifyFrame(JInternalFrame frame)
This method should remove the JDesktopIcon from its parent and replace it with the JInternalFrame that the JDesktopIcon represents.

Parameters:
frame - The JInternalFrame to deiconify.

activateFrame

void activateFrame(JInternalFrame vframe)
This method should give focus to the JInternalFrame and its default focus owner.

Parameters:
vframe - The JInternalFrame to activate.

deactivateFrame

void deactivateFrame(JInternalFrame frame)
This method should be called when the JInternalFrame gets deselected and subsequently loses focus.

Parameters:
frame - The JInternalFrame to deactivate.

beginDraggingFrame

void beginDraggingFrame(JComponent frame)
This method should be called in preparation for dragging. This needs to be called prior to dragFrame calls so that the DesktopManager can prepare any state information.

Parameters:
frame - The JInternalFrame to prepare for dragging.

dragFrame

void dragFrame(JComponent frame,
               int x,
               int y)
This method drags the given JInternalFrame to the given x and y coordinates.

Parameters:
frame - The JInternalFrame to drag.
x - The new x coordinate.
y - The new y coordinate.

endDraggingFrame

void endDraggingFrame(JComponent frame)
This method should be called after dragFrame calls. Any information used by the DesktopManager for dragging the JInternalFrame can be cleared.

Parameters:
frame - The JInternalFrame that finished dragging.

beginResizingFrame

void beginResizingFrame(JComponent frame,
                        int direction)
This method should be called prior to any resizeFrame calls. Any state information needed by the DesktopManager to resize the JInternalFrame will be prepared here.

Parameters:
frame - The JInternalFrame to resize.
direction - One of eight directions specified by SwingConstants.

resizeFrame

void resizeFrame(JComponent frame,
                 int x,
                 int y,
                 int width,
                 int height)
This method is called to resize the given JInternalFrame to the given bounds.

Parameters:
frame - The JInternalFrame to resize.
x - The new x coordinate.
y - The new y coordinate.
width - The new width.
height - The new height.

endResizingFrame

void endResizingFrame(JComponent frame)
This method is called to signify that the resize is finished. Any information used to resize the JInternalFrame can now be cleared.

Parameters:
frame - The JInternalFrame that just finished dragging.

setBoundsForFrame

void setBoundsForFrame(JComponent frame,
                       int x,
                       int y,
                       int width,
                       int height)
This method does the actual work for reshaping the JInternalFrame.

Parameters:
frame - The JInternalFrame to resize.
x - The new x coordinate.
y - The new y coordinate.
width - The new width.
height - The new height.