javax.swing
クラス JWindow

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.Container
              |
              +--java.awt.Window
                    |
                    +--javax.swing.JWindow

public class JWindow

extends Window

implements Accessible, RootPaneContainer

JWindow は、ユーザのデスクトップ上のどこにでも表示できるコンテナです。JWindow は、タイトルバー、ウィンドウ管理ボタン、または JFrame に関連付けられているほかの装飾を持ちませんが、それでもユーザのデスクトップの「最上級のメンバー」であり、そのどこにでも表示できます。

JWindow コンポーネントは、JRootPane を唯一の子として保持します。contentPane() は、JWindow の子の親でなければなりません。古い java.awt.Window オブジェクトからは、通常は次のようにしました。

       window.add(child);
 

しかし、JWindow では次のようなコードになります。

       window.getContentPane().add(child);
 

LayoutManager の設定、コンポーネントの削除、子の一覧表示などの場合も同じです。通常、それらのメソッドはすべて JWindow 自体ではなく contentPane() に送られなければなりません。contentPane() は常に null 以外の値になります。null に設定しようとすると、JWindow が例外をスローします。デフォルトの contentPane() は、BorderLayout マネージャが設定されます。

contentPane()、glassPane()、および layeredPane() コンポーネントについては、JRootPane の説明を参照してください。

標準の Look & Feel (L&F) 表現でこのコンポーネントが使用するキーボードのキーについては、JWindow のキーの割り当てを参照してください。

警告: このクラスの直列化されたオブジェクトは、今後の Swing リリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の運用や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。今後の Swing リリースでは、長期間の持続性をサポートする予定です。

関連項目:

JRootPane, 直列化された形式

内部クラスの概要

protected class

JWindow.AccessibleJWindow オブジェクトのユーザ補助機能を取得するために使用されるクラスです。

フィールドの概要

protected AccessibleContext	accessibleContext ユーザ補助のコンテキストプロパティです。
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

コンストラクタの概要

JWindow()
オーナの指定されていないウィンドウを作成します。

JWindow(Frame owner)
指定されたオーナフレームを持つウィンドウを作成します。

メソッドの概要

protected void	addImpl(Component comp, Object constraints, int index) デフォルトでは、子はこのコンポーネントに直接追加できず、代わりに contentPane に追加されなければなりません。
protected JRootPane	createRootPane() コンストラクタメソッドによって呼び出され、デフォルトの rootPane を作成します。
AccessibleContext	getAccessibleContext() この JWindow に関連付けられている AccessibleContext を取得します。
Container	getContentPane() このウィンドウの contentPane オブジェクトを返します。
Component	getGlassPane() このウィンドウの glassPane オブジェクトを返します。
JLayeredPane	getLayeredPane() このウィンドウの layeredPane オブジェクトを返します。
JRootPane	getRootPane() このウィンドウの rootPane オブジェクトを返します。
protected boolean	isRootPaneCheckingEnabled() add および setLayout の呼び出しが例外をスローするかどうかを返します。
protected String	paramString() この JWindow の文字列表現を返します。
void	setContentPane(Container contentPane) contentPane プロパティを設定します。
void	setGlassPane(Component glassPane) glassPane プロパティを設定します。
void	setLayeredPane(JLayeredPane layeredPane) layeredPane プロパティを設定します。
void	setLayout(LayoutManager manager) デフォルトでは、このコンポーネントのレイアウトは設定できません。
protected void	setRootPane(JRootPane root) rootPane プロパティを設定します。
protected void	setRootPaneCheckingEnabled(boolean enabled) add および setLayout の呼び出しが例外をスローするかどうかを設定します。
protected void	windowInit() コンストラクタによって呼び出され、JWindow プロパティを初期化します。

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

addNotify, addWindowListener, applyResourceBundle, applyResourceBundle, dispose, finalize, getFocusOwner, getInputContext, getLocale, getOwnedWindows, getOwner, getToolkit, getWarningString, isShowing, pack, postEvent, processEvent, processWindowEvent, removeWindowListener, show, toBack, toFront

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

add, add, add, add, add, addContainerListener, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getInsets, getLayout, getMaximumSize, getMinimumSize, getPreferredSize, insets, invalidate, isAncestorOf, layout, list, list, locate, minimumSize, paint, paintComponents, preferredSize, print, printComponents, processContainerEvent, remove, remove, removeAll, removeContainerListener, removeNotify, setFont, update, validate, validateTree

クラス java.awt.Component から継承したメソッド

action, add, addComponentListener, addFocusListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addPropertyChangeListener, addPropertyChangeListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, getBackground, getBounds, getBounds, getColorModel, getComponentOrientation, getCursor, getDropTarget, getFont, getFontMetrics, getForeground, getGraphics, getHeight, getInputMethodRequests, getLocation, getLocation, getLocationOnScreen, getName, getParent, getPeer, getSize, getSize, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isDisplayable, isDoubleBuffered, isEnabled, isFocusTraversable, isLightweight, isOpaque, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, remove, removeComponentListener, removeFocusListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, reshape, resize, resize, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setForeground, setLocale, setLocation, setLocation, setName, setSize, setSize, setVisible, show, size, toString, transferFocus

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

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

フィールドの詳細

rootPane

protected JRootPane rootPane

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

関連項目:

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

rootPaneCheckingEnabled

protected boolean rootPaneCheckingEnabled

true の場合、add および setLayout を呼び出すと例外がスローされます。

関連項目:

isRootPaneCheckingEnabled(), setRootPaneCheckingEnabled(boolean)

accessibleContext

protected AccessibleContext accessibleContext

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

コンストラクタの詳細

JWindow

public JWindow()

オーナの指定されていないウィンドウを作成します。

JWindow

public JWindow(Frame owner)

指定されたオーナフレームを持つウィンドウを作成します。

パラメータ:

owner - ウィンドウが表示されるフレーム

メソッドの詳細

windowInit

protected void windowInit()

コンストラクタによって呼び出され、JWindow プロパティを初期化します。

createRootPane

protected JRootPane createRootPane()

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

isRootPaneCheckingEnabled

protected boolean isRootPaneCheckingEnabled()

add および setLayout の呼び出しが例外をスローするかどうかを返します。

戻り値:

add および setLayout が調べられる場合は true

関連項目:

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

setRootPaneCheckingEnabled

protected void setRootPaneCheckingEnabled(boolean enabled)

add および setLayout の呼び出しが例外をスローするかどうかを設定します。

パラメータ:

enabled - boolean 値。true の場合は、調査を有効にして例外をスローする

関連項目:

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

addImpl

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

デフォルトでは、子はこのコンポーネントに直接追加できず、代わりに contentPane に追加されなければなりません。次に例を示します。

 thisComponent.getContentPane().add(child)
 

このコンポーネントに直接追加しようとすると、実行時例外がスローされます。サブクラスはこの動作を無効にできます。

例外:

Error - rootPaneChecking が true で呼び出された場合

オーバーライド:

クラス Container 内の addImpl

関連項目:

setRootPaneCheckingEnabled(boolean)

setLayout

public void setLayout(LayoutManager manager)

デフォルトでは、このコンポーネントのレイアウトは設定できません。代わりに、contentPane のレイアウトを設定しなければなりません。次に例を示します。

 thisComponent.getContentPane().setLayout(new BorderLayout())
 

このコンポーネントのレイアウトを設定しようとすると、実行時例外がスローされます。サブクラスはこの動作を無効にできます。

例外:

Error - rootPaneChecking が true で呼び出された場合

オーバーライド:

クラス Container 内の setLayout

関連項目:

setRootPaneCheckingEnabled(boolean)

getRootPane

public JRootPane getRootPane()

このウィンドウの rootPane オブジェクトを返します。

定義:

インタフェース RootPaneContainer 内の getRootPane

関連項目:

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

setRootPane

protected void setRootPane(JRootPane root)

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

パラメータ:

root - このウィンドウの rootPane オブジェクト

関連項目:

getRootPane()

getContentPane

public Container getContentPane()

このウィンドウの contentPane オブジェクトを返します。

定義:

インタフェース RootPaneContainer 内の getContentPane

戻り値:

contentPane である Container

関連項目:

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

setContentPane

public void setContentPane(Container contentPane)

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

定義:

インタフェース RootPaneContainer 内の setContentPane

パラメータ:

contentPane - このウィンドウの contentPane オブジェクト

例外:

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

関連項目:

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

getLayeredPane

public JLayeredPane getLayeredPane()

このウィンドウの layeredPane オブジェクトを返します。

定義:

インタフェース RootPaneContainer 内の getLayeredPane

戻り値:

JLayeredPane オブジェクト

関連項目:

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 である Component

関連項目:

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

setGlassPane

public void setGlassPane(Component glassPane)

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

定義:

インタフェース RootPaneContainer 内の setGlassPane

パラメータ:

glassPane - このウィンドウの glassPane オブジェクト

関連項目:

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

paramString

protected String paramString()

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

JFC コンポーネントの新しい側面についての情報を返すには、paramString() をオーバーライドします。

戻り値:

この JWindow の文字列表現

オーバーライド:

クラス Container 内の paramString

getAccessibleContext

public AccessibleContext getAccessibleContext()

この JWindow に関連付けられている AccessibleContext を取得します。

定義:

インタフェース Accessible 内の getAccessibleContext

戻り値:

この JWindow の AccessibleContext