javax.swing

クラス JWindow

java.lang.Object

java.awt.Component

java.awt.Container

java.awt.Window

javax.swing.JWindow

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

ImageObserver, MenuContainer, Serializable, Accessible. RootPaneContainer

public class JWindow
extends Window
implements Accessible, RootPaneContainer

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

JWindow コンポーネントには、唯一の子として JRootPane が格納されます。contentPane は、JWindow のすべての子の親になります。便宜上、add とその派生メソッド、remove および setLayout は、必要に応じて contentPane に転送されるようにオーバーライドされています。つまり、次のように記述できます。

       window.add(child);
 

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

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

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

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

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

関連項目:

JRootPane

ネストされたクラスのサマリー

ネストされたクラス

修飾子と型	クラスと説明
protected class	JWindow.AccessibleJWindow このクラスは、JWindow クラスのアクセシビリティーサポートを実装しています。

クラス 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 コンテキストプロパティーです。
protected JRootPane	rootPane glassPane だけでなく、このフレームの contentPane およびオプションの menuBar を管理する JRootPane のインスタンスです。
protected boolean	rootPaneCheckingEnabled true の場合は、add および setLayout の呼び出しが contentPane に転送されます。

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

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

インタフェース java.awt.image.ImageObserver から継承されたフィールド

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
JWindow() オーナの指定されていないウィンドウを作成します。
JWindow(Frame owner) 指定された所有者フレームで、ウィンドウを作成します。
JWindow(GraphicsConfiguration gc) 画面デバイスの指定された GraphicsConfiguration でウィンドウを作成します。
JWindow(Window owner) オーナウィンドウを指定してウィンドウを作成します。
JWindow(Window owner, GraphicsConfiguration gc) 指定された所有者ウィンドウと画面デバイスの GraphicsConfiguration でウィンドウを作成します。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
protected void	addImpl(Component comp, Object constraints, int index) 指定された子 Component を追加します。
protected JRootPane	createRootPane() デフォルトの rootPane を作成するために、コンストラクタメソッドから呼び出されます。
AccessibleContext	getAccessibleContext() この JWindow に関連付けられた AccessibleContext を取得します。
Container	getContentPane() このウィンドウの contentPane である Container を返します。
Component	getGlassPane() このウィンドウの glassPane Component を返します。
Graphics	getGraphics() このコンポーネントのグラフィックスコンテキストを作成します。
JLayeredPane	getLayeredPane() このウィンドウの layeredPane オブジェクトを返します。
JRootPane	getRootPane() このウィンドウの rootPane オブジェクトを返します。
TransferHandler	getTransferHandler() transferHandler プロパティーを取得します。
protected boolean	isRootPaneCheckingEnabled() add および setLayout の呼び出しが contentPane に転送されるかどうかを返します。
protected String	paramString() この JWindow の文字列表現を返します。
void	remove(Component comp) 指定されたコンポーネントをコンテナから削除します。
void	repaint(long time, int x, int y, int width, int height) このコンポーネントの指定された矩形を time ミリ秒以内に再ペイントします。
void	setContentPane(Container contentPane) このウィンドウの contentPane プロパティーを設定します。
void	setGlassPane(Component glassPane) glassPane プロパティーを設定します。
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) を呼び出します。
protected void	windowInit() JWindow を適切に初期化するためにコンストラクタによって呼び出されます。

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

addNotify, 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, processWindowEvent, processWindowFocusEvent, processWindowStateEvent, removeNotify, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, reshape, setAlwaysOnTop, setAutoRequestFocus, setBackground, setBounds, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setIconImage, setIconImages, setLocation, setLocation, setLocationByPlatform, setLocationRelativeTo, setMinimumSize, setModalExclusionType, setOpacity, setShape, 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, remove, 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

フィールドの詳細

rootPane

protected JRootPane rootPane

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

関連項目:

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

rootPaneCheckingEnabled

protected boolean rootPaneCheckingEnabled

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

関連項目:

isRootPaneCheckingEnabled(), setRootPaneCheckingEnabled(boolean), RootPaneContainer

accessibleContext

protected AccessibleContext accessibleContext

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

コンストラクタの詳細

JWindow

public JWindow()

オーナの指定されていないウィンドウを作成します。このウィンドウには、フォーカスが設定されません。

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

例外:

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

関連項目:

GraphicsEnvironment.isHeadless(), Window.isFocusableWindow(), JComponent.getDefaultLocale()

JWindow

public JWindow(GraphicsConfiguration gc)

画面デバイスの指定された GraphicsConfiguration でウィンドウを作成します。このウィンドウには、フォーカスが設定されません。

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

パラメータ:

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

例外:

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

IllegalArgumentException - gc が画面デバイスのものでない場合。

導入されたバージョン:

1.3

関連項目:

GraphicsEnvironment.isHeadless(), Window.isFocusableWindow(), JComponent.getDefaultLocale()

JWindow

public JWindow(Frame owner)

指定された所有者フレームで、ウィンドウを作成します。owner が null の場合は、共有所有者が使用され、このウィンドウにはフォーカスが設定されません。また、所有者が画面に表示されないかぎり、このウィンドウにはフォーカスが設定されません。

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

パラメータ:

owner - ウィンドウを表示するフレーム

例外:

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

関連項目:

GraphicsEnvironment.isHeadless(), Window.isFocusableWindow(), JComponent.getDefaultLocale()

JWindow

public JWindow(Window owner)

オーナウィンドウを指定してウィンドウを作成します。所有者が画面に表示されないかぎり、このウィンドウにはフォーカスが設定されません。owner が null の場合は、共有所有者が使用され、このウィンドウにはフォーカスが設定されません。

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

パラメータ:

owner - ウィンドウを表示するウィンドウ

例外:

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

関連項目:

GraphicsEnvironment.isHeadless(), Window.isFocusableWindow(), JComponent.getDefaultLocale()

JWindow

public JWindow(Window owner,
       GraphicsConfiguration gc)

指定された所有者ウィンドウと画面デバイスの GraphicsConfiguration でウィンドウを作成します。owner が null の場合は、共有所有者が使用され、このウィンドウにはフォーカスが設定されません。

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

パラメータ:

owner - ウィンドウを表示するウィンドウ

gc - 新しいウィンドウの構築に使用する GraphicsConfiguration。gc が null の場合、システムデフォルトの GraphicsConfiguration が使われる。ただし、owner も null の場合は、共有所有者フレームの GraphicsConfiguration が使われる。

例外:

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

IllegalArgumentException - gc が画面デバイスのものでない場合。

導入されたバージョン:

1.3

関連項目:

GraphicsEnvironment.isHeadless(), Window.isFocusableWindow(), JComponent.getDefaultLocale()

メソッドの詳細

windowInit

protected void windowInit()

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

createRootPane

protected JRootPane createRootPane()

デフォルトの rootPane を作成するために、コンストラクタメソッドから呼び出されます。

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

setTransferHandler

public void setTransferHandler(TransferHandler newHandler)

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

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

注: JWindow と組み合わせて使用した場合、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)

setRootPaneCheckingEnabled

protected void setRootPaneCheckingEnabled(boolean enabled)

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

パラメータ:

enabled - add および setLayout が転送される場合は true、JWindow で直接実行する必要がある場合は 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 が JWindow または 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()

getContentPane

public Container getContentPane()

このウィンドウの contentPane である Container を返します。

定義:

getContentPane、インタフェース: RootPaneContainer

戻り値:

contentPane プロパティー

関連項目:

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

setContentPane

public void setContentPane(Container contentPane)

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

定義:

setContentPane、インタフェース: RootPaneContainer

パラメータ:

contentPane - 新しい contentPane

例外:

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

関連項目:

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

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 Component を返します。

定義:

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

paramString

protected String paramString()

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

オーバーライド:

paramString、クラス: Container

戻り値:

この JWindow の文字列表現

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

定義:

getAccessibleContext、インタフェース: Accessible

オーバーライド:

getAccessibleContext、クラス: Window

戻り値:

この JWindow の AccessibleContext として機能する AccessibleJWindow