Java 2 Platform SE 1.3: インタフェース RootPaneContainer

概要

パッケージ

クラス

使用

階層ツリー

非推奨 API

索引

ヘルプ

Java^TM 2 Platform
Std. Ed. v1.3

前のクラス 次のクラス

フレームあり フレームなし

概要: 内部クラス | フィールド | コンストラクタ | メソッド

詳細: フィールド | コンストラクタ | メソッド

javax.swing
インタフェース RootPaneContainer

既知の実装クラスの一覧:: JApplet, JFrame, JInternalFrame, JWindow, JDialog

public interface RootPaneContainer

このインタフェースは、JRootPane の子を 1 つ持つ JDialog、JFrame、JWindow、JApplet、JInternalFrame などのコンポーネントによって実装されます。このインタフェースのメソッドは、JRootPane プロパティの「代わり」をするだけです。たとえば、getContentPane() は通常は次のように実装されます。

     public Container getContentPane() {
         return getRootPane().getContentPane();
     }

このインタフェースは、単一の JRootPane を持つ JFrame などのコンポーネントを特別に処理する Swing GUI ビルダの「マーカ」として機能します。たとえば GUI ビルダでは、RootPaneContainer にコンポーネントをドロップすると、frame.getContentPane().add(child) として解釈されます。

関連項目:: JRootPane, JFrame, JDialog, JWindow, JApplet, JInternalFrame

メソッドの概要

Container getContentPane()
          contentPane を返します。

Component getGlassPane()
          glassPane を返します。

JLayeredPane getLayeredPane()
          layeredPane を返します。

JRootPane getRootPane()
          このコンポーネントの単一の JRootPane の子を返します。

void setContentPane(Container contentPane)
          「contentPane」は、アプリケーション固有のコンポーネントの一次コンテナです。

void setGlassPane(Component glassPane)
          glassPane は常に rootPane の最初の子で、rootPane のレイアウトマネージャによって、常に rootPane と同じ大きさであることが保証されます。

void setLayeredPane(JLayeredPane layeredPane)
          contentPane を管理するコンテナで、場合によってはメニューバーも管理します。

メソッドの詳細

getRootPane

public JRootPane getRootPane()

このコンポーネントの単一の JRootPane の子を返します。このインタフェースの通常の実装では、ほかのメソッドはすべてインタフェース全体で間接的になります。rootPane には、glassPane と layeredPane の 2 つの子があります。

戻り値:: このコンポーネントの単一の JRootPane の子
関連項目:: JRootPane

setContentPane

public void setContentPane(Container contentPane)

「contentPane」は、アプリケーション固有のコンポーネントの一次コンテナです。アプリケーションでは、contentPane に子を追加したり、そのレイアウトマネージャを設定したりします。

contentPane を null にすることはできません。

通常は、次のように実装されます。 getRootPane().setContentPane(contentPane);

パラメータ:: contentPane - この JRootPane のコンテンツのコンテナ
例外:: IllegalComponentStateException - (実行時例外) コンテンツ区画パラメータが null の場合
関連項目:: JRootPane.getContentPane(), getContentPane()

getContentPane

public Container getContentPane()

contentPane を返します。

戻り値:: contentPane プロパティの値
関連項目:: setContentPane(java.awt.Container)

setLayeredPane

public void setLayeredPane(JLayeredPane layeredPane)

contentPane を管理するコンテナで、場合によってはメニューバーも管理します。layeredPane を利用できるのは、管理しているレイアウトではない RootPaneContainer に子を追加する下位オブジェクトです。たとえば、内部ダイアログやドラッグ＆ドロップ効果を持つコンポーネントなどです。

layeredPane を null にすることはできません。

通常は、次のように実装されます。

getRootPane().setLayeredPane(layeredPane);

例外:: IllegalComponentStateException - (実行時例外) 階層化区画パラメータが null の場合
関連項目:: getLayeredPane(), JRootPane.getLayeredPane()

getLayeredPane

public JLayeredPane getLayeredPane()

layeredPane を返します。

戻り値:: layeredPane プロパティの値
関連項目:: setLayeredPane(javax.swing.JLayeredPane)

setGlassPane

public void setGlassPane(Component glassPane)

glassPane は常に rootPane の最初の子で、rootPane のレイアウトマネージャによって、常に rootPane と同じ大きさであることが保証されます。また、デフォルトでは透過で、可視ではありません。glassPane を使用すると、リスナーを追加して glassPane を可視に設定することで、すべてのキーボードおよびマウス入力を一時的にグラブできます。デフォルトでは、glassPane は可視ではありません。

glassPane を null に設定することはできません。

通常は、次のように実装されます。 getRootPane().setGlassPane(glassPane);

関連項目:: getGlassPane(), JRootPane.setGlassPane(java.awt.Component)

getGlassPane

public Component getGlassPane()

glassPane を返します。

戻り値:: glassPane プロパティの値
関連項目:: setGlassPane(java.awt.Component)

概要