JavaTM Platform
Standard Ed. 6

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 に追加します。JDesktopPaneJLayeredPane を拡張し、オーバーラップの可能性がある内部フレームを管理します。また、現在の 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 に適しています。JDK Version 1.4 以降、すべての JavaBeans の長期間の運用サポートは、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()
          現在デスクトップに表示されているすべての JInternalFrame を返します。
 JInternalFrame[] getAllFramesInLayer(int layer)
          デスクトップの指定したレイヤーに現在表示されているすべての JInternalFrame を返します。
 DesktopManager getDesktopManager()
          デスクトップ固有の UI アクションを処理する DesktopManger を返します。
 int getDragMode()
          デスクトップ区画で現在使用されている「ドラッグスタイル」を取得します。
 JInternalFrame getSelectedFrame()
          この JDesktopPane の現在アクティブな JInternalFrame を返します。
 DesktopPaneUI getUI()
          このコンポーネントを描画する L&F オブジェクトを返します。
 String getUIClassID()
          このコンポーネントを描画する L&F クラスの名前を返します。
protected  String paramString()
          この JDesktopPane の文字列表現を返します。
 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, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isPaintingForPrint, 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, remove, removeContainerListener, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusBackward, 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, hide, 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, 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 を設定します。

パラメータ:
d - 使用する DesktopManager

updateUI

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

オーバーライド:
クラス JComponent 内の updateUI
関連項目:
JComponent.updateUI()

getUIClassID

public String getUIClassID()
このコンポーネントを描画する L&F クラスの名前を返します。

オーバーライド:
クラス JComponent 内の getUIClassID
戻り値:
DesktopPaneUI の文字列
関連項目:
JComponent.getUIClassID(), UIDefaults.getUI(javax.swing.JComponent)

getAllFrames

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

戻り値:
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)
デスクトップの指定したレイヤーに現在表示されているすべての JInternalFrame を返します。展開表示されているフレームだけでなく、アイコン化されているフレームも返します。

パラメータ:
layer - デスクトップレイヤーを指定する整数値
戻り値:
JInternalFrame オブジェクトの配列
関連項目:
JLayeredPane

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.NORTHBorderLayout.SOUTHBorderLayout.EASTBorderLayout.WEST、および BorderLayout.CENTER の 5 つの制約を定義します。

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

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

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

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

super.addImpl(comp, constraints, index)

オーバーライド:
クラス JLayeredPane 内の addImpl
パラメータ:
comp - 追加されるコンポーネント
constraints - このコンポーネントの配置制約を表現するオブジェクト
index - コンポーネントを挿入するコンテナのリスト内での位置。-1 は最後に挿入することを意味する
導入されたバージョン:
1.6
関連項目:
Container.add(Component), Container.add(Component, int), Container.add(Component, java.lang.Object), LayoutManager, LayoutManager2

remove

public void remove(int index)
この区画からインデックス付きのコンポーネントを削除します。絶対インデックスであり、レイヤーは無視します。

オーバーライド:
クラス JLayeredPane 内の remove
パラメータ:
index - 削除するコンポーネントを指定した int 値
導入されたバージョン:
1.6
関連項目:
JLayeredPane.getIndexOf(java.awt.Component)

removeAll

public void removeAll()
コンテナからすべてのコンポーネントを削除します。

オーバーライド:
クラス JLayeredPane 内の removeAll
導入されたバージョン:
1.6
関連項目:
Container.add(java.awt.Component), Container.remove(int)

setComponentZOrder

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

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

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

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

オーバーライド:
クラス Container 内の setComponentZOrder
パラメータ:
comp - 移動されるコンポーネント
index - コンポーネントを挿入するコンテナのリスト内での位置。getComponentCount() は最後に挿入することを意味する
導入されたバージョン:
1.6
関連項目:
Container.getComponentZOrder(java.awt.Component)

paramString

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

オーバーライド:
クラス JLayeredPane 内の paramString
戻り値:
この JDesktopPane の文字列表現

getAccessibleContext

public AccessibleContext getAccessibleContext()
この JDesktopPane に関連付けられた AccessibleContext を取得します。AccessibleContext はデスクトップ区画のフォームを AccessibleJDesktopPane から取得します。必要な場合は新しい AccessibleJDesktopPane インスタンスを生成します。

定義:
インタフェース Accessible 内の getAccessibleContext
オーバーライド:
クラス JLayeredPane 内の getAccessibleContext
戻り値:
この JDesktopPaneAccessibleContext として機能する AccessibleJDesktopPane

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2009 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。