Frame
Name
Frame
Description
The Frame class is a special type of Window that will appear like other high-level programs in your windowing environment. It adds a MenuBar, window title, and window gadgets (like resize, maximize, minimize, window menu) to the basic Window object. Frames are initially invisible; call show() to display them. Frames may also be associated with an Image to be used as an icon. The Frame class includes many constants to represent different cursor styles. All styles aren't necessarily available on any platform. In 1.1, these constants are defined in java.awt.Cursor.
Class Definition
public class java.awt.Frame extends java.awt.Window implements java.awt.MenuContainer {
// Constants public final static int CROSSHAIR_CURSOR;
public final static int DEFAULT_CURSOR;
public final static int E_RESIZE_CURSOR;
public final static int HAND_CURSOR;
public final static int MOVE_CURSOR;
public final static int N_RESIZE_CURSOR;
public final static int NE_RESIZE_CURSOR;
public final static int NW_RESIZE_CURSOR;
public final static int S_RESIZE_CURSOR;
public final static int SE_RESIZE_CURSOR;
public final static int SW_RESIZE_CURSOR;
public final static int TEXT_CURSOR;
public final static int W_RESIZE_CURSOR;
public final static int WAIT_CURSOR; // Constructors public Frame();
public Frame (String title); // Instance Methods public void addNotify();
public synchronized void dispose();
public int getCursorType();
public Image getIconImage();
public MenuBar getMenuBar();
public String getTitle();
public boolean isResizable();
public synchronized void remove (MenuComponent component);
public synchronized void setCursor (int cursorType);
public synchronized void setIconImage (Image image);
public synchronized void setMenuBar (MenuBar bar);
public synchronized void setResizable (boolean resizable);
public synchronized void setTitle (String title); // Protected Instance Methods protected String paramString();
}
Constants
CROSSHAIR_CURSOR
public final static int CROSSHAIR_CURSOR
Constant representing a cursor that looks like a crosshair.
DEFAULT_CURSOR
public final static int DEFAULT_CURSOR
Constant representing the platform's default cursor.
E_RESIZE_CURSOR
public final static int E_RESIZE_CURSOR
Constant representing the cursor for resizing an object on the left.
HAND_CURSOR
public final static int HAND_CURSOR
Constant representing a cursor that looks like a hand.
MOVE_CURSOR
public final static int MOVE_CURSOR
Constant representing a cursor used to move an object.
N_RESIZE_CURSOR
public final static int N_RESIZE_CURSOR
Constant representing a cursor for resizing an object on the top.
NE_RESIZE_CURSOR
public final static int NE_RESIZE_CURSOR
Constant representing a cursor for resizing an object on the top left corner.
NW_RESIZE_CURSOR
public final static int NW_RESIZE_CURSOR
Constant representing a cursor for resizing an object on the top right corner.
S_RESIZE_CURSOR
public final static int S_RESIZE_CURSOR
Constant representing a cursor for resizing an object on the bottom.
SE_RESIZE_CURSOR
public final static int SE_RESIZE_CURSOR
Constant representing a cursor for resizing an object on the bottom left corner.
SW_RESIZE_CURSOR
public final static int SW_RESIZE_CURSOR
Constant representing a cursor for resizing an object on the bottom right corner.
TEXT_CURSOR
public final static int TEXT_CURSOR
Constant representing a cursor used within text.
W_RESIZE_CURSOR
public final static int W_RESIZE_CURSOR
Constant representing a cursor for resizing an object on the right side.
WAIT_CURSOR
public final static int WAIT_CURSOR
Constant representing a cursor that indicates the program is busy.
Constructors
Frame
public Frame()
- Description
- Constructs a
Frameobject, with no title.
public Frame (String title)
- Parameters
-
- title
- Initial title to use for
Frame.
- Description
- Constructs a
Frameobject, with the given title.
Instance Methods
addNotify
public void addNotify()
- Overrides
Window.addNotify()- Description
- Creates
Frame's peer and peers of contained components.
dispose
public synchronized void dispose()
- Overrides
Window.dispose()- Description
- Releases the resources of the
Frame.
getCursorType
public int getCursorType() 
- Returns
- The constant for the current cursor. Replaced by
Component.getCursor()
getIconImage
public Image getIconImage()
- Returns
- The image used as the icon, or
nullif there is no icon for this frame.
getMenuBar
public MenuBar getMenuBar()
- Returns
- The
Frame's current menu bar, ornullif there is no menu bar for this frame.
getTitle
public String getTitle()
- Returns
- The current title for the
Frame, ornullif there is no title for this frame.
isResizable
public boolean isResizable()
- Returns
trueif resizable,falseotherwise.
remove
public synchronized void remove (MenuComponent component)
- Parameters
-
- component
MenuBarto remove fromFrame.
- Implements
MenuContainer.remove()- Description
- Removes
componentfromFrameifcomponentis theFrame's menu bar.
setCursor
public synchronized void setCursor (int cursorType) 
- Parameters
-
- cursorType
- One of
Frame's cursor constants.
- Throws
-
- IllegalArgumentException
- If
cursorTypeinvalid.
- Description
- Changes the cursor of the
Frame. Replaced byComponent.setCursor(Cursor).
setIconImage
public synchronized void setIconImage (Image image)
- Parameters
-
- image
- New image to use for the
Frame's icon.
- Description
- Changes the icon's image for the
Frame.
setMenuBar
public synchronized void setMenuBar (MenuBar bar)
- Parameters
-
- bar
- New
MenuBarto use for theFrame.
- Description
- Changes the menu bar of the
Frame.
setResizable
public synchronized void setResizable (boolean resizable)
- Parameters
-
- resizable
trueto make the frame resizable,falseto prevent resizing.
- Description
- Changes the resize state of the
Frame.
setTitle
public synchronized void setTitle (String title)
- Parameters
-
- title
- New title to use for the
Frame.
- Description
- Changes the title of the
Frame.
Protected Instance Methods
paramString
protected String paramString()
- Returns
- String with current settings of
Frame. - Overrides
Container.paramString()- Description
- Helper method for
toString()to generate a string of current settings.
See Also
Container, Image, MenuBar, MenuContainer, String, Window