JavaTM 2 Platform
Standard Ed. 5.0

javax.swing
クラス JRootPane

java.lang.Object
  上位を拡張 java.awt.Component
      上位を拡張 java.awt.Container
          上位を拡張 javax.swing.JComponent
              上位を拡張 javax.swing.JRootPane
すべての実装されたインタフェース:
ImageObserver, MenuContainer, Serializable, Accessible

public class JRootPane
extends JComponent
implements Accessible

JFrameJDialogJWindowJApplet、および JInternalFrame が内部で使用する軽量コンテナです。ルート区画が提供するタスク指向の情報については、「The Java Tutorial」の「How to Use Root Panes」を参照してください。

次の図はルート区画を使用するクラス間の関係を示します。

次の文は、この図について説明しています。

「重量」コンポーネント (ピアまたはホストシステム上のネイティブコンポーネントに委譲するコンポーネント) は濃く重そうなボックスで示されています。4 つの重量 JFC/Swing コンテナ (JFrameJDialogJWindow、および JApplet) は、それらが拡張する AWT クラスとの関連で示されています。Swing ライブラリ内の重量コンテナはこれら 4 つのコンポーネントのみです。また、軽量コンテナの JInternalPane も示されています。これら 5 つの JFC/Swing コンテナはすべて RootPaneContainer インタフェースを実装し、処理を JRootPane (上部に小さな「ハンドル」が付いている) に委譲します。
注: JComponent のメソッド getRootPane を使用すると、指定されたコンポーネントを格納している JRootPane を取得できます。
次の文は、この図について説明しています。
右側の図は JRootPane の構造を示しています。JRootPaneglassPanemenuBar (オプション)、contentPane から成ります (JLayeredPanemenuBarcontentPane を管理する)。glassPane はすべてのコンポーネントの一番上に置かれ、マウスの動作を捕捉します。glassPane は (contentPane と同様に)、任意コンポーネントにすることができるので、描画のために glassPane をセットアップすることもできます。glassPane 上の線とイメージは、境界に制限されることなく、下のフレーム全体を覆うことができます。

menuBar コンポーネントはなくてもかまいませんが、layeredPanecontentPane、および glassPane は必ず必要です。これらを null に設定しようとすると、例外が生成されます。

JRootPane にコンポーネントを追加するには (オプションのメニューバーと異なり)、次のように JRootPanecontentPane にオブジェクトを追加します。


       rootPane.getContentPane().add(child);
 
同様の原則が、レイアウトマネージャの設定、コンポーネントの削除、および子のリスト表示などでも適用されます。これらのメソッドはすべて JRootPane ではなく、contentPane で呼び出されます。
注: contentPane のデフォルトのレイアウトマネージャは BorderLayout マネージャです。ただし、JRootPane はカスタム LayoutManager を使用します。したがって、JRootPane に追加したコンポーネントのレイアウトマネージャを変更したいときは、必ず次のようなコードを使用してください。

    rootPane.getContentPane().setLayout(new BoxLayout());
 
JMenuBar コンポーネントが JRootPane で設定された場合は、フレームの上端に沿って配置されます。contentPane は、残りの領域に収まるように位置とサイズが調整されます (JMenuBarcontentPanelayeredPane コンポーネントの JLayeredPane.FRAME_CONTENT_LAYER レイヤに追加される)。

layeredPaneJRootPane のすべての子の親 (メニューの直接の親、および contentPane に追加されたすべてのコンポーネントの親の両方) です。layeredPane は、複数のレイヤでコンポーネントを追加する機能を提供する JLayeredPane のインスタンスです。この機能は、メニューポップアップやダイアログボックスでの作業およびドラッグなど、コンポーネントを区画内のほかのすべてのコンポーネントの一番上に配置する必要がある場合にとても便利です。

glassPaneJRootPane のほかのすべてのコンポーネントの一番上に置かれます。これにより、ほかのすべてのコンポーネントの上に描画するのに都合のよい場所が提供され、ドラッグや描画のときに便利なマウスイベントの捕捉が可能になります。glassPanesetVisible を使用すると、いつ glassPane がほかの子の上に表示されるかを制御できます。デフォルトでは、glassPane は可視ではありません。

JRootPane によって使用されるカスタム LayoutManager は次のことを保証します。

  1. glassPaneJRootPane (境界 - インセット) の表示可能領域全体を埋める
  2. layeredPaneJRootPane (境界 - インセット) の表示可能領域全体を埋める
  3. menuBarlayeredPane の上端に配置される
  4. contentPane は、menuBar を除いた (存在する場合) 表示可能領域全体を埋める
JRootPane のビュー階層にあるほかのビューはすべて無視されます。

JRootPaneLayoutManager を置換する場合は、これらのビューすべてを管理する必要があります。したがって、通常は JRootPane ではなく contentPane のレイアウトマネージャを変更するようにしてください。

Swing のペイント アーキテクチャでは、不透明な JComponent が他のすべてのコンポーネントの上にある包含関係の階層に含まれている必要があります。通常、これはコンテンツ区画によって提供されます。コンテンツ区画を置き換える場合は、setOpaque(true) によってコンテンツ区画を不透明にすることをお勧めします。また、コンテンツ区画によって paintComponent がオーバーライドされる場合は、バックグラウンドを paintComponent の不透明な色で完全に塗りつぶす必要があります。

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

関連項目:
JLayeredPane, JMenuBar, JWindow, JFrame, JDialog, JApplet, JInternalFrame, JComponent, BoxLayout, Mixing Heavy and Light Components

入れ子のクラスの概要
protected  class JRootPane.AccessibleJRootPane
          このクラスは JRootPane クラス用のユーザ補助機能のサポートを実装しています。
protected  class JRootPane.RootLayout
          layeredPane、glassPane、および menuBar のレイアウトを処理するカスタムレイアウトマネージャです。
 
クラス javax.swing.JComponent から継承された入れ子のクラス/インタフェース
JComponent.AccessibleJComponent
 
クラス java.awt.Container から継承された入れ子のクラス/インタフェース
Container.AccessibleAWTContainer
 
クラス java.awt.Component から継承された入れ子のクラス/インタフェース
Component.AccessibleAWTComponent, Component.BltBufferStrategy, Component.FlipBufferStrategy
 
フィールドの概要
static int COLOR_CHOOSER_DIALOG
          windowDecorationStyle プロパティに使用する定数です。
protected  Container contentPane
          コンテンツ区画です。
protected  JButton defaultButton
          区画がフォーカスと、Enter キーを押すなどの UI 固有のアクションを持ったときにアクティブになるボタンです。
protected  javax.swing.JRootPane.DefaultAction defaultPressAction
          推奨されていません。 Java 2 プラットフォーム 1.3 以降
protected  javax.swing.JRootPane.DefaultAction defaultReleaseAction
          推奨されていません。 Java 2 プラットフォーム 1.3 以降
static int ERROR_DIALOG
          windowDecorationStyle プロパティに使用する定数です。
static int FILE_CHOOSER_DIALOG
          windowDecorationStyle プロパティに使用する定数です。
static int FRAME
          windowDecorationStyle プロパティに使用する定数です。
protected  Component glassPane
          メニューバーとコンテンツ区画にオーバーレイするガラス区画です。
static int INFORMATION_DIALOG
          windowDecorationStyle プロパティに使用する定数です。
protected  JLayeredPane layeredPane
          メニューバーとコンテンツ区画を管理する階層化区画です。
protected  JMenuBar menuBar
          メニューバーです。
static int NONE
          windowDecorationStyle プロパティに使用する定数です。
static int PLAIN_DIALOG
          windowDecorationStyle プロパティに使用する定数です。
static int QUESTION_DIALOG
          windowDecorationStyle プロパティに使用する定数です。
static int WARNING_DIALOG
          windowDecorationStyle プロパティに使用する定数です。
 
クラス 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
 
コンストラクタの概要
JRootPane()
          JRootPane を作成し、glassPanelayeredPane、および contentPane を設定します。
 
メソッドの概要
protected  void addImpl(Component comp, Object constraints, int index)
          ガラスコンポーネントの位置が 0 の子に対して強制するためにオーバーライドされます。
 void addNotify()
          自身を新しいルート区画として SystemEventQueueUtils に登録します。
protected  Container createContentPane()
          デフォルトの contentPane を作成するためにコンストラクタのメソッドによって呼び出されます。
protected  Component createGlassPane()
          デフォルトの glassPane を作成するためにコンストラクタのメソッドによって呼び出されます。
protected  JLayeredPane createLayeredPane()
          デフォルトの layeredPane を作成するためにコンストラクタのメソッドによって呼び出されます。
protected  LayoutManager createRootLayout()
          コンストラクタメソッドによって呼び出され、デフォルトの layoutManager を作成します。
 AccessibleContext getAccessibleContext()
          この JRootPane に関連付けられた AccessibleContext を返します。
 Container getContentPane()
          ルート区画が親になるコンポーネントを保持するコンテナである、コンテンツ区画を返します。
 JButton getDefaultButton()
          defaultButton のプロパティの値を返します。
 Component getGlassPane()
          この JRootPane の現在のガラス区画を返します。
 JMenuBar getJMenuBar()
          階層化区画からメニューバーを返します。
 JLayeredPane getLayeredPane()
          ルート区画が使用する階層化区画を返します。
 JMenuBar getMenuBar()
          推奨されていません。 Swing バージョン 1.0.3 で getJMenuBar() に置き換えられました。
 RootPaneUI getUI()
          このコンポーネントを描画する L&F オブジェクトを返します。
 String getUIClassID()
          このコンポーネントを描画する L&F クラスの名前を文字列で返します。
 int getWindowDecorationStyle()
          JRootPane が提供する Window 装飾の種類を識別する定数を返します。
 boolean isOptimizedDrawingEnabled()
          glassPanecontentPane は同じ境界を持つため、JRootPane はその子をタイリングせず、false を返します。
 boolean isValidateRoot()
          この JRootPane の下位オブジェクトが revalidate を呼び出した場合、ここから下へ向かって検証を行います。
protected  String paramString()
          この JRootPane の文字列表現を返します。
 void removeNotify()
          自身を SystemEventQueueUtils から登録解除します。
 void setContentPane(Container content)
          ルート区画が親になるコンポーネントを保持するコンテナである、コンテンツ区画を設定します。
 void setDefaultButton(JButton defaultButton)
          defaultButton プロパティを設定して、この JRootPane の現在のデフォルトボタンを指定します。
 void setGlassPane(Component glass)
          指定した Component がこのルート区画のガラス区画になるように設定します。
 void setJMenuBar(JMenuBar menu)
          階層化区画で使用されるメニューバーを追加または変更します。
 void setLayeredPane(JLayeredPane layered)
          ルート区画に階層化区画を設定します。
 void setMenuBar(JMenuBar menu)
          推奨されていません。 Swing バージョン 1.0.3 で setJMenuBar(JMenuBar menu) に置き換えられました。
 void setUI(RootPaneUI ui)
          このコンポーネントを描画する L&F オブジェクトを設定します。
 void setWindowDecorationStyle(int windowDecorationStyle)
          JRootPane が提供する装飾の種類 (ボーダ、Window を閉じるためのウィジェット、タイトルなど) を設定します。
 void updateUI()
          現在の Look & Feel からの値に UI プロパティをリセットします。
 
クラス javax.swing.JComponent から継承されたメソッド
addAncestorListener, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, 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, isPaintingTile, isRequestFocusEnabled, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, 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, remove, removeAll, removeContainerListener, setComponentZOrder, 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
 

フィールドの詳細

NONE

public static final int NONE
windowDecorationStyle プロパティに使用する定数です。JRootPane がどんな Window 装飾も提供しないように指示します。

導入されたバージョン:
1.4
関連項目:
定数フィールド値

FRAME

public static final int FRAME
windowDecorationStyle プロパティに使用する定数です。JRootPane が Frame に適した装飾を提供するように指示します。

導入されたバージョン:
1.4
関連項目:
定数フィールド値

PLAIN_DIALOG

public static final int PLAIN_DIALOG
windowDecorationStyle プロパティに使用する定数です。JRootPane が Dialog に適した装飾を提供するように指示します。

導入されたバージョン:
1.4
関連項目:
定数フィールド値

INFORMATION_DIALOG

public static final int INFORMATION_DIALOG
windowDecorationStyle プロパティに使用する定数です。JRootPane が、情報メッセージを表示するための Dialog に適した装飾を提供するように指示します。

導入されたバージョン:
1.4
関連項目:
定数フィールド値

ERROR_DIALOG

public static final int ERROR_DIALOG
windowDecorationStyle プロパティに使用する定数です。JRootPane が、エラーメッセージを表示するための Dialog に適した装飾を提供するように指示します。

導入されたバージョン:
1.4
関連項目:
定数フィールド値

COLOR_CHOOSER_DIALOG

public static final int COLOR_CHOOSER_DIALOG
windowDecorationStyle プロパティに使用する定数です。JRootPane が、JColorChooser を表示するための Dialog に適した装飾を提供するように指示します。

導入されたバージョン:
1.4
関連項目:
定数フィールド値

FILE_CHOOSER_DIALOG

public static final int FILE_CHOOSER_DIALOG
windowDecorationStyle プロパティに使用する定数です。JRootPane が、JFileChooser を表示するための Dialog に適した装飾を提供するように指示します。

導入されたバージョン:
1.4
関連項目:
定数フィールド値

QUESTION_DIALOG

public static final int QUESTION_DIALOG
windowDecorationStyle プロパティに使用する定数です。JRootPane が、ユーザにクエスチョンを表示するための Dialog に適した装飾を提供するように指示します。

導入されたバージョン:
1.4
関連項目:
定数フィールド値

WARNING_DIALOG

public static final int WARNING_DIALOG
windowDecorationStyle プロパティに使用する定数です。JRootPane が、警告メッセージを表示するための Dialog に適切な装飾を提供するように指示します。

導入されたバージョン:
1.4
関連項目:
定数フィールド値

menuBar

protected JMenuBar menuBar
メニューバーです。


contentPane

protected Container contentPane
コンテンツ区画です。


layeredPane

protected JLayeredPane layeredPane
メニューバーとコンテンツ区画を管理する階層化区画です。


glassPane

protected Component glassPane
メニューバーとコンテンツ区画にオーバーレイするガラス区画です。マウスの動作などを捕捉できます。


defaultButton

protected JButton defaultButton
区画がフォーカスと、Enter キーを押すなどの UI 固有のアクションを持ったときにアクティブになるボタンです。


defaultPressAction

@Deprecated
protected javax.swing.JRootPane.DefaultAction defaultPressAction
推奨されていません。 Java 2 プラットフォーム 1.3 以降
Java 2 プラットフォーム 1.3 以降、この使用不可フィールドは使用されていません。デフォルトのボタンをオーバーライドするには、JRootPaneActionMapAction を置き換えます。詳細は、キーバインディングの仕様を参照してください。

関連項目:
defaultButton

defaultReleaseAction

@Deprecated
protected javax.swing.JRootPane.DefaultAction defaultReleaseAction
推奨されていません。 Java 2 プラットフォーム 1.3 以降
Java 2 プラットフォーム 1.3 以降、この使用不可フィールドは使用されていません。デフォルトのボタンをオーバーライドするには、JRootPaneActionMapAction を置き換えます。詳細は、キーバインディングの仕様を参照してください。

関連項目:
defaultButton
コンストラクタの詳細

JRootPane

public JRootPane()
JRootPane を作成し、glassPanelayeredPane、および contentPane を設定します。

メソッドの詳細

getWindowDecorationStyle

public int getWindowDecorationStyle()
JRootPane が提供する Window 装飾の種類を識別する定数を返します。

戻り値:
NONEFRAMEPLAIN_DIALOGINFORMATION_DIALOGERROR_DIALOGCOLOR_CHOOSER_DIALOGFILE_CHOOSER_DIALOGQUESTION_DIALOG、または WARNING_DIALOG のどれか
導入されたバージョン:
1.4
関連項目:
setWindowDecorationStyle(int)

setWindowDecorationStyle

public void setWindowDecorationStyle(int windowDecorationStyle)
JRootPane が提供する装飾の種類 (ボーダ、Window を閉じるためのウィジェット、タイトルなど) を設定します。デフォルトの設定は Window 装飾なし (NONE) です。

これはヒントに過ぎず、一部の Look & Feel はこれをサポートしていません。これはバウンドプロパティです。

パラメータ:
windowDecorationStyle - 提供する Window 装飾を識別する定数
例外:
IllegalArgumentException - styleNONEFRAMEPLAIN_DIALOGINFORMATION_DIALOGERROR_DIALOGCOLOR_CHOOSER_DIALOGFILE_CHOOSER_DIALOGQUESTION_DIALOG、または WARNING_DIALOG のどれでもない場合
導入されたバージョン:
1.4
関連項目:
JDialog.setDefaultLookAndFeelDecorated(boolean), JFrame.setDefaultLookAndFeelDecorated(boolean), LookAndFeel.getSupportsWindowDecorations()

getUI

public RootPaneUI getUI()
このコンポーネントを描画する L&F オブジェクトを返します。

戻り値:
LabelUI オブジェクト
導入されたバージョン:
1.3

setUI

public void setUI(RootPaneUI ui)
このコンポーネントを描画する L&F オブジェクトを設定します。

パラメータ:
ui - LabelUI L&F オブジェクト
導入されたバージョン:
1.3
関連項目:
UIDefaults.getUI(javax.swing.JComponent)

updateUI

public void updateUI()
現在の Look & Feel からの値に UI プロパティをリセットします。

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

getUIClassID

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

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

createLayeredPane

protected JLayeredPane createLayeredPane()
デフォルトの layeredPane を作成するためにコンストラクタのメソッドによって呼び出されます。デフォルトでは、新しい JLayeredPane を作成します。

戻り値:
デフォルトの layeredPane

createContentPane

protected Container createContentPane()
デフォルトの contentPane を作成するためにコンストラクタのメソッドによって呼び出されます。デフォルトでは、このメソッドは新しい JComponent を作成し、LayoutManager として BorderLayout を設定します。

戻り値:
デフォルトの contentPane

createGlassPane

protected Component createGlassPane()
デフォルトの glassPane を作成するためにコンストラクタのメソッドによって呼び出されます。デフォルトでは、このメソッドは可視性を false に設定して新しい JComponent を作成します。

戻り値:
デフォルトの glassPane

createRootLayout

protected LayoutManager createRootLayout()
コンストラクタメソッドによって呼び出され、デフォルトの layoutManager を作成します。

戻り値:
デフォルトの LayoutManager

setJMenuBar

public void setJMenuBar(JMenuBar menu)
階層化区画で使用されるメニューバーを追加または変更します。

パラメータ:
menu - 追加する JMenuBar

setMenuBar

@Deprecated
public void setMenuBar(JMenuBar menu)
推奨されていません。 Swing バージョン 1.0.3 で setJMenuBar(JMenuBar menu) に置き換えられました。

メニューバーの値を指定します。

パラメータ:
menu - 追加する JMenuBar

getJMenuBar

public JMenuBar getJMenuBar()
階層化区画からメニューバーを返します。

戻り値:
区画で使用される JMenuBar

getMenuBar

@Deprecated
public JMenuBar getMenuBar()
推奨されていません。 Swing バージョン 1.0.3 で getJMenuBar() に置き換えられました。

メニューバーの値を返します。

戻り値:
区画で使用される JMenuBar

setContentPane

public void setContentPane(Container content)
ルート区画が親になるコンポーネントを保持するコンテナである、コンテンツ区画を設定します。

Swing のペイント アーキテクチャでは、包含関係の階層に不透明な JComponent が含まれている必要があります。通常、これはコンテンツ区画よって提供されます。コンテンツ区画を置き換える場合は、不透明な JComponent と置き換えることをお勧めします。

パラメータ:
content - コンポーネントコンテンツに使用する Container
例外:
IllegalComponentStateException - コンテンツ区画パラメータが null の場合 (実行時例外)

getContentPane

public Container getContentPane()
ルート区画が親になるコンポーネントを保持するコンテナである、コンテンツ区画を返します。

戻り値:
コンポーネントコンテンツを保持する Container

setLayeredPane

public void setLayeredPane(JLayeredPane layered)
ルート区画に階層化区画を設定します。通常、階層化区画はコンテンツ区画とオプションの JMenuBar を保持します。

パラメータ:
layered - 使用する JLayeredPane
例外:
IllegalComponentStateException - 階層化区画パラメータが null の場合 (実行時例外)

getLayeredPane

public JLayeredPane getLayeredPane()
ルート区画が使用する階層化区画を返します。通常、階層化区画はコンテンツ区画とオプションの JMenuBar を保持します。

戻り値:
現在使用している JLayeredPane

setGlassPane

public void setGlassPane(Component glass)
指定した Component がこのルート区画のガラス区画になるように設定します。ルート区画が入力イベントを捕捉する必要があるときには必ず可視にされるので、通常、ガラス区画は軽量の透明なコンポーネントである必要があります。たとえば、DefaultDesktop を使用しているときは、1 つの JInternalFrame だけがアクティブになり、非アクティブな JInternalFrame のガラス区画は、非アクティブな JInternalFrame をクリックしてアクティブにできるように可視にされます。

パラメータ:
glass - この JRootPane のガラス区画として使用する Component
例外:
NullPointerException - glass パラメータが null の場合

getGlassPane

public Component getGlassPane()
この JRootPane の現在のガラス区画を返します。

戻り値:
現在のガラス区画
関連項目:
setGlassPane(java.awt.Component)

isValidateRoot

public boolean isValidateRoot()
この JRootPane の下位オブジェクトが revalidate を呼び出した場合、ここから下へ向かって検証を行います。

コンポーネントおよびその子孫の再配置が延期された要求です。たとえば、revalidate の呼び出しは、JRootPane または JScrollPane のどちらかに転送されます。これはどちらのクラスも isValidateRoot をオーバーライドして true を返すためです。

オーバーライド:
クラス JComponent 内の isValidateRoot
戻り値:
true
関連項目:
JComponent.isValidateRoot()

isOptimizedDrawingEnabled

public boolean isOptimizedDrawingEnabled()
glassPanecontentPane は同じ境界を持つため、JRootPane はその子をタイリングせず、false を返します。一方、通常 glassPane は不可視なので、glassPane が可視でない場合、true を返します。つまり、このメソッドの戻り値は glassPane の可視性によって異なります。

オーバーライド:
クラス JComponent 内の isOptimizedDrawingEnabled
戻り値:
このコンポーネントの子がオーバーラップしない場合は true

addNotify

public void addNotify()
自身を新しいルート区画として SystemEventQueueUtils に登録します。

オーバーライド:
クラス JComponent 内の addNotify
関連項目:
JComponent.registerKeyboardAction(java.awt.event.ActionListener, java.lang.String, javax.swing.KeyStroke, int)

removeNotify

public void removeNotify()
自身を SystemEventQueueUtils から登録解除します。

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

setDefaultButton

public void setDefaultButton(JButton defaultButton)
defaultButton プロパティを設定して、この JRootPane の現在のデフォルトボタンを指定します。デフォルトボタンは、ボタンにキーボードフォーカスがあるかどうかにかかわらず、ルート区画で UI 定義の起動イベント (通常は Enter キー) が発生したときに起動されるボタンです (ルート区画内に JTextPane などの起動イベントを消費する別のコンポーネントがある場合を除く)。デフォルトの起動が機能するには、ボタンは起動が発生した時点でルート区画の使用可能な子孫である必要があります。このルート区画からデフォルトボタンを削除するには、このプロパティを null に設定します。

パラメータ:
defaultButton - デフォルトボタンになる JButton
関連項目:
JButton.isDefaultButton()

getDefaultButton

public JButton getDefaultButton()
defaultButton のプロパティの値を返します。

戻り値:
現在デフォルトボタンである JButton
関連項目:
setDefaultButton(javax.swing.JButton)

addImpl

protected void addImpl(Component comp,
                       Object constraints,
                       int index)
ガラスコンポーネントの位置が 0 の子に対して強制するためにオーバーライドされます。

オーバーライド:
クラス Container 内の addImpl
パラメータ:
comp - 拡張されるコンポーネント
constraints - 遵守されるべき制約
index - インデックス
関連項目:
Container.add(Component), Container.add(Component, int), Container.add(Component, java.lang.Object), LayoutManager, LayoutManager2

paramString

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

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

getAccessibleContext

public AccessibleContext getAccessibleContext()
この JRootPane に関連付けられた AccessibleContext を返します。ルート区画の場合、AccessibleContextAccessibleJRootPane の形式を取ります。必要な場合は、新しい AccessibleJRootPane インスタンスが作成されます。

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

JavaTM 2 Platform
Standard Ed. 5.0

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

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