java.awt
クラス Frame

java.lang.Object
  java.awt.Component
      java.awt.Container
          java.awt.Window
              java.awt.Frame

すべての実装されたインタフェース:

ImageObserver, MenuContainer, Serializable, Accessible

直系の既知のサブクラス:

JFrame

public class Frame
extends Window
implements MenuContainer

Frame は、タイトルとボーダを持つトップレベルウィンドウです。

フレームのサイズには、ボーダ用として指定された領域が含まれます。ボーダ領域の寸法は getInsets メソッドで取得できます。ただし、ボーダ領域の寸法はプラットフォームに依存するため、pack または show のどちらかを呼び出すことによりフレームを表示可能にしなければ正確なインセット値は取得できません。ボーダ領域はフレーム全体のサイズに含まれているため、フレームの一部がボーダに隠れてしまいます。このため、サブコンポーネントを描画および表示するための領域は、左上隅の位置が (insets.left, insets.top) であり、幅が width - (insets.left + insets.right)、高さが height - (insets.top + insets.bottom) の矩形に制限されます。

フレームのデフォルトレイアウトは、BorderLayout です。

フレームはネイティブな装飾 (Frame と Titlebar) を持つことができ、setUndecorated でこれを無効化できます。フレームが displayable の状態でないときにだけ無効化できます。

マルチスクリーン環境では、Frame(GraphicsConfiguration) または Frame(String title, GraphicsConfiguration) で Frame を構築し、別々のスクリーンデバイス上に Frame を生成できます。GraphicsConfiguration オブジェクトはターゲットスクリーンデバイスの GraphicsConfiguration オブジェクトの 1 つです。

デスクトップエリアが、物理的に複数のスクリーンデバイスにまたがる仮想デバイスマルチスクリーン環境では、すべての設定の境界は仮想座標体系を基準にしています。仮想座標体系の原点は物理的なプライマリスクリーンの左上隅にあります。仮想デバイスのプライマリスクリーンの位置によっては、次の図に示すとおり負の座標も使用できます。

そのような環境では、setLocation を呼び出すにはこのメソッドに仮想座標を渡す必要があります。同様に、Frame 上で getLocationOnScreen を呼び出すと、仮想デバイス座標を返します。仮想座標体系の原点を検索するには、GraphicsConfiguration の getBounds メソッドを呼び出します。

次のコードでは、Frame の位置を対応する GraphicsConfiguration の物理的スクリーンの原点を基準にして (10, 10) に設定します。GraphicsConfiguration の境界が考慮されない場合は、Frame の位置は仮想座標体系を基準に (10, 10) に設定され、指定された GraphicsConfiguration の物理的スクリーンとは異なり、物理的なプライマリスクリーンに表示されます。

      Frame f = new Frame(GraphicsConfiguration gc);
      Rectangle bounds = gc.getBounds();
      f.setLocation(10 + bounds.x, 10 + bounds.y);
 

フレームは次の型の WindowEvent を生成できます。

• WINDOW_OPENED
• WINDOW_CLOSING:
  このイベントを処理する際に、プログラムが明示的にウィンドウの非表示も破棄も行わない場合、ウィンドウクローズの操作は取り消されます。
• WINDOW_CLOSED
• WINDOW_ICONIFIED
• WINDOW_DEICONIFIED
• WINDOW_ACTIVATED
• WINDOW_DEACTIVATED
• WINDOW_GAINED_FOCUS
• WINDOW_LOST_FOCUS
• WINDOW_STATE_CHANGED

導入されたバージョン:

JDK1.0

関連項目:

WindowEvent, Window.addWindowListener(java.awt.event.WindowListener), 直列化された形式

入れ子のクラスの概要

protected class

Frame.AccessibleAWTFrame このクラスは Frame クラス用のユーザ補助機能のサポートを実装しています。

クラス java.awt.Window から継承された入れ子のクラス/インタフェース

Window.AccessibleAWTWindow

クラス java.awt.Container から継承された入れ子のクラス/インタフェース

Container.AccessibleAWTContainer

クラス java.awt.Component から継承された入れ子のクラス/インタフェース

Component.AccessibleAWTComponent, Component.BltBufferStrategy, Component.FlipBufferStrategy

フィールドの概要

static int	CROSSHAIR_CURSOR 推奨されていません。 Cursor.CROSSHAIR_CURSOR で置き換えられています。
static int	DEFAULT_CURSOR 推奨されていません。 Cursor.DEFAULT_CURSOR で置き換えられています。
static int	E_RESIZE_CURSOR 推奨されていません。 Cursor.E_RESIZE_CURSOR で置き換えられています。
static int	HAND_CURSOR 推奨されていません。 Cursor.HAND_CURSOR で置き換えられています。
static int	ICONIFIED この状態ビットはフレームがアイコン化されていることを示します。
static int	MAXIMIZED_BOTH この状態ビットマスクは、フレームが全画面表示、つまり水平および垂直の両方向で最大化されていることを示します。
static int	MAXIMIZED_HORIZ この状態ビットはフレームが水平方向に最大化されていることを示します。
static int	MAXIMIZED_VERT この状態ビットはフレームが垂直方向に最大化されていることを示します。
static int	MOVE_CURSOR 推奨されていません。 Cursor.MOVE_CURSOR で置き換えられています。
static int	N_RESIZE_CURSOR 推奨されていません。 Cursor.N_RESIZE_CURSOR で置き換えられています。
static int	NE_RESIZE_CURSOR 推奨されていません。 Cursor.NE_RESIZE_CURSOR で置き換えられています。
static int	NORMAL フレームが「通常の」状態です。
static int	NW_RESIZE_CURSOR 推奨されていません。 Cursor.NW_RESIZE_CURSOR で置き換えられています。
static int	S_RESIZE_CURSOR 推奨されていません。 Cursor.S_RESIZE_CURSOR で置き換えられています。
static int	SE_RESIZE_CURSOR 推奨されていません。 Cursor.SE_RESIZE_CURSOR で置き換えられています。
static int	SW_RESIZE_CURSOR 推奨されていません。 Cursor.SW_RESIZE_CURSOR で置き換えられています。
static int	TEXT_CURSOR 推奨されていません。 Cursor.TEXT_CURSOR で置き換えられています。
static int	W_RESIZE_CURSOR 推奨されていません。 Cursor.W_RESIZE_CURSOR で置き換えられています。
static int	WAIT_CURSOR 推奨されていません。 Cursor.WAIT_CURSOR で置き換えられています。

クラス java.awt.Component から継承されたフィールド

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

インタフェース java.awt.image.ImageObserver から継承されたフィールド

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

コンストラクタの概要

Frame()
初期状態で可視ではない Frame の新しいインスタンスを生成します。

Frame(GraphicsConfiguration gc)
スクリーンデバイスの指定した GraphicsConfiguration がある Frame を生成します。

Frame(String title)
指定されたタイトルで、初期状態で可視ではない新しい Frame オブジェクトを構築します。

Frame(String title, GraphicsConfiguration gc)
指定されたタイトルと GraphicsConfiguration で、最初は不可視である新しい Frame オブジェクトを構築します。

メソッドの概要

void	addNotify() ネイティブスクリーンリソースに接続することにより、この Frame を表示可能にします。
protected void	finalize() 入力メソッドとコンテキストを破棄し、AppContext から Frame を削除します。
AccessibleContext	getAccessibleContext() このフレームに関連した AccessibleContext を返します。
int	getCursorType() 推奨されていません。 JDK バージョン 1.1 以降は、Component.getCursor() に置き換えられました。
int	getExtendedState() このフレームの状態をビットマスクで返します。
static Frame[]	getFrames() アプリケーションで生成されたすべての Frame を格納する配列を返します。
Image	getIconImage() このフレームの最小化されたアイコンに表示されるイメージを返します。
Rectangle	getMaximizedBounds() このフレームが最大化された境界を取得します。
MenuBar	getMenuBar() このフレームのメニューバーを返します。
int	getState() このフレームの状態を返します (現在は使用されません)。
String	getTitle() フレームのタイトルを返します。
boolean	isResizable() ユーザがこのフレームのサイズを変更できるかどうかを示します。
boolean	isUndecorated() このフレームが装飾を持たないことを示します。
protected String	paramString() この Frame の状態を表す文字列を返します。
void	remove(MenuComponent m) 指定されたメニューバーをこのフレームから削除します。
void	removeNotify() ネイティブスクリーンリソースへの接続を削除することにより、この Frame を非表示にします。
void	setCursor(int cursorType) 推奨されていません。 JDK バージョン 1.1 以降は、Component.setCursor(Cursor) に置き換えられました。
void	setExtendedState(int state) このフレームの状態をビットマスクで設定します。
void	setIconImage(Image image) このフレームの最小化されたアイコンに表示されるイメージを設定します。
void	setMaximizedBounds(Rectangle bounds) このフレームの最大化された境界を設定します。
void	setMenuBar(MenuBar mb) このフレームのメニューバーを、指定されたメニューバーに設定します。
void	setResizable(boolean resizable) ユーザがこのフレームのサイズを変更できるかどうかを設定します。
void	setState(int state) このフレームの状態を設定します (現在は使用されません)。
void	setTitle(String title) このフレームのタイトルを、指定された文字列に設定します。
void	setUndecorated(boolean undecorated) このフレームの装飾の有効化と無効化を切り替えます。

クラス java.awt.Window から継承されたメソッド

addPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, dispose, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getGraphicsConfiguration, getInputContext, getListeners, getLocale, getMostRecentFocusOwner, getOwnedWindows, getOwner, getToolkit, getWarningString, getWindowFocusListeners, getWindowListeners, getWindowStateListeners, hide, isActive, isAlwaysOnTop, isFocusableWindow, isFocusCycleRoot, isFocused, isLocationByPlatform, isShowing, pack, postEvent, processEvent, processWindowEvent, processWindowFocusEvent, processWindowStateEvent, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, setAlwaysOnTop, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setLocationByPlatform, setLocationRelativeTo, show, toBack, toFront

クラス java.awt.Container から継承されたメソッド

add, add, add, add, add, addContainerListener, addImpl, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalPolicy, getInsets, getLayout, getMaximumSize, getMinimumSize, getMousePosition, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paint, paintComponents, preferredSize, print, printComponents, processContainerEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, setLayout, transferFocusBackward, transferFocusDownCycle, update, validate, validateTree

クラス java.awt.Component から継承されたメソッド

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, setBackground, setBounds, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, setVisible, show, size, toString, transferFocus, transferFocusUpCycle

クラス java.lang.Object から継承されたメソッド

clone, equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

インタフェース java.awt.MenuContainer から継承されたメソッド

getFont, postEvent

フィールドの詳細

DEFAULT_CURSOR

@Deprecated
public static final int DEFAULT_CURSOR

推奨されていません。 Cursor.DEFAULT_CURSOR で置き換えられています。

関連項目:

定数フィールド値

CROSSHAIR_CURSOR

@Deprecated
public static final int CROSSHAIR_CURSOR

推奨されていません。 Cursor.CROSSHAIR_CURSOR で置き換えられています。

関連項目:

定数フィールド値

TEXT_CURSOR

@Deprecated
public static final int TEXT_CURSOR

推奨されていません。 Cursor.TEXT_CURSOR で置き換えられています。

関連項目:

定数フィールド値

WAIT_CURSOR

@Deprecated
public static final int WAIT_CURSOR

推奨されていません。 Cursor.WAIT_CURSOR で置き換えられています。

関連項目:

定数フィールド値

SW_RESIZE_CURSOR

@Deprecated
public static final int SW_RESIZE_CURSOR

推奨されていません。 Cursor.SW_RESIZE_CURSOR で置き換えられています。

関連項目:

定数フィールド値

SE_RESIZE_CURSOR

@Deprecated
public static final int SE_RESIZE_CURSOR

推奨されていません。 Cursor.SE_RESIZE_CURSOR で置き換えられています。

関連項目:

定数フィールド値

NW_RESIZE_CURSOR

@Deprecated
public static final int NW_RESIZE_CURSOR

推奨されていません。 Cursor.NW_RESIZE_CURSOR で置き換えられています。

関連項目:

定数フィールド値

NE_RESIZE_CURSOR

@Deprecated
public static final int NE_RESIZE_CURSOR

推奨されていません。 Cursor.NE_RESIZE_CURSOR で置き換えられています。

関連項目:

定数フィールド値

N_RESIZE_CURSOR

@Deprecated
public static final int N_RESIZE_CURSOR

推奨されていません。 Cursor.N_RESIZE_CURSOR で置き換えられています。

関連項目:

定数フィールド値

S_RESIZE_CURSOR

@Deprecated
public static final int S_RESIZE_CURSOR

推奨されていません。 Cursor.S_RESIZE_CURSOR で置き換えられています。

関連項目:

定数フィールド値

W_RESIZE_CURSOR

@Deprecated
public static final int W_RESIZE_CURSOR

推奨されていません。 Cursor.W_RESIZE_CURSOR で置き換えられています。

関連項目:

定数フィールド値

E_RESIZE_CURSOR

@Deprecated
public static final int E_RESIZE_CURSOR

推奨されていません。 Cursor.E_RESIZE_CURSOR で置き換えられています。

関連項目:

定数フィールド値

HAND_CURSOR

@Deprecated
public static final int HAND_CURSOR

推奨されていません。 Cursor.HAND_CURSOR で置き換えられています。

関連項目:

定数フィールド値

MOVE_CURSOR

@Deprecated
public static final int MOVE_CURSOR

推奨されていません。 Cursor.MOVE_CURSOR で置き換えられています。

関連項目:

定数フィールド値

NORMAL

public static final int NORMAL

フレームが「通常の」状態です。この記号定数は、すべての状態ビットがクリアされた、フレームの状態を示します。

関連項目:

setExtendedState(int), getExtendedState(), 定数フィールド値

ICONIFIED

public static final int ICONIFIED

この状態ビットはフレームがアイコン化されていることを示します。

関連項目:

setExtendedState(int), getExtendedState(), 定数フィールド値

MAXIMIZED_HORIZ

public static final int MAXIMIZED_HORIZ

この状態ビットはフレームが水平方向に最大化されていることを示します。

導入されたバージョン:

1.4

関連項目:

setExtendedState(int), getExtendedState(), 定数フィールド値

MAXIMIZED_VERT

public static final int MAXIMIZED_VERT

この状態ビットはフレームが垂直方向に最大化されていることを示します。

導入されたバージョン:

1.4

関連項目:

setExtendedState(int), getExtendedState(), 定数フィールド値

MAXIMIZED_BOTH

public static final int MAXIMIZED_BOTH

この状態ビットマスクは、フレームが全画面表示、つまり水平および垂直の両方向で最大化されていることを示します。これは MAXIMIZED_VERT | MAXIMIZED_HORIZ の簡易エイリアスです。

フレームが全画面表示されているかどうかを正しく判定するコーディングはこうなります。

     (state & Frame.MAXIMIZED_BOTH) == Frame.MAXIMIZED_BOTH
 

フレームが「水平または垂直のどちらかで」最大化されているかどうかを判定するコーディングは次のようになります。

     (state & Frame.MAXIMIZED_BOTH) != 0
 

導入されたバージョン:

1.4

関連項目:

setExtendedState(int), getExtendedState(), 定数フィールド値

コンストラクタの詳細

Frame

public Frame()
      throws HeadlessException

初期状態で可視ではない Frame の新しいインスタンスを生成します。Frame のタイトルは空です。

例外:

HeadlessException - GraphicsEnvironment.isHeadless() が true の場合

関連項目:

GraphicsEnvironment.isHeadless(), Component.setSize(int, int), Component.setVisible(boolean)

Frame

public Frame(GraphicsConfiguration gc)

スクリーンデバイスの指定した GraphicsConfiguration がある Frame を生成します。

パラメータ:

gc - ターゲットスクリーンデバイスの GraphicsConfiguration。gc が null の場合は、GraphicsConfiguration をデフォルトとみなす

例外:

IllegalArgumentException - gc がスクリーンデバイスからの値ではない場合。GraphicsEnvironment.isHeadless() が true の場合、常にこの例外がスローされる

導入されたバージョン:

1.3

関連項目:

GraphicsEnvironment.isHeadless()

Frame

public Frame(String title)
      throws HeadlessException

指定されたタイトルで、初期状態で可視ではない新しい Frame オブジェクトを構築します。

パラメータ:

title - フレームのボーダに表示されるタイトル。null 値は、空の文字列 "" と見なされる

例外:

HeadlessException - GraphicsEnvironment.isHeadless() が true の場合

関連項目:

GraphicsEnvironment.isHeadless(), Component.setSize(int, int), Component.setVisible(boolean), GraphicsConfiguration.getBounds()

Frame

public Frame(String title,
             GraphicsConfiguration gc)

指定されたタイトルと GraphicsConfiguration で、最初は不可視である新しい Frame オブジェクトを構築します。

パラメータ:

title - フレームのボーダに表示されるタイトル。null 値は、空の文字列 "" と見なされる

gc - ターゲットスクリーンデバイスの GraphicsConfiguration。gc が null の場合は、GraphicsConfiguration をデフォルトとみなす

例外:

IllegalArgumentException - gc がスクリーンデバイスからの値ではない場合。GraphicsEnvironment.isHeadless() が true の場合、常にこの例外がスローされる

関連項目:

GraphicsEnvironment.isHeadless(), Component.setSize(int, int), Component.setVisible(boolean), GraphicsConfiguration.getBounds()

メソッドの詳細

finalize

protected void finalize()
                 throws Throwable

入力メソッドとコンテキストを破棄し、AppContext から Frame を削除します。このメソッドをオーバーライドするサブクラスは、super.finalize() を呼び出す必要があります。

オーバーライド:

クラス Window 内の finalize

例外:

Throwable - このメソッドで生じた Exception

addNotify

public void addNotify()

ネイティブスクリーンリソースに接続することにより、この Frame を表示可能にします。フレームを表示可能にすると、そのフレームのすべての子も表示可能になります。このメソッドは、ツールキットによって内部で呼び出され、プログラムから直接呼び出されることはありません。

オーバーライド:

クラス Window 内の addNotify

関連項目:

Component.isDisplayable(), removeNotify()

getTitle

public String getTitle()

フレームのタイトルを返します。タイトルは、フレームのボーダに表示されます。

戻り値:

このフレームのタイトル。このフレームがタイトルを持たない場合は、空の文字列 ("")

関連項目:

setTitle(String)

setTitle

public void setTitle(String title)

このフレームのタイトルを、指定された文字列に設定します。

パラメータ:

title - フレームのボーダに表示されるタイトル。null 値は、空の文字列 "" と見なされる

関連項目:

getTitle()

getIconImage

public Image getIconImage()

このフレームの最小化されたアイコンに表示されるイメージを返します。

戻り値:

このフレームのアイコンイメージ。このフレームがアイコンイメージを持たない場合は null

関連項目:

setIconImage(Image)

setIconImage

public void setIconImage(Image image)

このフレームの最小化されたアイコンに表示されるイメージを設定します。プラットフォームによっては、ウィンドウの最小化はサポートされません。

パラメータ:

image - 表示されるアイコンイメージ。このパラメータが null の場合、アイコンイメージはデフォルトのイメージ (プラットフォームによって異なる) に設定される

関連項目:

getIconImage()

getMenuBar

public MenuBar getMenuBar()

このフレームのメニューバーを返します。

戻り値:

このフレームのメニューバー。このフレームがメニューバーを持たない場合は null

関連項目:

setMenuBar(MenuBar)

setMenuBar

public void setMenuBar(MenuBar mb)

このフレームのメニューバーを、指定されたメニューバーに設定します。

パラメータ:

mb - 設定されるメニューバー。このパラメータが null の場合、フレーム上の既存のメニューバーはすべて削除される

関連項目:

getMenuBar()

isResizable

public boolean isResizable()

ユーザがこのフレームのサイズを変更できるかどうかを示します。デフォルトでは、すべてのフレームが初期状態でサイズ変更可能です。

戻り値:

ユーザがこのフレームのサイズを変更できる場合は true、そうでない場合は false

関連項目:

setResizable(boolean)

setResizable

public void setResizable(boolean resizable)

ユーザがこのフレームのサイズを変更できるかどうかを設定します。

パラメータ:

resizable - このフレームがサイズ変更可能な場合は true、そうでない場合は false

関連項目:

isResizable()

setState

public void setState(int state)

このフレームの状態を設定します (現在は使用されません)。

旧バージョンの JDK では、フレームの状態は NORMAL か ICONIFIED のどちらかでした。JDK 1.4 からはより多くのフレーム状態がサポートされ、ビットマスクで状態が表されるようになりました。

以前のプログラムとの互換性のため、このメソッドは Frame.NORMAL と Frame.ICONIFIED を受け付けますが、これはフレームのアイコン化の状態だけを変更し、フレームが他の状態の場合は影響を受けません。

パラメータ:

state - Frame.NORMAL または Frame.ICONIFIED のどちらか

関連項目:

getState(), setExtendedState(int)

setExtendedState

public void setExtendedState(int state)

このフレームの状態をビットマスクで設定します。

• NORMAL
  状態ビットが設定されていないことを示す
• ICONIFIED
• MAXIMIZED_HORIZ
• MAXIMIZED_VERT
• MAXIMIZED_BOTH
MAXIMIZED_HORIZ と MAXIMIZED_VERT を連結する

ある状態がプラットフォームでサポートされていない場合は何も起こりません。特定の状態が有効かどうかは java.awt.Toolkit#isFrameStateSupported(int state) メソッドで判定できます。

パラメータ:

state - フレームの状態定数のビットマスク

導入されたバージョン:

1.4

関連項目:

getExtendedState(), Toolkit.isFrameStateSupported(int)

getState

public int getState()

このフレームの状態を返します (現在は使用されません)。

旧バージョンの JDK では、フレームの状態は NORMAL か ICONIFIED のどちらかでした。JDK 1.4 からはより多くのフレーム状態がサポートされ、ビットマスクで状態が表されるようになりました。

以前のプログラムとの互換性のため、このメソッドは Frame.NORMAL と Frame.ICONIFIED を受け付けますが、これはフレームのアイコン化の状態だけをレポートし、フレームが他の状態の場合はレポートされません。

戻り値:

Frame.NORMAL または Frame.ICONIFIED のどちらか

関連項目:

setState(int), getExtendedState()

getExtendedState

public int getExtendedState()

このフレームの状態をビットマスクで返します。

• NORMAL
  状態ビットが設定されていないことを示す
• ICONIFIED
• MAXIMIZED_HORIZ
• MAXIMIZED_VERT
• MAXIMIZED_BOTH
MAXIMIZED_HORIZ と MAXIMIZED_VERT を連結する

戻り値:

フレームの状態定数のビットマスク

導入されたバージョン:

1.4

関連項目:

setExtendedState(int)

setMaximizedBounds

public void setMaximizedBounds(Rectangle bounds)

このフレームの最大化された境界を設定します。

フレームが最大化された状態にあるときには、デフォルトの境界が提供されます。このメソッドを使用すると、システムで提供されているこれらの値をオーバーライドすることができます。

bounds が null の場合、システムで提供されている境界が使用されます。null でない場合は、システム提供の値を使用するフィールドに Integer.MAX_VALUE を設定すると、その項目についてはシステム提供の値を使用し、それ以外のフィールドの値をオーバーライドすることができます。

システムによっては境界のサイズの部分のみが考慮されます。

パラメータ:

bounds - 最大化された状態で使用される境界

導入されたバージョン:

1.4

関連項目:

getMaximizedBounds()

getMaximizedBounds

public Rectangle getMaximizedBounds()

このフレームが最大化された境界を取得します。Integer.MAX_VALUE を格納するフィールドは、このフィールドのシステム提供の値を使用する必要があることを示します。

戻り値:

このフレームの最大化された境界。null も可能

導入されたバージョン:

1.4

関連項目:

setMaximizedBounds(Rectangle)

setUndecorated

public void setUndecorated(boolean undecorated)

このフレームの装飾の有効化と無効化を切り替えます。フレームが表示されていない時にだけ呼び出すことができます。

パラメータ:

undecorated - 有効化できるフレーム装飾がない場合は true、ある場合は false

例外:

IllegalComponentStateException - フレームが表示可能な場合

導入されたバージョン:

1.4

関連項目:

isUndecorated(), Component.isDisplayable(), JFrame.setDefaultLookAndFeelDecorated(boolean)

isUndecorated

public boolean isUndecorated()

このフレームが装飾を持たないことを示します。デフォルトではすべてのフレームが装飾を持ちます。

戻り値:

このフレームが装飾を持たない場合は true、持つ場合は false

導入されたバージョン:

1.4

関連項目:

setUndecorated(boolean)

remove

public void remove(MenuComponent m)

指定されたメニューバーをこのフレームから削除します。

定義:

インタフェース MenuContainer 内の remove

オーバーライド:

クラス Component 内の remove

パラメータ:

m - 削除対象のメニューコンポーネント。m が null の場合、アクションは実行されない

関連項目:

Component.add(PopupMenu)

removeNotify

public void removeNotify()

ネイティブスクリーンリソースへの接続を削除することにより、この Frame を非表示にします。Frame が非表示になると、そのフレームのすべての子も非表示になります。このメソッドは、ツールキットによって内部で呼び出され、プログラムから直接呼び出されることはありません。

オーバーライド:

クラス Container 内の removeNotify

関連項目:

Component.isDisplayable(), addNotify()

paramString

protected String paramString()

この Frame の状態を表す文字列を返します。このメソッドは、デバッグ専用であり、返される文字列の内容および形式は実装によって異なります。返される文字列は空白の場合がありますが、null にはなりません。

オーバーライド:

クラス Container 内の paramString

戻り値:

このフレームのパラメータ文字列

setCursor

@Deprecated
public void setCursor(int cursorType)

推奨されていません。 JDK バージョン 1.1 以降は、Component.setCursor(Cursor) に置き換えられました。

getCursorType

@Deprecated
public int getCursorType()

推奨されていません。 JDK バージョン 1.1 以降は、Component.getCursor() に置き換えられました。

getFrames

public static Frame[] getFrames()

アプリケーションで生成されたすべての Frame を格納する配列を返します。アプレットから呼び出された場合、配列にはそのアプレットがアクセスできる Frame だけが格納されます。

導入されたバージョン:

1.2

getAccessibleContext

public AccessibleContext getAccessibleContext()

このフレームに関連した AccessibleContext を返します。フレームの場合、AccessibleContext は AccessibleAWTFrame の形式を取ります。必要に応じて新規の AccessibleAWTFrame インスタンスが生成されます。

定義:

インタフェース Accessible 内の getAccessibleContext

オーバーライド:

クラス Window 内の getAccessibleContext

戻り値:

このフレームの AccessibleContext として機能する AccessibleAWTFrame