- java.lang.Object
-
- java.awt.Component
-
- java.awt.Container
-
- javax.swing.JComponent
-
- javax.swing.JLayeredPane
-
- javax.swing.JDesktopPane
-
- すべての実装されたインタフェース:
ImageObserver
,MenuContainer
,Serializable
,Accessible
@JavaBean(defaultProperty="UI") 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™用の長期間の格納サポートが
java.beans
パッケージに追加されています。XMLEncoder
を参照してください。- 導入されたバージョン:
- 1.2
- 関連項目:
JInternalFrame
,JInternalFrame.JDesktopIcon
,DesktopManager
, 「直列化されたフォーム」
-
-
ネストされたクラスのサマリー
ネストされたクラス 修飾子と型 クラス 説明 protected class
JDesktopPane.AccessibleJDesktopPane
このクラスはJDesktopPane
クラスのアクセシビリティ・サポートを実装しています。-
クラス java.awt.Componentから継承されたネストされたクラス/インタフェース
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
-
クラス java.awt.Containerから継承されたネストされたクラス/インタフェース
Container.AccessibleAWTContainer
-
クラス javax.swing.JComponentから継承されたネストされたクラス/インタフェース
JComponent.AccessibleJComponent
-
クラス javax.swing.JLayeredPaneから継承されたネストされたクラス/インタフェース
JLayeredPane.AccessibleJLayeredPane
-
-
フィールドのサマリー
フィールド 修飾子と型 フィールド 説明 static int
LIVE_DRAG_MODE
ドラッグの対象となっている項目のコンテンツ全体をデスクトップ・ペイン内に表示することを示します。static int
OUTLINE_DRAG_MODE
ドラッグの対象となっている項目のアウトラインだけをデスクトップ・ペイン内に表示することを示します。-
クラス java.awt.Componentから継承されたフィールド
accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
-
インタフェース java.awt.image.ImageObserverから継承されたフィールド
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
-
クラス javax.swing.JComponentから継承されたフィールド
listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
-
クラス javax.swing.JLayeredPaneから継承されたフィールド
DEFAULT_LAYER, DRAG_LAYER, FRAME_CONTENT_LAYER, LAYER_PROPERTY, MODAL_LAYER, PALETTE_LAYER, POPUP_LAYER
-
-
コンストラクタのサマリー
コンストラクタ コンストラクタ 説明 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(int index)
このペインからインデックス付きのコンポーネントを削除します。void
remove(Component comp)
このコンテナから、指定されたコンポーネントを削除します。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
からの通知です。-
クラス 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, 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, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle
-
クラス 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
-
クラス 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
-
クラス javax.swing.JLayeredPaneから継承されたメソッド
getComponentCountInLayer, getComponentsInLayer, getComponentToLayer, getIndexOf, getLayer, getLayer, getLayeredPaneAbove, getObjectForLayer, getPosition, highestLayer, insertIndexForLayer, isOptimizedDrawingEnabled, lowestLayer, moveToBack, moveToFront, paint, putLayer, setLayer, setLayer, setPosition
-
-
-
-
メソッドの詳細
-
getUI
public DesktopPaneUI getUI()
このコンポーネントを描画するL&Fオブジェクトを返します。- オーバーライド:
- クラス
JComponent
のgetUI
- 戻り値:
- このコンポーネントをレンダリングする
DesktopPaneUI
オブジェクト
-
setUI
@BeanProperty(hidden=true, visualUpdate=true, description="The UI object that implements the Component\'s LookAndFeel.") public void setUI(DesktopPaneUI ui)
このコンポーネントを描画するL&Fオブジェクトを設定します。- パラメータ:
ui
- DesktopPaneUIのL&Fオブジェクト- 関連項目:
UIDefaults.getUI(javax.swing.JComponent)
-
setDragMode
@BeanProperty(enumerationValues={"JDesktopPane.LIVE_DRAG_MODE","JDesktopPane.OUTLINE_DRAG_MODE"}, description="Dragging style for internal frame children.") 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
を返します。- 戻り値:
- デスクトップ固有のUIアクションを処理する
DesktopManger
-
setDesktopManager
@BeanProperty(description="Desktop manager to handle the internal frames in the desktop pane.") public void setDesktopManager(DesktopManager d)
デスクトップ固有のUIアクションを処理するDesktopManger
を設定します。 これをLookAndFeel
でオーバーライドしてもかまいません。- パラメータ:
d
- 使用するDesktopManager
-
updateUI
public void updateUI()
L&Fが変更されたことを示す、UIManager
からの通知です。 現在のUIオブジェクトをUIManager
の最新バージョンに置き換えます。- オーバーライド:
updateUI
、クラス:JComponent
- 関連項目:
JComponent.updateUI()
-
getUIClassID
@BeanProperty(bound=false) public String getUIClassID()
このコンポーネントを描画するL&Fクラスの名前を返します。- オーバーライド:
getUIClassID
、クラス:JComponent
- 戻り値:
- DesktopPaneUIの文字列
- 関連項目:
JComponent.getUIClassID()
,UIDefaults.getUI(javax.swing.JComponent)
-
getAllFrames
@BeanProperty(bound=false) 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
@BeanProperty(bound=false) public AccessibleContext getAccessibleContext()
このJDesktopPane
に関連付けられているAccessibleContext
を取得します。AccessibleContext
はデスクトップ・ペインのフォームをAccessibleJDesktopPane
から取得します。 必要に応じて、新しいAccessibleJDesktopPane
インスタンスが作成されます。- 定義:
getAccessibleContext
、インタフェース:Accessible
- オーバーライド:
getAccessibleContext
、クラス:JLayeredPane
- 戻り値:
- この
JDesktopPane
のAccessibleContext
として機能するAccessibleJDesktopPane
-
-