|
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
,
RootPaneContainer
protected 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
内の processWindowEvent
e
- ウィンドウイベント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()
,
WindowConstants
public int getDefaultCloseOperation()
setDefaultCloseOperation(int)
public void update(Graphics g)
paint(g)
を呼び出すだけです。このメソッドは、バックグラウンドをクリアするための不必要な呼び出しが行われないようにするためにオーバーライドされました。
Container
内の update
g
- ペイント先となる 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
内の addImpl
comp
- 拡張されるコンポーネントconstraints
- 遵守されるべき制約index
- インデックス
Error
- rootPaneChecking
で呼び出された場合は、truesetRootPaneCheckingEnabled(boolean)
public void remove(Component comp)
Container
内の remove
comp
- 削除されるコンポーネントContainer.add(java.awt.Component)
public void setLayout(LayoutManager manager)
contentPane
のレイアウトを設定しなければなりません。次に例を示します。
thisComponent.getContentPane().setLayout(new GridLayout(1, 2))このコンポーネントのレイアウトを設定しようとすると、実行時例外がスローされます。サブクラスはこの動作を無効にできます。
Container
内の setLayout
manager
- LayoutManager
Error
- rootPaneChecking
で呼び出された場合は、truesetRootPaneCheckingEnabled(boolean)
public JRootPane getRootPane()
rootPane
オブジェクトを返します。
RootPaneContainer
内の getRootPane
rootPane
プロパティsetRootPane(javax.swing.JRootPane)
,
RootPaneContainer.getRootPane()
protected void setRootPane(JRootPane root)
rootPane
プロパティを設定します。このメソッドはコンストラクタによって呼び出されます。
root
- このフレームの rootPane
オブジェクトgetRootPane()
public Container getContentPane()
contentPane
オブジェクトを返します。
RootPaneContainer
内の getContentPane
contentPane
プロパティsetContentPane(java.awt.Container)
,
RootPaneContainer.getContentPane()
public void setContentPane(Container contentPane)
contentPane
プロパティを設定します。このメソッドはコンストラクタによって呼び出されます。
RootPaneContainer
内の setContentPane
contentPane
- このフレームの contentPane
オブジェクト
IllegalComponentStateException
- (実行時例外) コンテンツ区画パラメータが null
の場合getContentPane()
,
RootPaneContainer.setContentPane(java.awt.Container)
public JLayeredPane getLayeredPane()
layeredPane
オブジェクトを返します。
RootPaneContainer
内の getLayeredPane
layeredPane
プロパティsetLayeredPane(javax.swing.JLayeredPane)
,
RootPaneContainer.getLayeredPane()
public void setLayeredPane(JLayeredPane layeredPane)
layeredPane
プロパティを設定します。このメソッドはコンストラクタによって呼び出されます。
RootPaneContainer
内の setLayeredPane
layeredPane
- このフレームの layeredPane
オブジェクト
IllegalComponentStateException
- (実行時例外) 階層化区画パラメータが null
の場合getLayeredPane()
,
RootPaneContainer.setLayeredPane(javax.swing.JLayeredPane)
public Component getGlassPane()
glassPane
オブジェクトを返します。
RootPaneContainer
内の getGlassPane
glassPane
プロパティsetGlassPane(java.awt.Component)
,
RootPaneContainer.getGlassPane()
public void setGlassPane(Component glassPane)
glassPane
プロパティを設定します。このメソッドはコンストラクタによって呼び出されます。
RootPaneContainer
内の setGlassPane
glassPane
- このフレームの 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.getSupportsWindowDecorations
public static boolean isDefaultLookAndFeelDecorated()
JFrame
が現在の Look & Feel によって提供されるウィンドウ修飾を備える場合は true を返します。これは単なるヒントであり、Look & Feel がこの機能をサポートしない場合もあります。
protected String paramString()
JFrame
の文字列表現を返します。このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なります。返される文字列は空の場合がありますが、null
にはなりません。
Frame
内の paramString
JFrame
の文字列表現public AccessibleContext getAccessibleContext()
Accessible
内の getAccessibleContext
Frame
内の 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.