- 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.)
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.
- Since:
- 1.2
- See Also:
-
Method Summary
Modifier and TypeMethodDescriptionvoidGenerally, indicate that this frame has focus.voidThis method is normally called when the user has indicated that they will begin dragging a component around.voidbeginResizingFrame(JComponent f, int direction) This method is normally called when the user has indicated that they will begin resizing the frame.voidGenerally, this call should remove the frame from its parent.voidGenerally, indicate that this frame has lost focus.voidGenerally, remove any iconic representation that is present and restore the frame to it's original size and location.voiddragFrame(JComponent f, int newX, int newY) The user has moved the frame.voidThis method signals the end of the dragging session.voidThis method signals the end of the resize session.voidGenerally, remove this frame from its parent and add an iconic representation.voidGenerally, the frame should be resized to match its parents bounds.voidGenerally, this indicates that the frame should be restored to its size and position prior to a maximizeFrame() call.voidIf possible, display this frame in an appropriate location.voidresizeFrame(JComponent f, int newX, int newY, int newWidth, int newHeight) The user has resized the component.voidsetBoundsForFrame(JComponent f, int newX, int newY, int newWidth, int newHeight) This is a primitive reshape method.
-
Method Details
-
openFrame
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.- Parameters:
f- theJInternalFrameto be displayed
-
closeFrame
Generally, this call should remove the frame from its parent.- Parameters:
f- theJInternalFrameto be removed
-
maximizeFrame
Generally, the frame should be resized to match its parents bounds.- Parameters:
f- theJInternalFrameto be resized
-
minimizeFrame
Generally, this indicates that the frame should be restored to its size and position prior to a maximizeFrame() call.- Parameters:
f- theJInternalFrameto be restored
-
iconifyFrame
Generally, remove this frame from its parent and add an iconic representation.- Parameters:
f- theJInternalFrameto be iconified
-
deiconifyFrame
Generally, remove any iconic representation that is present and restore the frame to it's original size and location.- Parameters:
f- theJInternalFrameto be de-iconified
-
activateFrame
Generally, indicate that this frame has focus. This is usually called after the JInternalFrame's IS_SELECTED_PROPERTY has been set to true.- Parameters:
f- theJInternalFrameto be activated
-
deactivateFrame
Generally, indicate that this frame has lost focus. This is usually called after the JInternalFrame's IS_SELECTED_PROPERTY has been set to false.- Parameters:
f- theJInternalFrameto be deactivated
-
beginDraggingFrame
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.- Parameters:
f- theJComponentbeing dragged
-
dragFrame
The user has moved the frame. Calls to this method will be preceded by calls to beginDraggingFrame(). Normally f will be a JInternalFrame.- Parameters:
f- theJComponentbeing draggednewX- the new x-coordinatenewY- the new y-coordinate
-
endDraggingFrame
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.- Parameters:
f- theJComponentbeing dragged
-
beginResizingFrame
This method 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.- Parameters:
f- theJComponentbeing resizeddirection- the direction
-
resizeFrame
The user has resized the component. Calls to this method will be preceded by calls to beginResizingFrame(). Normally f will be a JInternalFrame.- Parameters:
f- theJComponentbeing resizednewX- the new x-coordinatenewY- the new y-coordinatenewWidth- the new widthnewHeight- the new height
-
endResizingFrame
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.- Parameters:
f- theJComponentbeing resized
-
setBoundsForFrame
This is a primitive reshape method.- Parameters:
f- theJComponentbeing moved or resizednewX- the new x-coordinatenewY- the new y-coordinatenewWidth- the new widthnewHeight- the new height
-