javax.swing

クラス JDesktopPane

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JLayeredPane

javax.swing.JDesktopPane

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

ImageObserver, MenuContainer, Serializable, Accessible

public class JDesktopPane
extends JLayeredPane
implements Accessible

マルチドキュメントインタフェースまたは仮想デスクトップを生成するコンテナです。JInternalFrame オブジェクトを生成し、JDesktopPane に追加します。JDesktopPane は JLayeredPane を拡張し、オーバーラップの可能性がある内部フレームを管理します。また、現在の Look & Feel (L&F) に対して UI クラスで設定された DesktopManager のインスタンスへの参照も維持します。JDesktopPane はボーダーをサポートしません。

このクラスは通常、JInternalFrames の親として使用され、プラグイン可能な DesktopManager オブジェクトを JInternalFrames に提供します。L&F 別に実装される installUI で、desktopManager 変数の適切な設定を行います。JInternalFrame の親が JDesktopPane の場合、クローズやサイズ変更などの動作のほとんどを desktopManager に委譲します。

詳細と使用例については、「The Java Tutorial」の「How to Use Internal Frames」を参照してください。

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

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

関連項目:

JInternalFrame, JInternalFrame.JDesktopIcon, DesktopManager

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

ネストされたクラス

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

クラス javax.swing.JLayeredPane から継承されたネストされたクラス/インタフェース

JLayeredPane.AccessibleJLayeredPane

クラス javax.swing.JComponent から継承されたネストされたクラス/インタフェース

JComponent.AccessibleJComponent

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

Container.AccessibleAWTContainer

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

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

フィールドのサマリー

フィールド

修飾子と型	フィールドと説明
static int	LIVE_DRAG_MODE ドラッグの対象となっている項目のコンテンツ全体をデスクトップペイン内に表示することを示します。
static int	OUTLINE_DRAG_MODE ドラッグの対象となっている項目のアウトラインだけをデスクトップペイン内に表示することを示します。

クラス javax.swing.JLayeredPane から継承されたフィールド

DEFAULT_LAYER, DRAG_LAYER, FRAME_CONTENT_LAYER, LAYER_PROPERTY, MODAL_LAYER, PALETTE_LAYER, POPUP_LAYER

クラス javax.swing.JComponent から継承されたフィールド

accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

クラス 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

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

コンストラクタ

コンストラクタと説明
JDesktopPane() 新しい JDesktopPane を作成します。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
protected void	addImpl(Component comp, Object constraints, int index) 指定されたコンポーネントを、指定されたインデックスで、コンテナへ追加します。
AccessibleContext	getAccessibleContext() この JDesktopPane に関連付けられている AccessibleContext を取得します。
JInternalFrame[]	getAllFrames() 現在デスクトップに表示されているすべての JInternalFrames を返します。
JInternalFrame[]	getAllFramesInLayer(int layer) デスクトップの指定したレイヤーに現在表示されているすべての JInternalFrames を返します。
DesktopManager	getDesktopManager() デスクトップ固有の UI アクションを処理する DesktopManger を返します。
int	getDragMode() デスクトップペインで現在使用されている「ドラッグスタイル」を取得します。
JInternalFrame	getSelectedFrame() この JDesktopPane の現在アクティブな JInternalFrame を返します。現在 JInternalFrame がアクティブでない場合は、null を返します。
DesktopPaneUI	getUI() このコンポーネントをレンダリングする L&F オブジェクトを返します。
String	getUIClassID() このコンポーネントをレンダリングする L&F クラスの名前を返します。
protected String	paramString() この JDesktopPane の文字列表現を返します。
void	remove(Component comp) このコンテナから、指定されたコンポーネントを削除します。
void	remove(int index) このペインからインデックス付きのコンポーネントを削除します。
void	removeAll() このコンテナからすべてのコンポーネントを削除します。
JInternalFrame	selectFrame(boolean forward) このデスクトップペイン内の次の JInternalFrame を選択します。
void	setComponentZOrder(Component comp, int index) 指定されたコンポーネントを、コンテナの指定された Z 軸順のインデックスに移動します。
void	setDesktopManager(DesktopManager d) デスクトップ固有の UI アクションを処理する DesktopManger を設定します。
void	setDragMode(int dragMode) デスクトップペインで使用される「ドラッグスタイル」を設定します。
void	setSelectedFrame(JInternalFrame f) この JDesktopPane に現在アクティブな JInternalFrame を設定します。
void	setUI(DesktopPaneUI ui) このコンポーネントをレンダリングする L&F オブジェクトを設定します。
void	updateUI() L&F が変更されたことを示す、UIManager からの通知です。

クラス javax.swing.JLayeredPane から継承されたメソッド

getComponentCountInLayer, getComponentsInLayer, getComponentToLayer, getIndexOf, getLayer, getLayer, getLayeredPaneAbove, getObjectForLayer, getPosition, highestLayer, insertIndexForLayer, isOptimizedDrawingEnabled, lowestLayer, moveToBack, moveToFront, paint, putLayer, setLayer, setLayer, setPosition

クラス javax.swing.JComponent から継承されたメソッド

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

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

add, add, add, add, add, addContainerListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, removeContainerListener, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree

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

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

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

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

フィールドの詳細

LIVE_DRAG_MODE

public static final int LIVE_DRAG_MODE

ドラッグの対象となっている項目のコンテンツ全体をデスクトップペイン内に表示することを示します。

関連項目:

OUTLINE_DRAG_MODE、setDragMode(int)、定数フィールド値

OUTLINE_DRAG_MODE

public static final int OUTLINE_DRAG_MODE

ドラッグの対象となっている項目のアウトラインだけをデスクトップペイン内に表示することを示します。

関連項目:

LIVE_DRAG_MODE、setDragMode(int)、定数フィールド値

コンストラクタの詳細

JDesktopPane

public JDesktopPane()

新しい JDesktopPane を作成します。

メソッドの詳細

getUI

public DesktopPaneUI getUI()

このコンポーネントをレンダリングする L&F オブジェクトを返します。

戻り値:

このコンポーネントをレンダリングする DesktopPaneUI オブジェクト

setUI

public void setUI(DesktopPaneUI ui)

このコンポーネントをレンダリングする L&F オブジェクトを設定します。

パラメータ:

ui - DesktopPaneUI の L&F オブジェクト

関連項目:

UIDefaults.getUI(javax.swing.JComponent)

setDragMode

public void setDragMode(int dragMode)

デスクトップペインで使用される「ドラッグスタイル」を設定します。パフォーマンス上または表示上の理由で、別のモードに変更することができます。

パラメータ:

dragMode - デスクトップの項目に使用するドラッグのスタイル

導入されたバージョン:

1.3

関連項目:

LIVE_DRAG_MODE, OUTLINE_DRAG_MODE

getDragMode

public int getDragMode()

デスクトップペインで現在使用されている「ドラッグスタイル」を取得します。

戻り値:

Live_DRAG_MODE または OUTLINE_DRAG_MODE

導入されたバージョン:

1.3

関連項目:

setDragMode(int)

getDesktopManager

public DesktopManager getDesktopManager()

デスクトップ固有の UI アクションを処理する DesktopManger を返します。

setDesktopManager

public void setDesktopManager(DesktopManager d)

デスクトップ固有の UI アクションを処理する DesktopManger を設定します。これを LookAndFeel でオーバーライドしてもかまいません。

パラメータ:

d - 使用する DesktopManager

updateUI

public void updateUI()

L&F が変更されたことを示す、UIManager からの通知です。現在の UI オブジェクトを UIManager の最新バージョンに置き換えます。

オーバーライド:

updateUI 、クラス: JComponent

関連項目:

JComponent.updateUI()

getUIClassID

public String getUIClassID()

このコンポーネントをレンダリングする L&F クラスの名前を返します。

オーバーライド:

getUIClassID 、クラス: JComponent

戻り値:

DesktopPaneUI の文字列

関連項目:

JComponent.getUIClassID(), UIDefaults.getUI(javax.swing.JComponent)

getAllFrames

public JInternalFrame[] getAllFrames()

現在デスクトップに表示されているすべての JInternalFrames を返します。展開表示されているフレームだけでなく、アイコン化されているフレームも返します。

戻り値:

JInternalFrame オブジェクトの配列

getSelectedFrame

public JInternalFrame getSelectedFrame()

この JDesktopPane の現在アクティブな JInternalFrame を返します。現在 JInternalFrame がアクティブでない場合は、null を返します。

戻り値:

現在アクティブな JInternalFrame または null

導入されたバージョン:

1.3

setSelectedFrame

public void setSelectedFrame(JInternalFrame f)

この JDesktopPane に現在アクティブな JInternalFrame を設定します。このメソッドは、JDesktopPane とプラットフォーム実装コード間のパッケージのギャップを埋め合わせるために使用されます。直接呼び出してはいけません。フレームを視覚的に選択するために、クライアントは JInternalFrame.setSelected(true) を呼び出してフレームをアクティブにする必要があります。

パラメータ:

f - 現在選択されている内部フレーム

導入されたバージョン:

1.3

関連項目:

JInternalFrame.setSelected(boolean)

getAllFramesInLayer

public JInternalFrame[] getAllFramesInLayer(int layer)

デスクトップの指定したレイヤーに現在表示されているすべての JInternalFrames を返します。展開表示されているフレームだけでなく、アイコン化されているフレームも返します。

パラメータ:

layer - デスクトップレイヤーを指定する整数値

戻り値:

JInternalFrame オブジェクトの配列

関連項目:

JLayeredPane

remove

public void remove(Component comp)

このコンテナから、指定されたコンポーネントを削除します。このメソッドはまた、removeLayoutComponent メソッドを使用してこのコンテナのレイアウトからコンポーネントを削除するために、レイアウトマネージャーにも通知します。

このメソッドではレイアウトに関連する情報が変更されるため、コンポーネント階層が無効になります。コンテナがすでに表示されている場合は、変更を反映するために、あとで階層を検証する必要があります。

オーバーライド:

remove 、クラス: Container

パラメータ:

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

関連項目:

Container.add(java.awt.Component), Container.invalidate(), Container.validate(), Container.remove(int)

selectFrame

public JInternalFrame selectFrame(boolean forward)

このデスクトップペイン内の次の JInternalFrame を選択します。

パラメータ:

forward - 選択する方向を示す boolean 値。前方の場合は true、後方の場合は false

戻り値:

選択された JInternalFrame。何も選択されなかった場合は null

導入されたバージョン:

1.6

addImpl

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

指定されたコンポーネントを、指定されたインデックスで、コンテナへ追加します。また、このメソッドは、addLayoutComponent メソッドを使用して、指定された制約オブジェクトを使ってこのコンテナのレイアウトにコンポーネントを追加することをレイアウトマネージャーに通知します。

制約は、使用されているレイアウトマネージャーで定義されます。たとえば BorderLayout クラスは、BorderLayout.NORTH、BorderLayout.SOUTH、BorderLayout.EAST、BorderLayout.WEST、および BorderLayout.CENTER の 5 つの制約を定義します。

GridBagLayout クラスには GridBagConstraints オブジェクトが必要です。正しい型の制約オブジェクトを渡さないと、IllegalArgumentException が発生します。

現在のレイアウトマネージャーが LayoutManager2 を実装する場合は、LayoutManager2.addLayoutComponent(Component,Object) が呼び出されます。現在のレイアウトマネージャーが LayoutManager2 を実装せず、制約が String の場合は、LayoutManager.addLayoutComponent(String,Component) が呼び出されます。

コンポーネントがこのコンテナの祖先ではなく、null でない親を持つ場合は、このコンテナに追加される前に現在の親から削除されます。

これは、プログラムがコンテナへのすべての追加要求を追跡する必要がある場合にオーバーライドするメソッドです。ほかのすべての追加メソッドはこれに従います。オーバーライドするメソッドは通常、メソッドのスーパークラスバージョンへの呼び出しを含めるようにしてください。

super.addImpl(comp, constraints, index)

このメソッドではレイアウトに関連する情報が変更されるため、コンポーネント階層が無効になります。コンテナがすでに表示されている場合は、追加されたコンポーネントを表示するために、あとで階層を検証する必要があります。

オーバーライド:

addImpl 、クラス: JLayeredPane

パラメータ:

comp - 追加されるコンポーネント

constraints - このコンポーネントのレイアウト制約を表現するオブジェクト

index - コンポーネントを挿入するコンテナのリスト内での位置。-1 は最後に挿入することを意味する

導入されたバージョン:

1.6

関連項目:

Container.add(Component), Container.add(Component, int), Container.add(Component, java.lang.Object), Container.invalidate(), LayoutManager, LayoutManager2

remove

public void remove(int index)

このペインからインデックス付きのコンポーネントを削除します。絶対インデックスであり、レイヤーは無視します。

オーバーライド:

remove 、クラス: JLayeredPane

パラメータ:

index - 削除するコンポーネントを指定した int 値

導入されたバージョン:

1.6

関連項目:

JLayeredPane.getIndexOf(java.awt.Component)

removeAll

public void removeAll()

このコンテナからすべてのコンポーネントを削除します。

オーバーライド:

removeAll 、クラス: JLayeredPane

導入されたバージョン:

1.6

関連項目:

Container.add(java.awt.Component), Container.remove(int), Container.invalidate()

setComponentZOrder

public void setComponentZOrder(Component comp,
                      int index)

指定されたコンポーネントを、コンテナの指定された Z 軸順のインデックスに移動します。Z 軸順によって、コンポーネントがペイントされる順番が決まります。Z 軸順が最高のコンポーネントが最初にペイントされ、Z 軸順が最低のコンポーネントが最後にペイントされます。コンポーネントがオーバーラップされる場合、Z 軸順の低いコンポーネントが Z 軸順の高いコンポーネントの上にペイントされます。

コンポーネントがほかのコンテナの子である場合、このコンテナに追加される前にそのコンテナから削除されます。このメソッドと java.awt.Container.add(Component, int) の違いは、前のコンテナから削除される際に、必要でないかぎり、またベースとなるネィティブウィンドウシステムによって許可されているかぎり、このメソッドがコンポーネントに対して removeNotify を呼び出さないことです。このように、コンポーネントにキーボードフォーカスがある場合、そのコンポーネントが新しい位置に移動されてもフォーカスを維持します。

このプロパティーは軽量の Container 以外のコンポーネントのみに適用されます。

このメソッドではレイアウトに関連する情報が変更されるため、コンポーネント階層が無効になります。

注:removeNotify を呼び出さずに、別のコンテナへの重量コンポーネントの Z 軸順の変更をサポートしていないプラットフォームもあります。プラットフォームでこれがサポートされているかどうかを判断する方法はないため、開発者は推測しないようにしてください。

オーバーライド:

setComponentZOrder 、クラス: Container

パラメータ:

comp - 移動されるコンポーネント

index - コンポーネントを挿入するコンテナのリスト内での位置。getComponentCount() は末尾に挿入することを意味する

導入されたバージョン:

1.6

関連項目:

Container.getComponentZOrder(java.awt.Component), Container.invalidate()

paramString

protected String paramString()

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

オーバーライド:

paramString 、クラス: JLayeredPane

戻り値:

この JDesktopPane の文字列表現

getAccessibleContext

public AccessibleContext getAccessibleContext()

この JDesktopPane に関連付けられている AccessibleContext を取得します。AccessibleContext はデスクトップペインのフォームを AccessibleJDesktopPane から取得します。必要に応じて、新しい AccessibleJDesktopPane インスタンスが作成されます。

定義:

getAccessibleContext 、インタフェース: Accessible

オーバーライド:

getAccessibleContext 、クラス: JLayeredPane

戻り値:

この JDesktopPane の AccessibleContext として機能する AccessibleJDesktopPane