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 に適しています。1.4 以降、すべての JavaBeans^TM 用の長期間の格納サポートが 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, Window.Type

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

Container.AccessibleAWTContainer

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

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

フィールドのサマリー

フィールド

修飾子と型	フィールドと説明
protected AccessibleContext	accessibleContext Accessible コンテキストプロパティーです。
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() 初期状態が不可視である、新しいフレームを構築します。
JFrame(GraphicsConfiguration gc) 画面デバイスの指定された GraphicsConfiguration と空のタイトルで、Frame を作成します。
JFrame(String title) 指定されたタイトルを使用して、初期状態で可視ではない新しい Frame を作成します。
JFrame(String title, GraphicsConfiguration gc) 指定されたタイトルと、画面デバイスの指定された GraphicsConfiguration で、JFrame を作成します。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
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 (L&F) で実行できるウィンドウ装飾を保持する場合は 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 (L&F) で実行できるボーダー、ウィンドウクローズ用ウィジェット、タイトルなどのウィンドウ装飾を保持するかどうかのヒントが用意されています。
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, setBackground, setCursor, setExtendedState, setMaximizedBounds, setMenuBar, setOpacity, setResizable, setShape, setState, setTitle, setUndecorated

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

addPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, dispose, getBackground, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getIconImages, getInputContext, getListeners, getLocale, getModalExclusionType, getMostRecentFocusOwner, getOpacity, getOwnedWindows, getOwner, getOwnerlessWindows, getShape, getToolkit, getType, getWarningString, getWindowFocusListeners, getWindowListeners, getWindows, getWindowStateListeners, hide, isActive, isAlwaysOnTop, isAlwaysOnTopSupported, isAutoRequestFocus, isFocusableWindow, isFocusCycleRoot, isFocused, isLocationByPlatform, isOpaque, isShowing, isValidateRoot, pack, paint, postEvent, processEvent, processWindowFocusEvent, processWindowStateEvent, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, reshape, setAlwaysOnTop, setAutoRequestFocus, setBounds, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setIconImages, setLocation, setLocation, setLocationByPlatform, setLocationRelativeTo, setMinimumSize, setModalExclusionType, setSize, setSize, setType, 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, paintComponents, preferredSize, print, printComponents, processContainerEvent, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, 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, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphicsConfiguration, 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, 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, revalidate, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setMaximumSize, setName, setPreferredSize, show, size, toString, transferFocus, transferFocusBackward, 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

Accessible コンテキストプロパティーです。

コンストラクタの詳細

JFrame

public JFrame()
       throws HeadlessException

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

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

例外:

HeadlessException - GraphicsEnvironment.isHeadless() が true を返した場合。

関連項目:

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

JFrame

public JFrame(GraphicsConfiguration gc)

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

このコンストラクタはコンポーネントのローカルプロパティーを 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)

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

このコンストラクタはコンポーネントのローカルプロパティーを 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 プロパティーの設定値に従って、ウィンドウを非表示にするか、または破棄します。

オーバーライド:

processWindowEvent、クラス: Window

パラメータ:

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 スレッドの問題」を参照してください。

パラメータ:

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) を呼び出すだけです。このメソッドは、バックグラウンドをクリアする不必要な呼び出しが行われないようにするためにオーバーライドされました。

オーバーライド:

update、クラス: Container

パラメータ:

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 を参照してください。

オーバーライド:

addImpl、クラス: Container

パラメータ:

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

constraints - 遵守されるべき制約

index - インデックス

例外:

IllegalArgumentException - index が無効である場合

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

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

関連項目:

setRootPaneCheckingEnabled(boolean), RootPaneContainer

remove

public void remove(Component comp)

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

オーバーライド:

remove、クラス: Container

パラメータ:

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

例外:

NullPointerException - comp が null である場合

関連項目:

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

setLayout

public void setLayout(LayoutManager manager)

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

オーバーライド:

setLayout、クラス: Container

パラメータ:

manager - LayoutManager

関連項目:

setRootPaneCheckingEnabled(boolean), RootPaneContainer

getRootPane

public JRootPane getRootPane()

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

定義:

getRootPane、インタフェース: RootPaneContainer

戻り値:

rootPane プロパティー

関連項目:

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

setRootPane

protected void setRootPane(JRootPane root)

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

パラメータ:

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

関連項目:

getRootPane()

setIconImage

public void setIconImage(Image image)

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

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

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

     setIconImage(image);
 

は、次と同じです。

     ArrayList<Image> imageList = new ArrayList<Image>();
     imageList.add(image);
     setIconImages(imageList);
 

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

オーバーライド:

setIconImage、クラス: Frame

パラメータ:

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

関連項目:

Window.setIconImages(java.util.List<? extends java.awt.Image>), Window.getIconImages()

getContentPane

public Container getContentPane()

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

定義:

getContentPane、インタフェース: RootPaneContainer

戻り値:

contentPane プロパティー

関連項目:

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

setContentPane

public void setContentPane(Container contentPane)

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

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

定義:

setContentPane、インタフェース: RootPaneContainer

パラメータ:

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

例外:

IllegalComponentStateException - (実行時例外) コンテンツペインパラメータが次の場合: null

関連項目:

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

getLayeredPane

public JLayeredPane getLayeredPane()

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

定義:

getLayeredPane、インタフェース: RootPaneContainer

戻り値:

layeredPane プロパティー

関連項目:

setLayeredPane(javax.swing.JLayeredPane), RootPaneContainer.getLayeredPane()

setLayeredPane

public void setLayeredPane(JLayeredPane layeredPane)

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

定義:

setLayeredPane、インタフェース: RootPaneContainer

パラメータ:

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

例外:

IllegalComponentStateException - (実行時例外) 階層化ペインのパラメータが次の場合: null

関連項目:

getLayeredPane(), RootPaneContainer.setLayeredPane(javax.swing.JLayeredPane)

getGlassPane

public Component getGlassPane()

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

定義:

getGlassPane、インタフェース: RootPaneContainer

戻り値:

glassPane プロパティー

関連項目:

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

setGlassPane

public void setGlassPane(Component glassPane)

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

定義:

setGlassPane、インタフェース: RootPaneContainer

パラメータ:

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

関連項目:

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

getGraphics

public Graphics getGraphics()

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

オーバーライド:

getGraphics、クラス: Component

戻り値:

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

導入されたバージョン:

1.6

関連項目:

Component.paint(java.awt.Graphics)

repaint

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

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

オーバーライド:

repaint、クラス: Component

パラメータ:

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

x - x 座標

y - y 座標

width - 幅

height - 高さ

導入されたバージョン:

1.6

関連項目:

RepaintManager

setDefaultLookAndFeelDecorated

public static void setDefaultLookAndFeelDecorated(boolean defaultLookAndFeelDecorated)

新しく生成される JFrame が、現在の Look & Feel (L&F) で実行できるボーダー、ウィンドウクローズ用ウィジェット、タイトルなどのウィンドウ装飾を保持するかどうかのヒントが用意されています。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 (L&F) で実行できるウィンドウ装飾を保持する場合は true を返します。これは単なるヒントであり、Look & Feel がこの機能をサポートしない場合もあります。

戻り値:

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

導入されたバージョン:

1.4

paramString

protected String paramString()

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

オーバーライド:

paramString、クラス: Frame

戻り値:

この JFrame の文字列表現

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

定義:

getAccessibleContext、インタフェース: Accessible

オーバーライド:

getAccessibleContext、クラス: Frame

戻り値:

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