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
Frame
object, with no title.
public Frame (String title)
- Parameters
-
- title
- Initial title to use for
Frame
.
- Description
- Constructs a
Frame
object, 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
null
if there is no icon for this frame.
getMenuBar
public MenuBar getMenuBar()
- Returns
- The
Frame
's current menu bar, ornull
if there is no menu bar for this frame.
getTitle
public String getTitle()
- Returns
- The current title for the
Frame
, ornull
if there is no title for this frame.
isResizable
public boolean isResizable()
- Returns
true
if resizable,false
otherwise.
remove
public synchronized void remove (MenuComponent component)
- Parameters
-
- component
MenuBar
to remove fromFrame
.
- Implements
MenuContainer.remove()
- Description
- Removes
component
fromFrame
ifcomponent
is theFrame
's menu bar.
setCursor
public synchronized void setCursor (int cursorType) 
- Parameters
-
- cursorType
- One of
Frame
's cursor constants.
- Throws
-
- IllegalArgumentException
- If
cursorType
invalid.
- 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
MenuBar
to use for theFrame
.
- Description
- Changes the menu bar of the
Frame
.
setResizable
public synchronized void setResizable (boolean resizable)
- Parameters
-
- resizable
true
to make the frame resizable,false
to 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