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