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 に適しています。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.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)

オーバーライド:

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

戻り値:

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