JavaTM 2 Platform
Std. Ed. v1.3.1

javax.swing
Interface DesktopManager

All Known Implementing Classes:
DefaultDesktopManager

public interface DesktopManager

DesktopManager objects are owned by a JDesktopPane object. They are responsible for implementing L&F specific behaviors for the JDesktopPane. JInternalFrame implementations should delegate specific behaviors to the DesktopManager. For instance, if a JInternalFrame was asked to iconify, it should try:

    getDesktopPane().getDesktopManager().iconifyFrame(frame);
 
This delegation allows each L&F to provide custom behaviors for desktop-specific actions. (For example, how and where the internal frame's icon would appear.)

See Also:
JDesktopPane, JInternalFrame, JInternalFrame.JDesktopIcon

Method Summary
 void activateFrame(JInternalFrame f)
          Generally, indicate that this frame has focus.
 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)
          Generally, this call should remove the frame from it's parent.
 void deactivateFrame(JInternalFrame f)
          Generally, indicate that this frame has lost focus.
 void deiconifyFrame(JInternalFrame f)
          Generally, remove any iconic representation that is present and restore the frame to it's original size and location.
 void dragFrame(JComponent f, int newX, int newY)
          The user has moved the frame.
 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)
          Generally, remove this frame from it's parent and add an iconic representation.
 void maximizeFrame(JInternalFrame f)
          Generally, the frame should be resized to match it's parents bounds.
 void minimizeFrame(JInternalFrame f)
          Generally, this indicates that the frame should be restored to it's size and position prior to a maximizeFrame() call.
 void openFrame(JInternalFrame f)
          If possible, display this frame in an appropriate location.
 void resizeFrame(JComponent f, int newX, int newY, int newWidth, int newHeight)
          The user has resized the component.
 void setBoundsForFrame(JComponent f, int newX, int newY, int newWidth, int newHeight)
          This is a primative reshape method.
 

Method Detail

openFrame

public void openFrame(JInternalFrame f)
If possible, display this frame in an appropriate location. Normally, this is not called, as the creator of the JInternalFrame will add the frame to the appropriate parent.

closeFrame

public void closeFrame(JInternalFrame f)
Generally, this call should remove the frame from it's parent.

maximizeFrame

public void maximizeFrame(JInternalFrame f)
Generally, the frame should be resized to match it's parents bounds.

minimizeFrame

public void minimizeFrame(JInternalFrame f)
Generally, this indicates that the frame should be restored to it's size and position prior to a maximizeFrame() call.

iconifyFrame

public void iconifyFrame(JInternalFrame f)
Generally, remove this frame from it's parent and add an iconic representation.

deiconifyFrame

public void deiconifyFrame(JInternalFrame f)
Generally, remove any iconic representation that is present and restore the frame to it's original size and location.

activateFrame

public void activateFrame(JInternalFrame f)
Generally, indicate that this frame has focus. This is usually called after the JInternalFrame's IS_SELECTED_PROPERTY has been set to true.

deactivateFrame

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.

beginDraggingFrame

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.

dragFrame

public void dragFrame(JComponent f,
                      int newX,
                      int newY)
The user has moved the frame. Calls to this method will be preceeded by calls to beginDraggingFrame(). Normally f will be a JInternalFrame.

endDraggingFrame

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.

beginResizingFrame

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.

resizeFrame

public void resizeFrame(JComponent f,
                        int newX,
                        int newY,
                        int newWidth,
                        int newHeight)
The user has resized the component. Calls to this method will be preceeded by calls to beginResizingFrame(). Normally f will be a JInternalFrame.

endResizingFrame

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.

setBoundsForFrame

public void setBoundsForFrame(JComponent f,
                              int newX,
                              int newY,
                              int newWidth,
                              int newHeight)
This is a primative reshape method.

JavaTM 2 Platform
Std. Ed. v1.3.1

Submit a bug or feature
For further API reference and developer documentation, see Java 2 SDK SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.

Java, Java 2D, and JDBC are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries.
Copyright 1993-2001 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.