java.awt
クラス Frame

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.Container
              |
              +--java.awt.Window
                    |
                    +--java.awt.Frame

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

Accessible, ImageObserver, MenuContainer, Serializable

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

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(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);

フレームには、タイプが WindowOpened、WindowClosing、WindowClosed、WindowIconified、WindowDeiconified、WindowActivated、WindowDeactivated のウィンドウイベントを生成する機能があります。

導入されたバージョン:

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

フィールドの概要

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	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() Vector 中の weakThis への (ハードな) 参照を削除しなければなりません。
AccessibleContext	getAccessibleContext() この Frame と関連した AccessibleContext を返します。
int	getCursorType() 推奨されていません。 JDK バージョン 1.1 以降は、Component.getCursor() に置き換えられました。
static Frame[]	getFrames() アプリケーションで作成されたすべての Frame を格納する配列を返します。
Image	getIconImage() このフレームの最小化されたアイコンに表示されるイメージを返します。
MenuBar	getMenuBar() このフレームのメニューバーを返します。
int	getState() このフレームの状態を返します。
String	getTitle() フレームのタイトルを返します。
boolean	isResizable() ユーザがこのフレームのサイズを変更できるかどうかを示します。
protected String	paramString() このフレームのパラメータ文字列を返します。
void	remove(MenuComponent m) 指定されたメニューバーをこのフレームから削除します。
void	removeNotify() ネイティブスクリーンリソースへの接続を削除することにより、この Frame を表示できなくします。
void	setCursor(int cursorType) 推奨されていません。 JDK バージョン 1.1 以降は、Component.setCursor(Cursor) に置き換えられました。
void	setIconImage(Image image) このフレームの最小化されたアイコンに表示されるイメージを設定します。
void	setMenuBar(MenuBar mb) このフレームのメニューバーを、指定されたメニューバーに設定します。
void	setResizable(boolean resizable) ユーザがこのフレームのサイズを変更できるかどうかを設定します。
void	setState(int state) このフレームの状態を設定します。
void	setTitle(String title) このフレームのタイトルを、指定された文字列に設定します。

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

addWindowListener, applyResourceBundle, applyResourceBundle, dispose, getFocusOwner, getGraphicsConfiguration, getInputContext, getListeners, getLocale, getOwnedWindows, getOwner, getToolkit, getWarningString, hide, isShowing, pack, postEvent, processEvent, processWindowEvent, removeWindowListener, setCursor, show, toBack, toFront

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

add, add, add, add, add, addContainerListener, addImpl, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getInsets, getLayout, getMaximumSize, getMinimumSize, getPreferredSize, insets, invalidate, isAncestorOf, layout, list, list, locate, minimumSize, paint, paintComponents, preferredSize, print, printComponents, processContainerEvent, remove, remove, removeAll, removeContainerListener, setFont, setLayout, update, validate, validateTree

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

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addPropertyChangeListener, addPropertyChangeListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, getBackground, getBounds, getBounds, getColorModel, getComponentOrientation, getCursor, getDropTarget, getFont, getFontMetrics, getForeground, getGraphics, getHeight, getInputMethodRequests, getLocation, getLocation, getLocationOnScreen, getName, getParent, getPeer, getSize, getSize, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isDisplayable, isDoubleBuffered, isEnabled, isFocusTraversable, isLightweight, isOpaque, 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, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, reshape, resize, resize, setBackground, setBounds, setBounds, setComponentOrientation, setDropTarget, setEnabled, setForeground, setLocale, setLocation, setLocation, setName, setSize, setSize, setVisible, show, size, toString, transferFocus

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

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

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

getFont, postEvent

フィールドの詳細

DEFAULT_CURSOR

public static final int DEFAULT_CURSOR

推奨されていません。 Cursor.DEFAULT_CURSOR に置き換えられました。

CROSSHAIR_CURSOR

public static final int CROSSHAIR_CURSOR

推奨されていません。 Cursor.CROSSHAIR_CURSOR に置き換えられました。

TEXT_CURSOR

public static final int TEXT_CURSOR

推奨されていません。 Cursor.TEXT_CURSOR に置き換えられました。

WAIT_CURSOR

public static final int WAIT_CURSOR

推奨されていません。 Cursor.WAIT_CURSOR に置き換えられました。

SW_RESIZE_CURSOR

public static final int SW_RESIZE_CURSOR

推奨されていません。 Cursor.SW_RESIZE_CURSOR に置き換えられました。

SE_RESIZE_CURSOR

public static final int SE_RESIZE_CURSOR

推奨されていません。 Cursor.SE_RESIZE_CURSOR に置き換えられました。

NW_RESIZE_CURSOR

public static final int NW_RESIZE_CURSOR

推奨されていません。 Cursor.NW_RESIZE_CURSOR に置き換えられました。

NE_RESIZE_CURSOR

public static final int NE_RESIZE_CURSOR

推奨されていません。 Cursor.NE_RESIZE_CURSOR に置き換えられました。

N_RESIZE_CURSOR

public static final int N_RESIZE_CURSOR

推奨されていません。 Cursor.N_RESIZE_CURSOR に置き換えられました。

S_RESIZE_CURSOR

public static final int S_RESIZE_CURSOR

推奨されていません。 Cursor.S_RESIZE_CURSOR に置き換えられました。

W_RESIZE_CURSOR

public static final int W_RESIZE_CURSOR

推奨されていません。 Cursor.W_RESIZE_CURSOR に置き換えられました。

E_RESIZE_CURSOR

public static final int E_RESIZE_CURSOR

推奨されていません。 Cursor.E_RESIZE_CURSOR に置き換えられました。

HAND_CURSOR

public static final int HAND_CURSOR

推奨されていません。 Cursor.HAND_CURSOR に置き換えられました。

MOVE_CURSOR

public static final int MOVE_CURSOR

推奨されていません。 Cursor.MOVE_CURSOR に置き換えられました。

NORMAL

public static final int NORMAL

ICONIFIED

public static final int ICONIFIED

コンストラクタの詳細

Frame

public Frame()

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

関連項目:

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

Frame

public Frame(GraphicsConfiguration gc)

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

パラメータ:

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

例外:

IllegalArgumentException - gc がスクリーンデバイスのものではない場合

導入されたバージョン:

1.3

Frame

public Frame(String title)

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

パラメータ:

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

例外:

IllegalArgumentException - gc がスクリーンデバイスでない場合

関連項目:

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 がスクリーンデバイスのものではない場合

関連項目:

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

メソッドの詳細

finalize

protected void finalize()
                 throws Throwable

Vector 中の weakThis への (ハードな) 参照を削除しなければなりません。そうでない場合、WeakReference のインスタンスはガベージとして収集されません。

オーバーライド:

クラス Window 内の finalize

クラス java.lang.Object からコピーされたタグ:

例外:

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

addNotify

public void addNotify()

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

オーバーライド:

クラス Window 内の addNotify

関連項目:

Component.isDisplayable(), removeNotify()

getTitle

public String getTitle()

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

戻り値:

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

関連項目:

setTitle(java.lang.String)

setTitle

public void setTitle(String title)

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

パラメータ:

title - フレームのボーダに表示するタイトル

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

関連項目:

getTitle()

getIconImage

public Image getIconImage()

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

戻り値:

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

関連項目:

setIconImage(java.awt.Image)

setIconImage

public void setIconImage(Image image)

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

パラメータ:

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

関連項目:

getIconImage()

getMenuBar

public MenuBar getMenuBar()

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

戻り値:

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

関連項目:

setMenuBar(java.awt.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)

このフレームの状態を設定します。

パラメータ:

state - このフレームがアイコン状態の場合は Frame.ICONIFIED、このフレームが通常の状態の場合は Frame.NORMAL

関連項目:

getState()

getState

public int getState()

このフレームの状態を返します。

戻り値:

フレームがアイコン状態の場合は Frame.ICONIFIED、フレームが通常の状態の場合は Frame.NORMAL

関連項目:

setState(int)

remove

public void remove(MenuComponent m)

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

定義:

インタフェース MenuContainer 内の remove

オーバーライド:

クラス Component 内の remove

パラメータ:

m - 削除されるメニューコンポーネント。このパラメータが null の場合、NullPointerException がスローされ、処理は実行されない

removeNotify

public void removeNotify()

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

オーバーライド:

クラス Container 内の removeNotify

関連項目:

Component.isDisplayable(), addNotify()

paramString

protected String paramString()

このフレームのパラメータ文字列を返します。

オーバーライド:

クラス Container 内の paramString

クラス java.awt.Container からコピーされたタグ:

戻り値:

このコンテナのパラメータ文字列

setCursor

public void setCursor(int cursorType)

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

getCursorType

public int getCursorType()

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

getFrames

public static Frame[] getFrames()

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

導入されたバージョン:

1.2

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

オーバーライド:

クラス Window 内の getAccessibleContext

戻り値:

この Frame の AccessibleContext として機能する AccessibleAWTFrame