| 
JavaTM 2 Platform Std. Ed. v1.4.0  | 
||||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | ||||||||||
java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.Container
              |
              +--java.awt.Window
                    |
                    +--java.awt.Frame
                          |
                          +--javax.swing.JFrame
JFC/Swing コンポーネントアーキテクチャのサポートを追加する java.awt.Frame の拡張バージョンです。JFrame の使用に関するタスク指向のドキュメントは「The Java Tutorial」の 「How to Make Frames」を参照してください。
JFrame クラスは Frame と多少互換性のないところがあります。ほかのすべての JFC/Swing トップレベルコンテナと同様、JFrame は JRootPane を唯一の子として保持します。原則として、ルート区画が提供するコンテンツ区画には JFrame が表示するメニュー以外のすべてのコンポーネントが含まれる必要があります。この点は AWT の Frame の場合とは異なります。たとえば、AWT のフレームに子を追加するには、次のように記述します。
frame.add(child);しかし、
JFrame を使う場合は、次のように JFrame のコンテンツ区画に子を追加する必要があります。
frame.getContentPane().add(child);レイアウトマネージャの設定、コンポーネントの削除、子のリスト化などでも、同じことが言えます。これらのすべてのメソッドは通常、JFrame 自体ではなくコンテンツ区画に送られます。コンテンツ区画は常に null 以外です。これを null に設定しようとすると、JFrame が例外をスローする原因になります。デフォルトのコンテンツ区画には、BorderLayout マネージャが設定されます。
Frame とは異なり、JFrame にはユーザがウィンドウを閉じようとしたときにどのように対応するかという概念があります。デフォルトの動作は、ユーザがウィンドウを閉じたら単に JFrame を隠すというものです。デフォルト動作を変更するには、メソッド setDefaultCloseOperation(int) を呼び出します。JFrame を Frame インスタンスと同じように動作させるには、setDefaultCloseOperation(WindowConstants.DO_NOTHING_ON_CLOSE) を使用します。
コンテンツ区画の詳細、およびルート区画が提供するその他の機能の詳細については、「The Java Tutorial」の「Using Top-Level Containers」 を参照してください。
マルチスクリーン環境の場合には、異なった画面デバイス上で JFrame を生成できます。詳細は、Frame を参照してください。
標準の Look & Feel (L&F) 表現でこのコンポーネントが使用するキーボードのキーについては、JFrame のキーの割り当てを参照してください。
警告:
このクラスの直列化されたオブジェクトは、今後の Swing リリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の運用や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。1.4 では、すべての JavaBeansTM の長期間の運用に対するサポートが java.beans パッケージに追加されました。XMLEncoder を参照してください。
JRootPane, 
setDefaultCloseOperation(int), 
WindowListener.windowClosing(java.awt.event.WindowEvent)| 入れ子クラスの概要 | |
protected  class | 
JFrame.AccessibleJFrame
このクラスは JFrame クラス用のユーザ補助機能のサポートを実装しています。 | 
| クラス java.awt.Frame から継承した入れ子クラス | 
 | 
| クラス java.awt.Window から継承した入れ子クラス | 
 | 
| クラス java.awt.Container から継承した入れ子クラス | 
 | 
| クラス java.awt.Component から継承した入れ子クラス | 
Component.BltBufferStrategy, Component.FlipBufferStrategy | 
| フィールドの概要 | |
protected  AccessibleContext | 
accessibleContext
ユーザ補助機能のコンテキストプロパティです。  | 
static int | 
EXIT_ON_CLOSE
終了するアプリケーションのデフォルトのウィンドウのクローズオペレーションです。  | 
protected  JRootPane | 
rootPane
glassPane だけでなく、このフレームの contentPane およびオプションの menuBar を管理する JRootPane のインスタンスです。 | 
protected  boolean | 
rootPaneCheckingEnabled
true の場合、 add および setLayout を呼び出すと例外がスローされます。 | 
| クラス java.awt.Component から継承したフィールド | 
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT | 
| インタフェース javax.swing.WindowConstants から継承したフィールド | 
DISPOSE_ON_CLOSE, DO_NOTHING_ON_CLOSE, HIDE_ON_CLOSE | 
| インタフェース java.awt.image.ImageObserver から継承したフィールド | 
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH | 
| コンストラクタの概要 | |
JFrame()
初期状態が不可視である、新しい Frame を構築します。  | 
|
JFrame(GraphicsConfiguration gc)
Frame を、画面デバイスの指定された GraphicsConfiguration にタイトルなしで作成します。
 | 
|
JFrame(String title)
指定されたタイトルで、初期状態で不可視の新しい Frame を構築します。
 | 
|
JFrame(String title,
       GraphicsConfiguration gc)
JFrame を、指定されたタイトルで、画面デバイスの指定された GraphicsConfiguration に作成します。
 | 
|
| メソッドの概要 | |
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 オブジェクトを返します。 | 
static boolean | 
isDefaultLookAndFeelDecorated()
新しく作成された JFrame が現在の Look & Feel によって提供されるウィンドウ修飾を備える場合は true を返します。 | 
protected  boolean | 
isRootPaneCheckingEnabled()
add および setLayout の呼び出しが例外をスローするかどうかを返します。 | 
protected  String | 
paramString()
この JFrame の文字列表現を返します。 | 
protected  void | 
processWindowEvent(WindowEvent e)
このコンポーネントで発生するウィンドウイベントを処理します。  | 
 void | 
remove(Component comp)
コンテナから、指定されたコンポーネントを削除します。  | 
 void | 
setContentPane(Container contentPane)
contentPane プロパティを設定します。 | 
 void | 
setDefaultCloseOperation(int operation)
ユーザがこのフレームの「クローズ」を開始したときに、デフォルトで実行される処理を設定します。  | 
static void | 
setDefaultLookAndFeelDecorated(boolean defaultLookAndFeelDecorated)
新しく作成された JFrame が、現在の Look & Feel によって提供されるウィンドウ修飾 (境界、ウィンドウをクローズするウィジェット、タイトルなど) を備えるかどうかについてのヒントを提供します。 | 
 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, getExtendedState, getFrames, getIconImage, getMaximizedBounds, getMenuBar, getState, getTitle, isResizable, isUndecorated, remove, removeNotify, setCursor, setExtendedState, setIconImage, setMaximizedBounds, setMenuBar, setResizable, setState, setTitle, setUndecorated | 
| クラス java.lang.Object から継承したメソッド | 
clone, equals, getClass, hashCode, notify, notifyAll, wait, wait, wait | 
| インタフェース java.awt.MenuContainer から継承したメソッド | 
getFont, postEvent | 
| フィールドの詳細 | 
public static final int EXIT_ON_CLOSE
SecurityException がスローされます。このオペレーションはアプリケーションだけで使用することをお勧めします。
protected JRootPane rootPane
glassPane だけでなく、このフレームの contentPane およびオプションの menuBar を管理する JRootPane のインスタンスです。
JRootPane, 
RootPaneContainerprotected boolean rootPaneCheckingEnabled
add および setLayout を呼び出すと例外がスローされます。デフォルトは false です。
isRootPaneCheckingEnabled(), 
setRootPaneCheckingEnabled(boolean)protected AccessibleContext accessibleContext
| コンストラクタの詳細 | 
public JFrame()
       throws HeadlessException
このコンストラクタはコンポーネントのローカルプロパティを JComponent.getDefaultLocale によって返された値に設定します。
HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合GraphicsEnvironment.isHeadless(), 
Component.setSize(int, int), 
Component.setVisible(boolean), 
JComponent.getDefaultLocale()public JFrame(GraphicsConfiguration gc)
Frame を、画面デバイスの指定された GraphicsConfiguration にタイトルなしで作成します。
このコンストラクタはコンポーネントのローカルプロパティを JComponent.getDefaultLocale によって返された値に設定します。
gc - 新しい Frame を構築するために使用される GraphicsConfiguration。gc が null の場合は、システムのデフォルトは、GraphicsConfiguration と考えられる
IllegalArgumentException - gc が画面デバイスで指定されたものでない場合。この例外は GraphicsEnvironment.isHeadless() が true を返す場合に必ずスローされるGraphicsEnvironment.isHeadless(), 
JComponent.getDefaultLocale()
public JFrame(String title)
       throws HeadlessException
Frame を構築します。
このコンストラクタはコンポーネントのローカルプロパティを JComponent.getDefaultLocale によって返された値に設定します。
title - フレームのタイトル
HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合GraphicsEnvironment.isHeadless(), 
Component.setSize(int, int), 
Component.setVisible(boolean), 
JComponent.getDefaultLocale()
public JFrame(String title,
              GraphicsConfiguration gc)
JFrame を、指定されたタイトルで、画面デバイスの指定された GraphicsConfiguration に作成します。
このコンストラクタはコンポーネントのローカルプロパティを JComponent.getDefaultLocale によって返された値に設定します。
title - フレームのボーダに表示されるタイトル。null 値は、空の文字列 "" と見なされるgc - 新しい JFrame を構築するために使用される GraphicsConfiguration。gc が null の場合、システムのデフォルトは、GraphicsConfiguration と考えられる
IllegalArgumentException - gc が画面デバイスで指定されたものでない場合。この例外は GraphicsEnvironment.isHeadless() が true を返す場合に必ずスローされるGraphicsEnvironment.isHeadless(), 
JComponent.getDefaultLocale()| メソッドの詳細 | 
protected void frameInit()
JFrame を適切に初期化するためにコンストラクタによって呼び出されます。
protected JRootPane createRootPane()
rootPane を作成します。
protected void processWindowEvent(WindowEvent e)
defaultCloseOperation プロパティの設定値に従って、ウィンドウを非表示にするか、または破棄します。
Window 内の processWindowEvente - ウィンドウイベントsetDefaultCloseOperation(int), 
Window.processWindowEvent(java.awt.event.WindowEvent)public void setDefaultCloseOperation(int operation)
DO_NOTHING_ON_CLOSE (WindowConstants に定義): 何も行わない。プログラムは登録されている WindowListener オブジェクトの windowClosing メソッドで処理を行う必要がある
HIDE_ON_CLOSE (WindowConstants に定義): 登録されている任意の WindowListener オブジェクトを呼び出したあとで、自動的にフレームを隠す
DISPOSE_ON_CLOSE (WindowConstants に定義): 登録されている任意の WindowListener オブジェクトを呼び出したあとで、自動的にフレームを隠して破棄する
EXIT_ON_CLOSE (JFrame に定義):System の exit メソッドを使用してアプリケーションを終了する。アプリケーションでだけ使用
デフォルトでは HIDE_ON_CLOSE が設定されます。
operation - ユーザがフレームを閉じるときに実行される処理
IllegalArgumentException - defaultCloseOperation の値が上記の有効な値と異なる場合Window.addWindowListener(java.awt.event.WindowListener), 
getDefaultCloseOperation(), 
WindowConstantspublic int getDefaultCloseOperation()
setDefaultCloseOperation(int)public void update(Graphics g)
paint(g) を呼び出すだけです。このメソッドは、バックグラウンドをクリアするための不必要な呼び出しが行われないようにするためにオーバーライドされました。
Container 内の updateg - ペイント先となる Graphics コンテキストComponent.update(Graphics)public void setJMenuBar(JMenuBar menubar)
menubar - フレーム内に配置されているメニューバーgetJMenuBar()public JMenuBar getJMenuBar()
setJMenuBar(javax.swing.JMenuBar)protected boolean isRootPaneCheckingEnabled()
add および setLayout の呼び出しが例外をスローするかどうかを返します。
add および setLayout が調べられる場合は true、そうでない場合は falseaddImpl(java.awt.Component, java.lang.Object, int), 
setLayout(java.awt.LayoutManager), 
setRootPaneCheckingEnabled(boolean)protected void setRootPaneCheckingEnabled(boolean enabled)
add および setLayout の呼び出しが例外をスローするかどうかを設定します。
enabled - 調査を有効にして例外をスローする場合は、trueaddImpl(java.awt.Component, java.lang.Object, int), 
setLayout(java.awt.LayoutManager), 
isRootPaneCheckingEnabled()
protected void addImpl(Component comp,
                       Object constraints,
                       int index)
thisComponent.getContentPane().add(child)このコンポーネントに直接追加しようとすると、実行時例外がスローされます。サブクラスはこの動作を無効にできます。
Container 内の addImplcomp - 拡張されるコンポーネントconstraints - 遵守されるべき制約index - インデックス
Error - rootPaneChecking で呼び出された場合は、truesetRootPaneCheckingEnabled(boolean)public void remove(Component comp)
Container 内の removecomp - 削除されるコンポーネントContainer.add(java.awt.Component)public void setLayout(LayoutManager manager)
contentPane のレイアウトを設定しなければなりません。次に例を示します。
thisComponent.getContentPane().setLayout(new GridLayout(1, 2))このコンポーネントのレイアウトを設定しようとすると、実行時例外がスローされます。サブクラスはこの動作を無効にできます。
Container 内の setLayoutmanager - LayoutManager
Error - rootPaneChecking で呼び出された場合は、truesetRootPaneCheckingEnabled(boolean)public JRootPane getRootPane()
rootPane オブジェクトを返します。
RootPaneContainer 内の getRootPanerootPane プロパティsetRootPane(javax.swing.JRootPane), 
RootPaneContainer.getRootPane()protected void setRootPane(JRootPane root)
rootPane プロパティを設定します。このメソッドはコンストラクタによって呼び出されます。
root - このフレームの rootPane オブジェクトgetRootPane()public Container getContentPane()
contentPane オブジェクトを返します。
RootPaneContainer 内の getContentPanecontentPane プロパティsetContentPane(java.awt.Container), 
RootPaneContainer.getContentPane()public void setContentPane(Container contentPane)
contentPane プロパティを設定します。このメソッドはコンストラクタによって呼び出されます。
RootPaneContainer 内の setContentPanecontentPane - このフレームの contentPane オブジェクト
IllegalComponentStateException - (実行時例外) コンテンツ区画パラメータが null の場合getContentPane(), 
RootPaneContainer.setContentPane(java.awt.Container)public JLayeredPane getLayeredPane()
layeredPane オブジェクトを返します。
RootPaneContainer 内の getLayeredPanelayeredPane プロパティsetLayeredPane(javax.swing.JLayeredPane), 
RootPaneContainer.getLayeredPane()public void setLayeredPane(JLayeredPane layeredPane)
layeredPane プロパティを設定します。このメソッドはコンストラクタによって呼び出されます。
RootPaneContainer 内の setLayeredPanelayeredPane - このフレームの layeredPane オブジェクト
IllegalComponentStateException - (実行時例外) 階層化区画パラメータが null の場合getLayeredPane(), 
RootPaneContainer.setLayeredPane(javax.swing.JLayeredPane)public Component getGlassPane()
glassPane オブジェクトを返します。
RootPaneContainer 内の getGlassPaneglassPane プロパティsetGlassPane(java.awt.Component), 
RootPaneContainer.getGlassPane()public void setGlassPane(Component glassPane)
glassPane プロパティを設定します。このメソッドはコンストラクタによって呼び出されます。
RootPaneContainer 内の setGlassPaneglassPane - このフレームの glassPane オブジェクトgetGlassPane(), 
RootPaneContainer.setGlassPane(java.awt.Component)public static void setDefaultLookAndFeelDecorated(boolean defaultLookAndFeelDecorated)
JFrame が、現在の Look & Feel によって提供されるウィンドウ修飾 (境界、ウィンドウをクローズするウィジェット、タイトルなど) を備えるかどうかについてのヒントを提供します。defaultLookAndFeelDecorated が true の場合、現在の LookAndFeel はウィンドウ修飾の提供をサポートし、現在のウィンドウマネージャは修飾されていないウィンドウをサポートします。したがって、新しく作成された JFrame は現在の LookAndFeel によるウィンドウ修飾を持ちます。そうでない場合は、新しく作成された JFrame のウィンドウ修飾は現在のウィンドウマネージャによって提供されます。
単一の JFrame に対しても次を実行することにより、同じ効果を得られます。
JFrame frame = new JFrame(); frame.setUndecorated(true); frame.getRootPane().setWindowDecorationStyle(JRootPane.FRAME);
defaultLookAndFeelDecorated - 現在の Look & Feel がウィンドウ修飾を提供するかどうかについてのヒントjavax.swing.LookAndFeel.getSupportsWindowDecorationspublic static boolean isDefaultLookAndFeelDecorated()
JFrame が現在の Look & Feel によって提供されるウィンドウ修飾を備える場合は true を返します。これは単なるヒントであり、Look & Feel がこの機能をサポートしない場合もあります。
protected String paramString()
JFrame の文字列表現を返します。このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なります。返される文字列は空の場合がありますが、null にはなりません。
Frame 内の paramStringJFrame の文字列表現public AccessibleContext getAccessibleContext()
Accessible 内の getAccessibleContextFrame 内の getAccessibleContext
  | 
JavaTM 2 Platform Std. Ed. v1.4.0  | 
||||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | ||||||||||
 Java、Java 2D、および JDBC は米国ならびにその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
 Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A.  All Rights Reserved.