| 
 | JavaTM 2 Platform Std. Ed. v1.4.2 | ||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||||
java.lang.Objectjava.awt.Component
java.awt.Container
javax.swing.JComponent
javax.swing.JInternalFrame
A lightweight object that provides many of the features of a native frame, including dragging, closing, becoming an icon, resizing, title display, and support for a menu bar. For task-oriented documentation and examples of using internal frames, see How to Use Internal Frames, a section in The Java Tutorial.
 Generally,
 you add JInternalFrames to a JDesktopPane. The UI
 delegates the look-and-feel-specific actions to the
 DesktopManager
 object maintained by the JDesktopPane.
 
 The JInternalFrame content pane
 is where you add child components.
 So, to create a JInternalFrame that has a number of
 buttons arranged 
 with the content pane's default BorderLayout object,
 you might do something like this:
 
    JComponent c = (JComponent) internalFrame.getContentPane();
    c.add(new JButton(), BorderLayout.NORTH);
    c.add(new JButton(), BorderLayout.CENTER);
 
 The content pane is actually managed by an instance of
 JRootPane,
 which also manages a layout pane, glass pane, and 
 optional menu bar for the internal frame. Please see the
 JRootPane 
 documentation for a complete description of these components.
 
 For the keyboard keys used by this component in the standard look and
 feel renditions, see the
 JInternalFrame key assignments.
 
 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 JavaBeansTM
 has been added to the java.beans package.
 Please see XMLEncoder.
InternalFrameEvent, 
JDesktopPane, 
DesktopManager, 
JInternalFrame.JDesktopIcon, 
JRootPane| Nested Class Summary | |
| protected  class | JInternalFrame.AccessibleJInternalFrameThis class implements accessibility support for the JInternalFrameclass. | 
| static class | JInternalFrame.JDesktopIconThis component represents an iconified version of a JInternalFrame. | 
| Nested classes inherited from class javax.swing.JComponent | 
| JComponent.AccessibleJComponent | 
| Nested classes inherited from class java.awt.Container | 
| Container.AccessibleAWTContainer | 
| Nested classes inherited from class java.awt.Component | 
| Component.AccessibleAWTComponent, Component.BltBufferStrategy, Component.FlipBufferStrategy | 
| Field Summary | |
| protected  boolean | closableThe frame can be closed. | 
| static String | CONTENT_PANE_PROPERTYBound property name. | 
| protected  JInternalFrame.JDesktopIcon | desktopIconThe icon that is displayed when this internal frame is iconified. | 
| static String | FRAME_ICON_PROPERTYBound property name. | 
| protected  Icon | frameIconThe icon shown in the top-left corner of this internal frame. | 
| static String | GLASS_PANE_PROPERTYBound property name. | 
| protected  boolean | iconableThe frame can "iconified" (shrunk down and displayed as an icon-image). | 
| static String | IS_CLOSED_PROPERTYConstrained property name indicating that the internal frame is closed. | 
| static String | IS_ICON_PROPERTYConstrained property name indicating that the internal frame is iconified. | 
| static String | IS_MAXIMUM_PROPERTYConstrained property name indicating that the internal frame is maximized. | 
| static String | IS_SELECTED_PROPERTYConstrained property name indicated that this frame has selected status. | 
| protected  boolean | isClosedThe frame has been closed. | 
| protected  boolean | isIconThe frame has been iconified. | 
| protected  boolean | isMaximumThe frame has been expanded to its maximum size. | 
| protected  boolean | isSelectedThe frame is currently selected. | 
| static String | LAYERED_PANE_PROPERTYBound property name. | 
| protected  boolean | maximizableThe frame can be expanded to the size of the desktop pane. | 
| static String | MENU_BAR_PROPERTYBound property name. | 
| protected  boolean | resizableThe frame's size can be changed. | 
| static String | ROOT_PANE_PROPERTYBound property name. | 
| protected  JRootPane | rootPaneThe JRootPaneinstance that manages the
 content pane
 and optional menu bar for this internal frame, as well as the 
 glass pane. | 
| protected  boolean | rootPaneCheckingEnabledIf truethen calls toaddandsetLayoutcause an exception to be thrown. | 
| protected  String | titleThe title displayed in this internal frame's title bar. | 
| static String | TITLE_PROPERTYBound property name. | 
| Fields inherited from class javax.swing.JComponent | 
| accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW | 
| Fields inherited from class java.awt.Component | 
| BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT | 
| Fields inherited from interface javax.swing.WindowConstants | 
| DISPOSE_ON_CLOSE, DO_NOTHING_ON_CLOSE, EXIT_ON_CLOSE, HIDE_ON_CLOSE | 
| Fields inherited from interface java.awt.image.ImageObserver | 
| ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH | 
| Constructor Summary | |
| JInternalFrame()Creates a non-resizable, non-closable, non-maximizable, non-iconifiable JInternalFramewith no title. | |
| JInternalFrame(String title)Creates a non-resizable, non-closable, non-maximizable, non-iconifiable JInternalFramewith the specified title. | |
| JInternalFrame(String title,
               boolean resizable)Creates a non-closable, non-maximizable, non-iconifiable JInternalFramewith the specified title
 and resizability. | |
| JInternalFrame(String title,
               boolean resizable,
               boolean closable)Creates a non-maximizable, non-iconifiable JInternalFramewith the specified title, resizability, and
 closability. | |
| JInternalFrame(String title,
               boolean resizable,
               boolean closable,
               boolean maximizable)Creates a non-iconifiable JInternalFramewith the specified title,
 resizability, closability, and maximizability. | |
| JInternalFrame(String title,
               boolean resizable,
               boolean closable,
               boolean maximizable,
               boolean iconifiable)Creates a JInternalFramewith the specified title,
 resizability, closability, maximizability, and iconifiability. | |
| Method Summary | |
| protected  void | addImpl(Component comp,
        Object constraints,
        int index)Ensures that, by default, children cannot be added directly to this component. | 
|  void | addInternalFrameListener(InternalFrameListener l)Adds the specified listener to receive internal frame events from this internal frame. | 
| protected  JRootPane | createRootPane()Called by the constructor to set up the JRootPane. | 
|  void | dispose()Makes this internal frame invisible, unselected, and closed. | 
|  void | doDefaultCloseAction()Fires an INTERNAL_FRAME_CLOSINGevent
 and then performs the action specified by
 the internal frame's default close operation. | 
| protected  void | fireInternalFrameEvent(int id)Fires an internal frame event. | 
|  AccessibleContext | getAccessibleContext()Gets the AccessibleContextassociated with thisJInternalFrame. | 
|  Container | getContentPane()Returns the content pane for this internal frame. | 
|  int | getDefaultCloseOperation()Returns the default operation that occurs when the user initiates a "close" on this internal frame. | 
|  JInternalFrame.JDesktopIcon | getDesktopIcon()Returns the JDesktopIconused when thisJInternalFrameis iconified. | 
|  JDesktopPane | getDesktopPane()Convenience method that searches the ancestor hierarchy for a JDesktopinstance. | 
|  Container | getFocusCycleRootAncestor()Always returns nullbecauseJInternalFrames
 must always be roots of a focus
 traversal cycle. | 
|  Component | getFocusOwner()If this JInternalFrameis active,
 returns the child that has focus. | 
|  Icon | getFrameIcon()Returns the image displayed in the title bar of this internal frame (usually in the top-left corner). | 
|  Component | getGlassPane()Returns the glass pane for this internal frame. | 
|  InternalFrameListener[] | getInternalFrameListeners()Returns an array of all the InternalFrameListeners added
 to thisJInternalFramewithaddInternalFrameListener. | 
|  JMenuBar | getJMenuBar()Returns the current JMenuBarfor thisJInternalFrame, ornullif no menu bar has been set. | 
|  int | getLayer()Convenience method for getting the layer attribute of this component. | 
|  JLayeredPane | getLayeredPane()Returns the layered pane for this internal frame. | 
|  JMenuBar | getMenuBar()Deprecated. As of Swing version 1.0.3, replaced by getJMenuBar(). | 
|  Component | getMostRecentFocusOwner()Returns the child component of this JInternalFramethat will receive the
 focus when thisJInternalFrameis selected. | 
|  Rectangle | getNormalBounds()If the JInternalFrameis not in maximized state, returnsgetBounds(); otherwise, returns the bounds that theJInternalFramewould be restored to. | 
|  JRootPane | getRootPane()Returns the rootPaneobject for this internal frame. | 
|  String | getTitle()Returns the title of the JInternalFrame. | 
|  InternalFrameUI | getUI()Returns the look-and-feel object that renders this component. | 
|  String | getUIClassID()Returns the name of the look-and-feel class that renders this component. | 
|  String | getWarningString()Gets the warning string that is displayed with this internal frame. | 
|  void | hide() | 
|  boolean | isClosable()Returns whether this JInternalFramecan be closed by
 some user action. | 
|  boolean | isClosed()Returns whether this JInternalFrameis currently closed. | 
|  boolean | isFocusCycleRoot()Always returns truebecause allJInternalFrames must be
 roots of a focus traversal cycle. | 
|  boolean | isIcon()Returns whether the JInternalFrameis currently iconified. | 
|  boolean | isIconifiable()Gets the iconableproperty,
 which by default isfalse. | 
|  boolean | isMaximizable()Gets the value of the maximizableproperty. | 
|  boolean | isMaximum()Returns whether the JInternalFrameis currently maximized. | 
|  boolean | isResizable()Returns whether the JInternalFramecan be resized
 by some user action. | 
| protected  boolean | isRootPaneCheckingEnabled()Returns whether calls to addandsetLayoutcause an exception to be thrown. | 
|  boolean | isSelected()Returns whether the JInternalFrameis the
 currently "selected" or active frame. | 
|  void | moveToBack()Convenience method that moves this component to position -1 if its parent is a JLayeredPane. | 
|  void | moveToFront()Convenience method that moves this component to position 0 if its parent is a JLayeredPane. | 
|  void | pack()Causes subcomponents of this JInternalFrameto be laid out at their preferred size. | 
| protected  void | paintComponent(Graphics g)Overridden to allow optimized painting when the internal frame is being dragged. | 
| protected  String | paramString()Returns a string representation of this JInternalFrame. | 
|  void | remove(Component comp)Removes the specified component from this container. | 
|  void | removeInternalFrameListener(InternalFrameListener l)Removes the specified internal frame listener so that it no longer receives internal frame events from this internal frame. | 
|  void | reshape(int x,
        int y,
        int width,
        int height)Moves and resizes this component. | 
|  void | restoreSubcomponentFocus()Requests the internal frame to restore focus to the last subcomponent that had focus. | 
|  void | setClosable(boolean b)Sets whether this JInternalFramecan be closed by
 some user action. | 
|  void | setClosed(boolean b)Closes this internal frame if the argument is true. | 
|  void | setContentPane(Container c)Sets this JInternalFrame'scontentPaneproperty. | 
|  void | setDefaultCloseOperation(int operation)Sets the operation that will happen by default when the user initiates a "close" on this internal frame. | 
|  void | setDesktopIcon(JInternalFrame.JDesktopIcon d)Sets the JDesktopIconassociated with thisJInternalFrame. | 
|  void | setFocusCycleRoot(boolean focusCycleRoot)Does nothing because JInternalFrames must always be roots of a focus
 traversal cycle. | 
|  void | setFrameIcon(Icon icon)Sets an image to be displayed in the titlebar of this internal frame (usually in the top-left corner). | 
|  void | setGlassPane(Component glass)Sets this JInternalFrame'sglassPaneproperty. | 
|  void | setIcon(boolean b)Iconifies or de-iconifies this internal frame, if the look and feel supports iconification. | 
|  void | setIconifiable(boolean b)Sets the iconableproperty, 
 which must betruefor the user to be able to 
 make theJInternalFramean icon. | 
|  void | setJMenuBar(JMenuBar m)Sets the menuBarproperty for thisJInternalFrame. | 
|  void | setLayer(int layer)Convenience method for setting the layer attribute of this component. | 
|  void | setLayer(Integer layer)Convenience method for setting the layer attribute of this component. | 
|  void | setLayeredPane(JLayeredPane layered)Sets this JInternalFrame'slayeredPaneproperty. | 
|  void | setLayout(LayoutManager manager)Ensures that, by default, the layout of this component cannot be set. | 
|  void | setMaximizable(boolean b)Sets the maximizableproperty,
 which determines whether theJInternalFramecan be maximized by
 some user action. | 
|  void | setMaximum(boolean b)Maximizes and restores this internal frame. | 
|  void | setMenuBar(JMenuBar m)Deprecated. As of Swing version 1.0.3 replaced by setJMenuBar(JMenuBar m). | 
|  void | setNormalBounds(Rectangle r)Sets the normal bounds for this internal frame, the bounds that this internal frame would be restored to from its maximized state. | 
|  void | setResizable(boolean b)Sets whether the JInternalFramecan be resized by some
 user action. | 
| protected  void | setRootPane(JRootPane root)Sets the rootPaneproperty
 for thisJInternalFrame. | 
| protected  void | setRootPaneCheckingEnabled(boolean enabled)Determines whether calls to addandsetLayoutcause an exception to be thrown. | 
|  void | setSelected(boolean selected)Selects or deselects the internal frame if it's showing. | 
|  void | setTitle(String title)Sets the JInternalFrametitle. | 
|  void | setUI(InternalFrameUI ui)Sets the UI delegate for this JInternalFrame. | 
|  void | show()If the internal frame is not visible, brings the internal frame to the front, makes it visible, and attempts to select it. | 
|  void | toBack()Sends this internal frame to the back. | 
|  void | toFront()Brings this internal frame to the front. | 
|  void | updateUI()Notification from the UIManagerthat the look and feel
 has changed. | 
| Methods inherited from class java.lang.Object | 
| clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait | 
| Field Detail | 
protected JRootPane rootPane
JRootPane instance that manages the
 content pane
 and optional menu bar for this internal frame, as well as the 
 glass pane.
JRootPane, 
RootPaneContainerprotected boolean rootPaneCheckingEnabled
true then calls to add and setLayout
 cause an exception to be thrown.
protected boolean closable
protected boolean isClosed
protected boolean maximizable
protected boolean isMaximum
maximizableprotected boolean iconable
JInternalFrame.JDesktopIcon, 
setIconifiable(boolean)protected boolean isIcon
isIcon()protected boolean resizable
protected boolean isSelected
protected Icon frameIcon
protected String title
protected JInternalFrame.JDesktopIcon desktopIcon
iconablepublic static final String CONTENT_PANE_PROPERTY
public static final String MENU_BAR_PROPERTY
public static final String TITLE_PROPERTY
public static final String LAYERED_PANE_PROPERTY
public static final String ROOT_PANE_PROPERTY
public static final String GLASS_PANE_PROPERTY
public static final String FRAME_ICON_PROPERTY
public static final String IS_SELECTED_PROPERTY
public static final String IS_CLOSED_PROPERTY
public static final String IS_MAXIMUM_PROPERTY
public static final String IS_ICON_PROPERTY
| Constructor Detail | 
public JInternalFrame()
JInternalFrame with no title.
public JInternalFrame(String title)
JInternalFrame with the specified title.
 Note that passing in a null title results in
 unspecified behavior and possibly an exception.
title - the non-null String
     to display in the title bar
public JInternalFrame(String title,
                      boolean resizable)
JInternalFrame with the specified title
 and resizability.
title - the String to display in the title barresizable - if true, the internal frame can be resized
public JInternalFrame(String title,
                      boolean resizable,
                      boolean closable)
JInternalFrame
 with the specified title, resizability, and
 closability.
title - the String to display in the title barresizable - if true, the internal frame can be resizedclosable - if true, the internal frame can be closed
public JInternalFrame(String title,
                      boolean resizable,
                      boolean closable,
                      boolean maximizable)
JInternalFrame
 with the specified title,
 resizability, closability, and maximizability.
title - the String to display in the title barresizable - if true, the internal frame can be resizedclosable - if true, the internal frame can be closedmaximizable - if true, the internal frame can be maximized
public JInternalFrame(String title,
                      boolean resizable,
                      boolean closable,
                      boolean maximizable,
                      boolean iconifiable)
JInternalFrame with the specified title,
 resizability, closability, maximizability, and iconifiability.
 All JInternalFrame constructors use this one.
title - the String to display in the title barresizable - if true, the internal frame can be resizedclosable - if true, the internal frame can be closedmaximizable - if true, the internal frame can be maximizediconifiable - if true, the internal frame can be iconified| Method Detail | 
protected JRootPane createRootPane()
JRootPane.
JRootPaneJRootPanepublic InternalFrameUI getUI()
InternalFrameUI object that renders
		this componentpublic void setUI(InternalFrameUI ui)
JInternalFrame.
ui - the UI delegatepublic void updateUI()
UIManager that the look and feel
 has changed. 
 Replaces the current UI object with the latest version from the 
 UIManager.
updateUI in class JComponentJComponent.updateUI()public String getUIClassID()
getUIClassID in class JComponentJComponent.getUIClassID(), 
UIDefaults.getUI(javax.swing.JComponent)protected boolean isRootPaneCheckingEnabled()
add and 
 setLayout cause an exception to be thrown.
true if add and setLayout 
         are checkedaddImpl(java.awt.Component, java.lang.Object, int), 
setLayout(java.awt.LayoutManager), 
setRootPaneCheckingEnabled(boolean)protected void setRootPaneCheckingEnabled(boolean enabled)
add and 
 setLayout cause an exception to be thrown.
enabled - a boolean value, true if checking is to be
        enabled, which cause the exceptions to be thrownaddImpl(java.awt.Component, java.lang.Object, int), 
setLayout(java.awt.LayoutManager), 
isRootPaneCheckingEnabled()
protected void addImpl(Component comp,
                       Object constraints,
                       int index)
thisComponent.getContentPane().add(child)An attempt to add to directly to this component will cause a runtime exception to be thrown. Subclasses can disable this behavior.
addImpl in class Containercomp - the Component to be addedconstraints - the object containing the constraints, if anyindex - the index
Error - if called with isRootPaneChecking truesetRootPaneCheckingEnabled(boolean)public void remove(Component comp)
remove in class Containercomp - the component to be removedContainer.add(java.awt.Component)public void setLayout(LayoutManager manager)
thisComponent.getContentPane().setLayout(new GridLayout(1,2))An attempt to set the layout of this component will cause an runtime exception to be thrown. Subclasses can disable this behavior.
setLayout in class Containermanager - the LayoutManager
Error - if called with isRootPaneChecking truesetRootPaneCheckingEnabled(boolean)public JMenuBar getMenuBar()
getJMenuBar().
JMenuBar for this
 JInternalFrame, or null
 if no menu bar has been set.
null if none has been setpublic JMenuBar getJMenuBar()
JMenuBar for this
 JInternalFrame, or null
 if no menu bar has been set.
JMenuBar used by this internal framesetJMenuBar(javax.swing.JMenuBar)public void setMenuBar(JMenuBar m)
setJMenuBar(JMenuBar m).
menuBar property for this JInternalFrame.
m - the JMenuBar to use in this internal framegetJMenuBar()public void setJMenuBar(JMenuBar m)
menuBar property for this JInternalFrame.
m - the JMenuBar to use in this internal framegetJMenuBar()public Container getContentPane()
getContentPane in interface RootPaneContainerRootPaneContainer.setContentPane(java.awt.Container)public void setContentPane(Container c)
JInternalFrame's contentPane
 property.
setContentPane in interface RootPaneContainerc - the content pane for this internal frame
IllegalComponentStateException - (a runtime
           exception) if the content pane parameter is nullRootPaneContainer.getContentPane()public JLayeredPane getLayeredPane()
getLayeredPane in interface RootPaneContainerJLayeredPane objectRootPaneContainer.setLayeredPane(javax.swing.JLayeredPane), 
RootPaneContainer.getLayeredPane()public void setLayeredPane(JLayeredPane layered)
JInternalFrame's 
 layeredPane property.
setLayeredPane in interface RootPaneContainerlayered - the JLayeredPane for this internal frame
IllegalComponentStateException - (a runtime
           exception) if the layered pane parameter is nullRootPaneContainer.setLayeredPane(javax.swing.JLayeredPane)public Component getGlassPane()
getGlassPane in interface RootPaneContainerRootPaneContainer.setGlassPane(java.awt.Component)public void setGlassPane(Component glass)
JInternalFrame's 
 glassPane property.
setGlassPane in interface RootPaneContainerglass - the glass pane for this internal frameRootPaneContainer.getGlassPane()public JRootPane getRootPane()
rootPane object for this internal frame.
getRootPane in interface RootPaneContainergetRootPane in class JComponentrootPane propertyRootPaneContainer.getRootPane()protected void setRootPane(JRootPane root)
rootPane property
 for this JInternalFrame.
 This method is called by the constructor.
root - the new JRootPane objectpublic void setClosable(boolean b)
JInternalFrame can be closed by
 some user action.
b - a boolean value, where true means this internal frame can be closedpublic boolean isClosable()
JInternalFrame can be closed by
 some user action.
true if this internal frame can be closedpublic boolean isClosed()
JInternalFrame is currently closed.
true if this internal frame is closed, false otherwise
public void setClosed(boolean b)
               throws PropertyVetoException
true.
 Do not invoke this method with a false argument;
 the result of invoking setClosed(false) 
 is unspecified.
 
 If the internal frame is already closed,
 this method does nothing and returns immediately.
 Otherwise, 
 this method begins by firing
 an INTERNAL_FRAME_CLOSING event.
 Then this method sets the closed property to true
 unless a listener vetoes the property change.
 This method finishes by making the internal frame
 invisible and unselected, 
 and then firing an INTERNAL_FRAME_CLOSED event.
 
 Note:
 To reuse an internal frame that has been closed,
 you must add it to a container
 (even if you never removed it from its previous container).
 Typically, this container will be the JDesktopPane
 that previously contained the internal frame.
b - must be true
PropertyVetoException - when the attempt to set the 
            property is vetoed by the JInternalFrameisClosed(), 
setDefaultCloseOperation(int), 
dispose(), 
InternalFrameEvent.INTERNAL_FRAME_CLOSINGpublic void setResizable(boolean b)
JInternalFrame can be resized by some
 user action.
b - a boolean, where true means this internal frame can be resizedpublic boolean isResizable()
JInternalFrame can be resized
 by some user action.
true if this internal frame can be resized, false otherwisepublic void setIconifiable(boolean b)
iconable property, 
 which must be true
 for the user to be able to 
 make the JInternalFrame an icon.
 Some look and feels might not implement iconification;
 they will ignore this property.
b - a boolean, where true means this internal frame can be iconifiedpublic boolean isIconifiable()
iconable property,
 which by default is false.
iconable property.setIconifiable(boolean)public boolean isIcon()
JInternalFrame is currently iconified.
true if this internal frame is iconified
public void setIcon(boolean b)
             throws PropertyVetoException
INTERNAL_FRAME_ICONIFIED event.
 If the state changes to de-iconified,
 an INTERNAL_FRAME_DEICONIFIED event is fired.
b - a boolean, where true means to iconify this internal frame and
          false means to de-iconify it
PropertyVetoException - when the attempt to set the 
            property is vetoed by the JInternalFrameInternalFrameEvent.INTERNAL_FRAME_ICONIFIED, 
InternalFrameEvent.INTERNAL_FRAME_DEICONIFIEDpublic void setMaximizable(boolean b)
maximizable property,
 which determines whether the JInternalFrame
 can be maximized by
 some user action.
 Some look and feels might not support maximizing internal frames;
 they will ignore this property.
b - true to specify that this internal frame should be maximizable; false to specify that it should not bepublic boolean isMaximizable()
maximizable property.
maximizable propertysetMaximizable(boolean)public boolean isMaximum()
JInternalFrame is currently maximized.
true if this internal frame is maximized, false otherwise
public void setMaximum(boolean b)
                throws PropertyVetoException
JDesktopPane area associated with the
 JInternalFrame.
 A restored frame's size is set to the JInternalFrame's
 actual size.
b - a boolean, where true maximizes this internal frame and false
           restores it
PropertyVetoException - when the attempt to set the 
            property is vetoed by the JInternalFramepublic String getTitle()
JInternalFrame.
String containing this internal frame's titlesetTitle(java.lang.String)public void setTitle(String title)
JInternalFrame title. title
 may have a null value.
title - the String to display in the title bargetTitle()
public void setSelected(boolean selected)
                 throws PropertyVetoException
JInternalFrame normally draws its title bar
 differently if it is
 the selected frame, which indicates to the user that this 
 internal frame has the focus.
 When this method changes the state of the internal frame
 from deselected to selected, it fires an
 InternalFrameEvent.INTERNAL_FRAME_ACTIVATED event.
 If the change is from selected to deselected,
 an InternalFrameEvent.INTERNAL_FRAME_DEACTIVATED event
 is fired.
selected - a boolean, where true means this internal frame
                  should become selected (currently active)
                  and false means it should become deselected
PropertyVetoException - when the attempt to set the 
            property is vetoed by the JInternalFrameComponent.isShowing(), 
InternalFrameEvent.INTERNAL_FRAME_ACTIVATED, 
InternalFrameEvent.INTERNAL_FRAME_DEACTIVATEDpublic boolean isSelected()
JInternalFrame is the
 currently "selected" or active frame.
true if this internal frame is currently selected (active)setSelected(boolean)public void setFrameIcon(Icon icon)
desktopIcon object, which 
 is the image displayed in the JDesktop when
 this internal frame is iconified.
 Passing null to this function is valid,
 but the look and feel
 can choose the
 appropriate behavior for that situation, such as displaying no icon
 or a default icon for the look and feel.
icon - the Icon to display in the title bargetFrameIcon()public Icon getFrameIcon()
Icon displayed in the title barsetFrameIcon(javax.swing.Icon)public void moveToFront()
JLayeredPane.
public void moveToBack()
JLayeredPane.
public void setLayer(Integer layer)
layer - an Integer object specifying this
		frame's desktop layerJLayeredPanepublic void setLayer(int layer)
setLayer(Integer) should be used for
 layer values predefined in JLayeredPane.
 When using setLayer(int), care must be taken not to
 accidentally clash with those values.
layer - an integer specifying this internal frame's desktop layersetLayer(Integer), 
JLayeredPanepublic int getLayer()
Integer object specifying this
		frame's desktop layerJLayeredPanepublic JDesktopPane getDesktopPane()
JDesktop instance. If JInternalFrame
 finds none, the desktopIcon tree is searched.
JDesktopPane this internal frame belongs to,
		or null if none is foundpublic void setDesktopIcon(JInternalFrame.JDesktopIcon d)
JDesktopIcon associated with this
 JInternalFrame.
d - the JDesktopIcon to display on the desktopgetDesktopIcon()public JInternalFrame.JDesktopIcon getDesktopIcon()
JDesktopIcon used when this
 JInternalFrame is iconified.
JDesktopIcon displayed on the desktopsetDesktopIcon(javax.swing.JInternalFrame.JDesktopIcon)public Rectangle getNormalBounds()
JInternalFrame is not in maximized state, returns
 getBounds(); otherwise, returns the bounds that the
 JInternalFrame would be restored to.
Rectangle containing the bounds of this
		frame when in the normal statepublic void setNormalBounds(Rectangle r)
r - the bounds that this internal frame should be restored topublic Component getFocusOwner()
JInternalFrame is active,
 returns the child that has focus.
 Otherwise, returns null.
null if no children have focuspublic Component getMostRecentFocusOwner()
JInternalFrame
 that will receive the
 focus when this JInternalFrame is selected.
 If this JInternalFrame is
 currently selected, this method returns the same component as
 the getFocusOwner method.
 If this JInternalFrame is not selected,
 then the child component that most recently requested focus will be
 returned. If no child component has ever requested focus, then this
 JInternalFrame's initial focusable component is returned.
 If no such
 child exists, then this JInternalFrame's default component
 to focus is returned.
JInternalFrame is selectedgetFocusOwner(), 
isSelectedpublic void restoreSubcomponentFocus()
public void reshape(int x,
                    int y,
                    int width,
                    int height)
reshape in class JComponentx - an integer giving the component's new horizontal position
           measured in pixels from the left of its containery - an integer giving the component's new vertical position,
           measured in pixels from the bottom of its containerwidth - an integer giving the component's new width in pixelsheight - an integer giving the component's new height in pixelsComponent.setBounds(int, int, int, int)public void addInternalFrameListener(InternalFrameListener l)
l - the internal frame listenerpublic void removeInternalFrameListener(InternalFrameListener l)
l - the internal frame listenerpublic InternalFrameListener[] getInternalFrameListeners()
InternalFrameListeners added
 to this JInternalFrame with 
 addInternalFrameListener.
InternalFrameListeners added or an empty
         array if no listeners have been addedaddInternalFrameListener(javax.swing.event.InternalFrameListener)protected void fireInternalFrameEvent(int id)
id - the type of the event being fired; one of the following:
 InternalFrameEvent.INTERNAL_FRAME_OPENED
 InternalFrameEvent.INTERNAL_FRAME_CLOSING
 InternalFrameEvent.INTERNAL_FRAME_CLOSED
 InternalFrameEvent.INTERNAL_FRAME_ICONIFIED
 InternalFrameEvent.INTERNAL_FRAME_DEICONIFIED
 InternalFrameEvent.INTERNAL_FRAME_ACTIVATED
 InternalFrameEvent.INTERNAL_FRAME_DEACTIVATED
 public void doDefaultCloseAction()
INTERNAL_FRAME_CLOSING event
 and then performs the action specified by
 the internal frame's default close operation.
 This method is typically invoked by the 
 look-and-feel-implemented action handler
 for the internal frame's close button.
setDefaultCloseOperation(int), 
InternalFrameEvent.INTERNAL_FRAME_CLOSINGpublic void setDefaultCloseOperation(int operation)
DO_NOTHING_ON_CLOSE 
 windowClosing method
      of a registered InternalFrameListener object.
 HIDE_ON_CLOSE
 DISPOSE_ON_CLOSE
 
 The default value is DISPOSE_ON_CLOSE.
 Before performing the specified close operation,
 the internal frame fires
 an INTERNAL_FRAME_CLOSING event.
operation - one of the following constants defined in 
                  javax.swing.WindowConstants
                  (an interface implemented by
                  JInternalFrame):
                  DO_NOTHING_ON_CLOSE,
                  HIDE_ON_CLOSE, or
                  DISPOSE_ON_CLOSEaddInternalFrameListener(javax.swing.event.InternalFrameListener), 
getDefaultCloseOperation(), 
JComponent.setVisible(boolean), 
dispose(), 
InternalFrameEvent.INTERNAL_FRAME_CLOSINGpublic int getDefaultCloseOperation()
setDefaultCloseOperation(int)public void pack()
JInternalFrame
 to be laid out at their preferred size.  Internal frames that are
 iconized or maximized are first restored and then packed.  If the
 internal frame is unable to be restored its state is not changed
 and will not be packed.
Window.pack()public void show()
INTERNAL_FRAME_OPENED event.
 This method does nothing if the internal frame is already visible.
 Invoking this method 
 has the same result as invoking 
 setVisible(true).
show in class ComponentmoveToFront(), 
setSelected(boolean), 
InternalFrameEvent.INTERNAL_FRAME_OPENED, 
JComponent.setVisible(boolean)public void hide()
hide in class Componentpublic void dispose()
INTERNAL_FRAME_CLOSED event.
 The results of invoking this method are similar to
 setClosed(true),
 but dispose always succeeds in closing
 the internal frame and does not fire 
 an INTERNAL_FRAME_CLOSING event.
InternalFrameEvent.INTERNAL_FRAME_CLOSED, 
JComponent.setVisible(boolean), 
setSelected(boolean), 
setClosed(boolean)public void toFront()
Window.toFront(), 
moveToFront()public void toBack()
Window.toBack(), 
moveToBack()public final void setFocusCycleRoot(boolean focusCycleRoot)
JInternalFrames must always be roots of a focus
 traversal cycle.
setFocusCycleRoot in class ContainerfocusCycleRoot - this value is ignoredisFocusCycleRoot(), 
Container.setFocusTraversalPolicy(java.awt.FocusTraversalPolicy), 
Container.getFocusTraversalPolicy()public final boolean isFocusCycleRoot()
true because all JInternalFrames must be
 roots of a focus traversal cycle.
isFocusCycleRoot in class ContainertruesetFocusCycleRoot(boolean), 
Container.setFocusTraversalPolicy(java.awt.FocusTraversalPolicy), 
Container.getFocusTraversalPolicy()public final Container getFocusCycleRootAncestor()
null because JInternalFrames
 must always be roots of a focus
 traversal cycle.
getFocusCycleRootAncestor in class ComponentnullContainer.isFocusCycleRoot()public final String getWarningString()
null.
nullWindow.getWarningString()protected String paramString()
JInternalFrame.
 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.
paramString in class JComponentJInternalFrameprotected void paintComponent(Graphics g)
paintComponent in class JComponentg - the Graphics object to protectJComponent.paint(java.awt.Graphics), 
ComponentUIpublic AccessibleContext getAccessibleContext()
AccessibleContext associated with this
 JInternalFrame. 
 For internal frames, the AccessibleContext
 takes the form of an 
 AccessibleJInternalFrame object. 
 A new AccessibleJInternalFrame instance is created if necessary.
getAccessibleContext in interface AccessiblegetAccessibleContext in class JComponentAccessibleJInternalFrame that serves as the 
         AccessibleContext of this
         JInternalFrameJInternalFrame.AccessibleJInternalFrame| 
 | JavaTM 2 Platform Std. Ed. v1.4.2 | ||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||||
Copyright 2003 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.