javax.swing
クラス JFrame

java.lang.Object
  java.awt.Component
      java.awt.Container
          java.awt.Window
              java.awt.Frame
                  javax.swing.JFrame

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

ImageObserver, MenuContainer, Serializable, Accessible, RootPaneContainer, WindowConstants

public class JFrame
extends Frame
implements WindowConstants, Accessible, RootPaneContainer

JFC/Swing コンポーネントアーキテクチャーのサポートを強化する java.awt.Frame の拡張バージョンです。JFrame の使用に関するタスク指向のドキュメントについては「The Java Tutorial」の「How to Make Frames」を参照してください。

JFrame クラスは Frame と多少互換性のないところがあります。ほかのすべての JFC/Swing トップレベルコンテナと同様、JFrame は JRootPane を唯一の子として保持します。原則として、ルート区画が提供する コンテンツ区画には JFrame が表示するメニュー以外のすべてのコンポーネントが含まれる必要があります。この点は AWT の Frame の場合とは異なります。便宜上、add とその派生メソッド、remove および setLayout は、必要に応じて contentPane に転送されるようにオーバーライドされています。つまり、次のように記述できます。

frame.add(child);
 

子は contentPane に追加されます。コンテンツ区画は常に null 以外です。null に設定しようとすると JFrame は例外をスローします。デフォルトのコンテンツ区画には、BorderLayout マネージャーが設定されます。JFrame の LayoutManager の追加、削除、および設定の詳細については、RootPaneContainer を参照してください。

Frame とは異なり、JFrame にはユーザーがウィンドウを閉じようとしたときにどのように対応するかという概念があります。デフォルトの動作は、ユーザーがウィンドウを閉じたら単に JFrame を隠すというものです。デフォルト動作を変更するには、setDefaultCloseOperation(int) メソッドを呼び出します。JFrame を Frame インスタンスと同じように動作させるには、setDefaultCloseOperation(WindowConstants.DO_NOTHING_ON_CLOSE) を使用します。

コンテンツ区画の詳細、およびルート区画が提供するその他の機能の詳細については、「The Java Tutorial」の「Using Top-Level Containers」 を参照してください。

マルチスクリーン環境の場合には、異なったスクリーンデバイス上で JFrame を生成できます。詳細は、Frame を参照してください。

警告: Swing はスレッドに対して安全ではありません。詳細は、「Swing's Threading Policy」を参照してください。

警告: このクラスの直列化されたオブジェクトは、今後の Swing リリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の運用や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。JDK Version 1.4 以降、すべての JavaBeans^™ の長期間の運用サポートは、java.beans パッケージに追加されています。詳細は、XMLEncoder を参照してください。

関連項目:

JRootPane, setDefaultCloseOperation(int), WindowListener.windowClosing(java.awt.event.WindowEvent), RootPaneContainer

入れ子のクラスの概要

protected class

JFrame.AccessibleJFrame このクラスは JFrame クラス用のアクセシビリティーサポートを実装しています。

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

Frame.AccessibleAWTFrame

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

Window.AccessibleAWTWindow

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

Container.AccessibleAWTContainer

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

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, 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 の呼び出しが contentPane に転送されます。

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

CROSSHAIR_CURSOR, DEFAULT_CURSOR, E_RESIZE_CURSOR, HAND_CURSOR, ICONIFIED, MAXIMIZED_BOTH, MAXIMIZED_HORIZ, MAXIMIZED_VERT, 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

インタフェース 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) 指定された子 Component を追加します。
protected JRootPane	createRootPane() コンストラクタメソッドによって呼び出され、デフォルトの rootPane を作成します。
protected void	frameInit() JFrame を適切に初期化するためにコンストラクタによって呼び出されます。
AccessibleContext	getAccessibleContext() この JFrame に関連した AccessibleContext を返します。
Container	getContentPane() このフレームの contentPane オブジェクトを返します。
int	getDefaultCloseOperation() ユーザーがこのフレームで「クローズ」を開始したときに実行される処理を返します。
Component	getGlassPane() このフレームの glassPane オブジェクトを返します。
Graphics	getGraphics() このコンポーネントのグラフィックスコンテキストを作成します。
JMenuBar	getJMenuBar() このフレームに設定されているメニューバーを返します。
JLayeredPane	getLayeredPane() このフレームの layeredPane オブジェクトを返します。
JRootPane	getRootPane() このフレームの rootPane オブジェクトを返します。
TransferHandler	getTransferHandler() transferHandler プロパティーを返します。
static boolean	isDefaultLookAndFeelDecorated() 新しく作成された JFrame が現在の Look & Feel によって提供されるウィンドウ修飾を備える場合は true を返します。
protected boolean	isRootPaneCheckingEnabled() add および setLayout の呼び出しが contentPane に転送されるかどうかを返します。
protected String	paramString() この JFrame の文字列表現を返します。
protected void	processWindowEvent(WindowEvent e) このコンポーネントで発生するウィンドウイベントを処理します。
void	remove(Component comp) 指定されたコンポーネントをコンテナから削除します。
void	repaint(long time, int x, int y, int width, int height) このコンポーネントの指定された矩形領域を time ミリ秒以内に再描画します。
void	setContentPane(Container contentPane) contentPane プロパティーを設定します。
void	setDefaultCloseOperation(int operation) ユーザーがこのフレームの「クローズ」を開始したときに、デフォルトで実行される処理を設定します。
static void	setDefaultLookAndFeelDecorated(boolean defaultLookAndFeelDecorated) 新しく作成された JFrame が、現在の Look & Feel によって提供されるウィンドウ修飾 (境界、ウィンドウをクローズするウィジェット、タイトルなど) を備えるかどうかについてのヒントを提供します。
void	setGlassPane(Component glassPane) glassPane プロパティーを設定します。
void	setIconImage(Image image) このウィンドウのアイコンとして表示されるイメージを設定します。
void	setJMenuBar(JMenuBar menubar) このフレームのメニューバーを設定します。
void	setLayeredPane(JLayeredPane layeredPane) layeredPane プロパティーを設定します。
void	setLayout(LayoutManager manager) LayoutManager を設定します。
protected void	setRootPane(JRootPane root) rootPane プロパティーを設定します。
protected void	setRootPaneCheckingEnabled(boolean enabled) add および setLayout の呼び出しが contentPane に転送されるかどうかを設定します。
void	setTransferHandler(TransferHandler newHandler) このコンポーネントへのデータ転送をサポートする機構である、transferHandler プロパティーを設定します。
void	update(Graphics g) paint(g) を呼び出します。

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

addNotify, getCursorType, getExtendedState, getFrames, getIconImage, getMaximizedBounds, getMenuBar, getState, getTitle, isResizable, isUndecorated, remove, removeNotify, setCursor, setExtendedState, setMaximizedBounds, setMenuBar, setResizable, setState, setTitle, setUndecorated

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

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

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

add, add, add, add, add, addContainerListener, 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, removeAll, removeContainerListener, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, transferFocusBackward, transferFocusDownCycle, 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, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, 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, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resize, resize, setBackground, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setName, setPreferredSize, show, size, toString, transferFocus, transferFocusUpCycle

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

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

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

getFont, postEvent

フィールドの詳細

EXIT_ON_CLOSE

public static final int EXIT_ON_CLOSE

終了するアプリケーションのデフォルトのウィンドウにクローズオペレーションです。ウィンドウにクローズオペレーションとしてこのフィールドが設定されている場合、アプレットでクローズすると、SecurityException がスローされます。このオペレーションはアプリケーションだけで使用することをお勧めします。

導入されたバージョン:

1.3

関連項目:

定数フィールド値

rootPane

protected JRootPane rootPane

glassPane だけでなく、このフレームの contentPane およびオプションの menuBar を管理する JRootPane のインスタンスです。

関連項目:

JRootPane, RootPaneContainer

rootPaneCheckingEnabled

protected boolean rootPaneCheckingEnabled

true の場合は、add および setLayout の呼び出しが contentPane に転送されます。最初は false ですが、JFrame が構築されると、true に設定されます。

関連項目:

isRootPaneCheckingEnabled(), setRootPaneCheckingEnabled(boolean), RootPaneContainer

accessibleContext

protected AccessibleContext accessibleContext

ユーザー補助機能のコンテキストプロパティーです。

コンストラクタの詳細

JFrame

public JFrame()
       throws HeadlessException

初期状態が不可視である、新しい Frame を構築します。

このコンストラクタはコンポーネントのローカルプロパティーを JComponent.getDefaultLocale によって返された値に設定します。

例外:

HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合

関連項目:

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

JFrame

public JFrame(GraphicsConfiguration gc)

Frame を、画面デバイスの指定された GraphicsConfiguration にタイトルなしで作成します。

このコンストラクタはコンポーネントのローカルプロパティーを JComponent.getDefaultLocale によって返された値に設定します。

パラメータ:

gc - 新しい Frame の構築に使用する GraphicsConfiguration。 gc が null の場合、システムのデフォルトの GraphicsConfiguration が使用される

例外:

IllegalArgumentException - gc がスクリーンデバイスのものではない場合。 この例外は GraphicsEnvironment.isHeadless() が true を返す場合に必ずスローされる

導入されたバージョン:

1.3

関連項目:

GraphicsEnvironment.isHeadless(), JComponent.getDefaultLocale()

JFrame

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

JFrame

public JFrame(String title,
              GraphicsConfiguration gc)

JFrame を、指定されたタイトルで、画面デバイスの指定された GraphicsConfiguration に作成します。

このコンストラクタはコンポーネントのローカルプロパティーを JComponent.getDefaultLocale によって返された値に設定します。

パラメータ:

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

gc - 新しい JFrame の構築に使用する GraphicsConfiguration。 gc が null の場合、システムのデフォルトの GraphicsConfiguration が使用される

例外:

IllegalArgumentException - gc がスクリーンデバイスのものではない場合。 この例外は GraphicsEnvironment.isHeadless() が true を返す場合に必ずスローされる

導入されたバージョン:

1.3

関連項目:

GraphicsEnvironment.isHeadless(), JComponent.getDefaultLocale()

メソッドの詳細

frameInit

protected void frameInit()

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

createRootPane

protected JRootPane createRootPane()

コンストラクタメソッドによって呼び出され、デフォルトの rootPane を作成します。

processWindowEvent

protected void processWindowEvent(WindowEvent e)

このコンポーネントで発生するウィンドウイベントを処理します。defaultCloseOperation プロパティーの設定値に従って、ウィンドウを非表示にするか、または破棄します。

オーバーライド:

クラス Window 内の processWindowEvent

パラメータ:

e - ウィンドウイベント

関連項目:

setDefaultCloseOperation(int), Window.processWindowEvent(java.awt.event.WindowEvent)

setDefaultCloseOperation

public void setDefaultCloseOperation(int operation)

ユーザーがこのフレームの「クローズ」を開始したときに、デフォルトで実行される処理を設定します。以下のうち 1 つを指定する必要があります。

• 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 が設定されます。このプロパティーの値を変更すると、プロパティー名 defaultCloseOperation でプロパティー変更イベントがトリガーされます。

注:Java 仮想マシン (VM) 内で最後の表示可能なウィンドウが破棄されると、VM が終了することがあります。詳細については、「AWT Threading Issues」を参照してください。

パラメータ:

operation - ユーザーがフレームを閉じるときに 実行されるべき処理

例外:

IllegalArgumentException - defaultCloseOperation の値が前述の 有効な値と異なる場合

SecurityException - EXIT_ON_CLOSE が指定されていて、 SecurityManager が 呼び出し側に System.exit の呼び出しを許可しない場合

関連項目:

Window.addWindowListener(java.awt.event.WindowListener), getDefaultCloseOperation(), WindowConstants, Runtime.exit(int)

getDefaultCloseOperation

public int getDefaultCloseOperation()

ユーザーがこのフレームで「クローズ」を開始したときに実行される処理を返します。

戻り値:

ウィンドウクローズオペレーションを示す整数

関連項目:

setDefaultCloseOperation(int)

setTransferHandler

public void setTransferHandler(TransferHandler newHandler)

このコンポーネントへのデータ転送をサポートする機構である、transferHandler プロパティーを設定します。コンポーネントがデータ転送操作をサポートしない場合、null を使用します。

システムプロパティー suppressSwingDropSupport が false (デフォルト) であり、このコンポーネント上の現在のドロップターゲットが null であるか、ユーザー設定のドロップターゲットでない場合、このメソッドはドロップターゲットを次のように変更します。newHandler が null の場合、ドロップターゲットを消去します。null でない場合は、新しい DropTarget をインストールします。

注:JFrame と組み合わせて使用した場合、TransferHandler はデータのインポート機能しか提供しません。これは、データのエクスポート関連のメソッドが現在 JComponent 型になっているためです。

詳細は、「The Java Tutorial」の「How to Use Drag and Drop and Data Transfer」を参照してください。

パラメータ:

newHandler - 新しい TransferHandler

導入されたバージョン:

1.6

関連項目:

TransferHandler, getTransferHandler(), Component.setDropTarget(java.awt.dnd.DropTarget)

getTransferHandler

public TransferHandler getTransferHandler()

transferHandler プロパティーを返します。

戻り値:

transferHandler プロパティーの値

導入されたバージョン:

1.6

関連項目:

TransferHandler, setTransferHandler(javax.swing.TransferHandler)

update

public void update(Graphics g)

paint(g) を呼び出します。このメソッドは、バックグラウンドをクリアする不必要な呼び出しが行われないようにするためにオーバーライドされました。

オーバーライド:

クラス Container 内の update

パラメータ:

g - ペイント先となる Graphics コンテキスト

関連項目:

Component.update(Graphics)

setJMenuBar

public void setJMenuBar(JMenuBar menubar)

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

パラメータ:

menubar - フレーム内に配置されているメニューバー

関連項目:

getJMenuBar()

getJMenuBar

public JMenuBar getJMenuBar()

このフレームに設定されているメニューバーを返します。

戻り値:

このフレームのメニューバー

関連項目:

setJMenuBar(javax.swing.JMenuBar)

isRootPaneCheckingEnabled

protected boolean isRootPaneCheckingEnabled()

add および setLayout の呼び出しが contentPane に転送されるかどうかを返します。

戻り値:

add および setLayout が転送される場合は true、そうでない場合は false

関連項目:

addImpl(java.awt.Component, java.lang.Object, int), setLayout(java.awt.LayoutManager), setRootPaneCheckingEnabled(boolean), RootPaneContainer

setRootPaneCheckingEnabled

protected void setRootPaneCheckingEnabled(boolean enabled)

add および setLayout の呼び出しが contentPane に転送されるかどうかを設定します。

パラメータ:

enabled - add および setLayout が転送される場合は true、JFrame で直接実行する必要がある場合は false

関連項目:

addImpl(java.awt.Component, java.lang.Object, int), setLayout(java.awt.LayoutManager), isRootPaneCheckingEnabled(), RootPaneContainer

addImpl

protected void addImpl(Component comp,
                       Object constraints,
                       int index)

指定された子 Component を追加します。このメソッドをオーバーライドすると、呼び出しが条件付きで contentPane に転送されます。デフォルトでは、子はフレームではなく contentPane に追加されます。詳細については、RootPaneContainer を参照してください。

オーバーライド:

クラス Container 内の addImpl

パラメータ:

comp - 拡張されるコンポーネント

constraints - 遵守されるべき制約

index - インデックス

例外:

IllegalArgumentException - index が無効な場合

IllegalArgumentException - コンテナの親をそのコンテナ自体に追加しようとしている場合

IllegalArgumentException - ウィンドウをコンテナに追加しようとしている場合

関連項目:

setRootPaneCheckingEnabled(boolean), RootPaneContainer

remove

public void remove(Component comp)

指定されたコンポーネントをコンテナから削除します。comp が rootPane でない場合は、呼び出しが contentPane に転送されます。comp が JFrame または contentPane の子でない場合は、何も行われません。

オーバーライド:

クラス Container 内の remove

パラメータ:

comp - 削除されるコンポーネント

例外:

NullPointerException - comp が null の場合

関連項目:

Container.add(java.awt.Component), RootPaneContainer

setLayout

public void setLayout(LayoutManager manager)

LayoutManager を設定します。このメソッドをオーバーライドすると、呼び出しが条件付きで contentPane に転送されます。詳細については、RootPaneContainer を参照してください。

オーバーライド:

クラス Container 内の setLayout

パラメータ:

manager - LayoutManager

関連項目:

setRootPaneCheckingEnabled(boolean), RootPaneContainer

getRootPane

public JRootPane getRootPane()

このフレームの rootPane オブジェクトを返します。

定義:

インタフェース RootPaneContainer 内の getRootPane

戻り値:

rootPane プロパティー

関連項目:

setRootPane(javax.swing.JRootPane), RootPaneContainer.getRootPane()

setRootPane

protected void setRootPane(JRootPane root)

rootPane プロパティーを設定します。このメソッドはコンストラクタによって呼び出されます。

パラメータ:

root - このフレームの rootPane オブジェクト

関連項目:

getRootPane()

setIconImage

public void setIconImage(Image image)

このウィンドウのアイコンとして表示されるイメージを設定します。

ウィンドウのアイコンとして単一イメージを指定するために、このメソッドを setIconImages() の代わりに使用できます。

たとえば次の文を考えてみます。

     setIconImage(image);
 

これは、次と同じです。

     ArrayList imageList = new ArrayList();
     imageList.add(image);
     setIconImages(imageList);
 

注:ネイティブのウィンドウ管理システムでは、ウィンドウを表すために、コンテキスト (ウィンドウ装飾、ウィンドウリスト、タスクバーなど) に応じてさまざまな寸法のさまざまなイメージを使用する場合があります。また、すべてのコンテキストで単一のイメージを使用することも、まったくイメージを使用しないこともあります。

オーバーライド:

クラス Frame 内の setIconImage

パラメータ:

image - 表示されるアイコンイメージ

関連項目:

Window.setIconImages(java.util.List), Window.getIconImages()

getContentPane

public Container getContentPane()

このフレームの contentPane オブジェクトを返します。

定義:

インタフェース RootPaneContainer 内の getContentPane

戻り値:

contentPane プロパティー

関連項目:

setContentPane(java.awt.Container), RootPaneContainer.getContentPane()

setContentPane

public void setContentPane(Container contentPane)

contentPane プロパティーを設定します。このメソッドはコンストラクタによって呼び出されます。

Swing のペイントアーキテクチャーでは、包含関係の階層に不透明な JComponent が含まれている必要があります。通常、これはコンテンツ区画よって提供されます。コンテンツ区画を置き換える場合は、不透明な JComponent と置き換えることをお勧めします。

定義:

インタフェース RootPaneContainer 内の setContentPane

パラメータ:

contentPane - このフレームの contentPane オブジェクト

例外:

IllegalComponentStateException - コンテンツ区画パラメータが null の場合 (実行時例外)

関連項目:

getContentPane(), RootPaneContainer.setContentPane(java.awt.Container), JRootPane

getLayeredPane

public JLayeredPane getLayeredPane()

このフレームの layeredPane オブジェクトを返します。

定義:

インタフェース RootPaneContainer 内の getLayeredPane

戻り値:

layeredPane プロパティー

関連項目:

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

戻り値:

glassPane プロパティー

関連項目:

setGlassPane(java.awt.Component), RootPaneContainer.getGlassPane()

setGlassPane

public void setGlassPane(Component glassPane)

glassPane プロパティーを設定します。このメソッドはコンストラクタによって呼び出されます。

定義:

インタフェース RootPaneContainer 内の setGlassPane

パラメータ:

glassPane - このフレームの glassPane オブジェクト

関連項目:

getGlassPane(), RootPaneContainer.setGlassPane(java.awt.Component)

getGraphics

public Graphics getGraphics()

このコンポーネントのグラフィックスコンテキストを作成します。このメソッドは、コンポーネントが現在表示可能でない場合、null を返します。

オーバーライド:

クラス Component 内の getGraphics

戻り値:

このコンポーネントのグラフィックスコンテキスト。 ない場合は null

導入されたバージョン:

1.6

関連項目:

Component.paint(java.awt.Graphics)

repaint

public void repaint(long time,
                    int x,
                    int y,
                    int width,
                    int height)

このコンポーネントの指定された矩形領域を time ミリ秒以内に再描画します。再ペイントの方法の詳細は、RepaintManager を参照してください。

オーバーライド:

クラス Component 内の repaint

パラメータ:

time - 更新までの最大時間 (ミリ秒)

x - x 座標

y - y 座標

width - 幅

height - 高さ

導入されたバージョン:

1.6

関連項目:

RepaintManager

setDefaultLookAndFeelDecorated

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 がウィンドウ装飾を 提供するかどうかのヒント

導入されたバージョン:

1.4

関連項目:

LookAndFeel.getSupportsWindowDecorations()

isDefaultLookAndFeelDecorated

public static boolean isDefaultLookAndFeelDecorated()

新しく作成された JFrame が現在の Look & Feel によって提供されるウィンドウ修飾を備える場合は true を返します。これは単なるヒントであり、Look & Feel がこの機能をサポートしない場合もあります。

戻り値:

Look & Feel がウィンドウ修飾を提供する場合は true

導入されたバージョン:

1.4

paramString

protected String paramString()

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

オーバーライド:

クラス Frame 内の paramString

戻り値:

この JFrame の文字列表現

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

定義:

インタフェース Accessible 内の getAccessibleContext

オーバーライド:

クラス Frame 内の getAccessibleContext

戻り値:

この JFrame の AccessibleContext として 機能する AccessibleJFrame