Java プラットフォーム 1.2

javax.swing
クラス JFrame

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.Container
              |
              +--java.awt.Window
                    |
                    +--java.awt.Frame
                          |
                          +--javax.swing.JFrame
public class JFrame
extends Frame
implements WindowConstants, Accessible, RootPaneContainer

フレームの子の前面に挿入されて入力およびペイント動作をサポートし (glassPane を参照)、LayeredPane によって管理される特殊な子をサポートし (rootPane を参照)、さらに Swing MenuBars のサポートを追加する java.awt.Frame の拡張バージョンです。

JFrame クラスは、一部 java.awt.Frame と互換性がありません。JFrame は JRootPane を唯一の子に持ちます。contentPane は JFrame のすべての子の親になる必要があります。この点は java.awt.Frame とは異なります。たとえば、AWT Frame に子を追加するには、次のように記述します。 

       frame.add(child);
しかし、JFrame を使う場合は、次のように JFrames contentPane に子を追加する必要があります。 
       frame.getContentPane().add(child);
LayoutManagers の設定、コンポーネントの削除、このリスト表示などについても同様です。これらのメソッドは、通常すべて JFrame 自体ではなく contentPane() に送る必要があります。contentPane() は常に null 以外です。null に設定しようとすると JFrame は例外をスローします。デフォルトの contentPane() には、BorderLayout マネージャが設定されています。

contentPane、glassPane、および layeredPane プロパティの詳細は、JRootPane の説明を参照してください。

親クラス java.awt.Frame とは異なり、JFrame には、ユーザがウィンドウを閉じようとしたときにどのように応答するかを指定することができます。デフォルトの動作は、ユーザがウィンドウを閉じたら JFrame を非表示にするだけです。このデフォルト動作を変更するには、メソッド setDefaultCloseOperation を呼び出します。ウィンドウクローズイベントを処理し、明示的に dispose() を呼び出す (あるいはアプリケーションを終了する。これも効果的) 場合を除いて、JFrame を開いたままにするには、setDefaultCloseOperation(WindowConstants.DO_NOTHING_ON_CLOSE) を使います。これで JFrame は java.awt.Frame と同様に動作します。3 つ目のオプションは、ウィンドウを閉じたら、非表示にするだけでなく、完全にウィンドウを破棄することです。

標準の Look & Feel (L&F) 表現でこのコンポーネントが使用するキーボードのキーについては、JFrame のキーの割り当てを参照してください。

警告: このクラスの直列化されたオブジェクトは、今後の Swing リリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の運用や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。今後の Swing リリースでは、長期間の持続性をサポートする予定です。

関連項目:
JRootPane, setDefaultCloseOperation(int), WindowListener.windowClosing(java.awt.event.WindowEvent), 直列化された形式

内部クラスの概要
protected  class JFrame.AccessibleJFrame
          オブジェクトのユーザ補助機能を取得するために使用されるクラスです。
 
フィールドの概要
protected  AccessibleContext accessibleContext
          ユーザ補助機能のコンテキストのプロパティです。
protected  JRootPane rootPane
          glassPane とともに、このフレームの contentPane およびオプションの menuBar を制御する JRootPane のインスタンスです。
protected  boolean rootPaneCheckingEnabled
          true の場合、add および setLayout を呼び出すと、例外がスローされます。
 
クラス java.awt.Frame から継承したフィールド
CROSSHAIR_CURSOR, DEFAULT_CURSOR, E_RESIZE_CURSOR, HAND_CURSOR, ICONIFIED, MOVE_CURSOR, N_RESIZE_CURSOR, NE_RESIZE_CURSOR, NORMAL, NW_RESIZE_CURSOR, S_RESIZE_CURSOR, SE_RESIZE_CURSOR, SW_RESIZE_CURSOR, TEXT_CURSOR, W_RESIZE_CURSOR, WAIT_CURSOR
 
クラス java.awt.Component から継承したフィールド
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
 
コンストラクタの概要
JFrame()
          最初は不可視である、新しい Frame を構築します。
JFrame(String title)
          最初は不可視である新しい Frame を、指定されたタイトルで構築します。
 
メソッドの概要
protected  void addImpl(Component comp, Object constraints, int index)
          デフォルトでは、子をこのコンポーネントに直接追加せずに、子の contentPane に追加する必要があります。
protected  JRootPane createRootPane()
          デフォルトの rootPane を作成するためにコンストラクタメソッドによって呼び出されます。
protected  void frameInit()
          JFrame を適切に初期化するためにコンストラクタによって呼び出されます。
 AccessibleContext getAccessibleContext()
          この JFrame に関連付けられている AccessibleContext を取得します。
 Container getContentPane()
          このフレームの contentPane オブジェクトを返します。
 int getDefaultCloseOperation()
          ユーザがこのフレームで「クローズ」を開始したときに実行される処理を返します。
 Component getGlassPane()
          このフレームの glassPane オブジェクトを返します。
 JMenuBar getJMenuBar()
          このフレームに設定されているメニューバーを返します。
 JLayeredPane getLayeredPane()
          このフレームの layeredPane オブジェクトを返します。
 JRootPane getRootPane()
          このフレームの rootPane オブジェクトを返します。
protected  boolean isRootPaneCheckingEnabled()
          add および setLayout の呼び出しで例外がスローされるかどうかを返します。
protected  String paramString()
          この JFrame の文字列表現を返します。
protected  void processKeyEvent(KeyEvent e)
          このコンポーネントで発生するキーイベントを処理し、必要な場合にはイベントを、キーイベントの通知を登録しているフレーム内のコンポーネントに渡します。
protected  void processWindowEvent(WindowEvent e)
          このコンポーネントで発生するウィンドウイベントを処理します。
 void setContentPane(Container contentPane)
          contentPane プロパティを設定します。
 void setDefaultCloseOperation(int operation)
          ユーザがこのフレームで「クローズ」を開始したときに、デフォルトで実行される処理を設定します。
 void setGlassPane(Component glassPane)
          glassPane プロパティを設定します。
 void setJMenuBar(JMenuBar menubar)
          このフレームのメニューバーを設定します。
 void setLayeredPane(JLayeredPane layeredPane)
          layeredPane プロパティを設定します。
 void setLayout(LayoutManager manager)
          デフォルトでは、このコンポーネントの配置を設定せずに、コンポーネントの contentPane の配置を設定する必要があります。
protected  void setRootPane(JRootPane root)
          rootPane プロパティを設定します。
protected  void setRootPaneCheckingEnabled(boolean enabled)
          add および setLayout の呼び出しで例外がスローされるかどうかを設定します。
 void update(Graphics g)
          paint(g) を呼び出すだけです。
 
クラス java.awt.Frame から継承したメソッド
addNotify, finalize, getCursorType, getFrames, getIconImage, getMenuBar, getState, getTitle, isResizable, remove, removeNotify, setCursor, setIconImage, setMenuBar, setResizable, setState, setTitle
 
クラス java.awt.Window から継承したメソッド
addWindowListener, applyResourceBundle, applyResourceBundle, dispose, getFocusOwner, getInputContext, getLocale, getOwnedWindows, getOwner, getToolkit, getWarningString, isShowing, pack, postEvent, processEvent, removeWindowListener, show, toBack, toFront
 
クラス java.awt.Container から継承したメソッド
add, add, add, add, add, addContainerListener, 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, validate, validateTree
 
クラス java.awt.Component から継承したメソッド
action, add, addComponentListener, addFocusListener, 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, hide, 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, processInputMethodEvent, processMouseEvent, processMouseMotionEvent, removeComponentListener, removeFocusListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, reshape, resize, resize, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, 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
 

フィールドの詳細

rootPane

protected JRootPane rootPane
glassPane とともに、このフレームの contentPane およびオプションの menuBar を制御する JRootPane のインスタンスです。
関連項目:
JRootPane, RootPaneContainer

rootPaneCheckingEnabled

protected boolean rootPaneCheckingEnabled
true の場合、add および setLayout を呼び出すと、例外がスローされます。
関連項目:
isRootPaneCheckingEnabled(), setRootPaneCheckingEnabled(boolean)

accessibleContext

protected AccessibleContext accessibleContext
ユーザ補助機能のコンテキストのプロパティです。
コンストラクタの詳細

JFrame

public JFrame()
最初は不可視である、新しい Frame を構築します。
関連項目:
Component.setSize(int, int), Component.setVisible(boolean)

JFrame

public JFrame(String title)
最初は不可視である新しい Frame を、指定されたタイトルで構築します。
パラメータ:
title - フレームのタイトル
関連項目:
Component.setSize(int, int), Component.setVisible(boolean)
メソッドの詳細

frameInit

protected void frameInit()
JFrame を適切に初期化するためにコンストラクタによって呼び出されます。

createRootPane

protected JRootPane createRootPane()
デフォルトの rootPane を作成するためにコンストラクタメソッドによって呼び出されます。

processKeyEvent

protected void processKeyEvent(KeyEvent e)
このコンポーネントで発生するキーイベントを処理し、必要な場合にはイベントを、キーイベントの通知を登録しているフレーム内のコンポーネントに渡します。
パラメータ:
e - キーイベント
オーバーライド:
クラス Component 内の processKeyEvent
関連項目:
Component.processKeyEvent(java.awt.event.KeyEvent)

processWindowEvent

protected void processWindowEvent(WindowEvent e)
このコンポーネントで発生するウィンドウイベントを処理します。defaultCloseOperation プロパティの設定値に従って、ウィンドウを非表示にするか、または破棄します。
パラメータ:
e - ウィンドウイベント
オーバーライド:
クラス Window 内の processWindowEvent
関連項目:
setDefaultCloseOperation(int), Window.processWindowEvent(java.awt.event.WindowEvent)

setDefaultCloseOperation

public void setDefaultCloseOperation(int operation)
ユーザがこのフレームで「クローズ」を開始したときに、デフォルトで実行される処理を設定します。指定できる値は WindowConstants インタフェースで定義されます。

デフォルト値は HIDE_ON_CLOSE に設定されます。

関連項目:
Window.addWindowListener(java.awt.event.WindowListener), getDefaultCloseOperation()

getDefaultCloseOperation

public int getDefaultCloseOperation()
ユーザがこのフレームで「クローズ」を開始したときに実行される処理を返します。
戻り値:
ウィンドウクローズ処理を示す int 値
関連項目:
setDefaultCloseOperation(int)

update

public void update(Graphics g)
paint(g) を呼び出すだけです。このメソッドは、不必要なバックグラウンドのクリアの呼び出しが行われないようにするためにオーバーライドされました。
パラメータ:
g - ペイント先となる Graphics コンテキスト
オーバーライド:
クラス Container 内の update

setJMenuBar

public void setJMenuBar(JMenuBar menubar)
このフレームのメニューバーを設定します。
パラメータ:
menubar - フレームに配置されるメニューバー
関連項目:
getJMenuBar()

getJMenuBar

public JMenuBar getJMenuBar()
このフレームに設定されているメニューバーを返します。
関連項目:
setJMenuBar(javax.swing.JMenuBar)

isRootPaneCheckingEnabled

protected boolean isRootPaneCheckingEnabled()
add および setLayout の呼び出しで例外がスローされるかどうかを返します。
戻り値:
add および setLayout がチェックされる場合は true
関連項目:
addImpl(java.awt.Component, java.lang.Object, int), setLayout(java.awt.LayoutManager), setRootPaneCheckingEnabled(boolean)

setRootPaneCheckingEnabled

protected void setRootPaneCheckingEnabled(boolean enabled)
add および setLayout の呼び出しで例外がスローされるかどうかを設定します。
パラメータ:
enabled - boolean 値。チェックが有効で、例外がスローされる場合は true
関連項目:
addImpl(java.awt.Component, java.lang.Object, int), setLayout(java.awt.LayoutManager), isRootPaneCheckingEnabled()

addImpl

protected void addImpl(Component comp,
                       Object constraints,
                       int index)
デフォルトでは、子をこのコンポーネントに直接追加せずに、子の contentPane に追加する必要があります。次に例を示します。 
 thisComponent.getContentPane().add(child)
直接このコンポーネントに追加しようとすると、実行時例外がスローされます。サブクラスはこの動作を無効にすることができます。
例外:
Error - rootPaneChecking を true にして呼び出された場合
オーバーライド:
クラス Container 内の addImpl
関連項目:
setRootPaneCheckingEnabled(boolean)

setLayout

public void setLayout(LayoutManager manager)
デフォルトでは、このコンポーネントの配置を設定せずに、コンポーネントの contentPane の配置を設定する必要があります。次に例を示します。 
 thiComponent.getContentPane().setLayout(new BorderLayout())
このコンポーネントの配置を設定しようとすると、実行時例外がスローされます。サブクラスはこの動作を無効にすることができます。
例外:
Error - rootPaneChecking を true にして呼び出された場合
オーバーライド:
クラス Container 内の setLayout
関連項目:
setRootPaneCheckingEnabled(boolean)

getRootPane

public JRootPane getRootPane()
このフレームの rootPane オブジェクトを返します。
定義:
インタフェース RootPaneContainer 内の getRootPane
関連項目:
setRootPane(javax.swing.JRootPane), RootPaneContainer.getRootPane()

setRootPane

protected void setRootPane(JRootPane root)
rootPane プロパティを設定します。このメソッドはコンストラクタによって呼び出されます。
パラメータ:
root - このフレームの rootPane オブジェクト
関連項目:
getRootPane()

getContentPane

public Container getContentPane()
このフレームの contentPane オブジェクトを返します。
定義:
インタフェース RootPaneContainer 内の getContentPane
関連項目:
setContentPane(java.awt.Container), RootPaneContainer.getContentPane()

setContentPane

public void setContentPane(Container contentPane)
contentPane プロパティを設定します。このメソッドはコンストラクタによって呼び出されます。
定義:
インタフェース RootPaneContainer 内の setContentPane
パラメータ:
contentPane - このフレームの contentPane オブジェクト
例外:
IllegalComponentStateException - (実行時例外) コンテンツ区画パラメータが null の場合
関連項目:
getContentPane(), RootPaneContainer.setContentPane(java.awt.Container)

getLayeredPane

public JLayeredPane getLayeredPane()
このフレームの layeredPane オブジェクトを返します。
定義:
インタフェース RootPaneContainer 内の getLayeredPane
関連項目:
setLayeredPane(javax.swing.JLayeredPane), RootPaneContainer.getLayeredPane()

setLayeredPane

public void setLayeredPane(JLayeredPane layeredPane)
layeredPane プロパティを設定します。このメソッドはコンストラクタによって呼び出されます。
定義:
インタフェース RootPaneContainer 内の setLayeredPane
パラメータ:
layeredPane - このフレームの layeredPane オブジェクト
例外:
IllegalComponentStateException - (実行時例外) 階層化区画パラメータが null の場合
関連項目:
getLayeredPane(), RootPaneContainer.setLayeredPane(javax.swing.JLayeredPane)

getGlassPane

public Component getGlassPane()
このフレームの glassPane オブジェクトを返します。
定義:
インタフェース RootPaneContainer 内の getGlassPane
関連項目:
setGlassPane(java.awt.Component), RootPaneContainer.getGlassPane()

setGlassPane

public void setGlassPane(Component glassPane)
glassPane プロパティを設定します。このメソッドはコンストラクタによって呼び出されます。
定義:
インタフェース RootPaneContainer 内の setGlassPane
パラメータ:
glassPane - このフレームの glassPane オブジェクト
関連項目:
getGlassPane(), RootPaneContainer.setGlassPane(java.awt.Component)

paramString

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

JFC コンポーネントの新しい側面についての情報を返すには、paramString() をオーバーライドします。

戻り値:
この JFrame の文字列表現
オーバーライド:
クラス Frame 内の paramString

getAccessibleContext

public AccessibleContext getAccessibleContext()
この JFrame に関連付けられている AccessibleContext を取得します。
定義:
インタフェース Accessible 内の getAccessibleContext
戻り値:
この JFrame の AccessibleContext
Java プラットフォーム 1.2
バグや機能要求の報告
新しい javadoc の表示についてのコメントやご提案
Java は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-1998 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.