JDesktopPaneクラスとJInternalFrameクラス

Information

Swingの基本

Layout Mng.

イベント処理

色々なペイン

高度なコンポーネント

その他の機能

関連クラスの利用方法

サンプルアプリケーション

関連ページ

Our Host


JDesktopPaneクラスと JInternalFrameクラス	H.Kamifuji .

はじめに

　SwingアプリケーションでMDI(マルチドキュメントインターフェース)型のアプリケーションを作成する場合にJDesktopPaneクラスとJInternalFrameクラスを使います。MDIアプリケーションとは例えばExcelのように1つのウィンドウの中に子ウィンドウが複数存在しているようなアプリケーションです。
　
　JInternalFrameクラスが子ウィンドウを作成するためのクラスであり、JDesktopPaneクラスは内部に子ウィンドウを表示する仮想デスクトップを作成するためのペインとなっています。
　
　ここではJDesktopPaneクラスとJInternalFrameクラスの基本的な使用方法を確認していきます。
　
　当ページでは、Linux CentOS7 の Gnome で動作テストしています。

　現在(2021/08)では、JDK-16.0.2 にアップされています。一部、上位互換について、見直しを行っていきます。

　現在(2021/11)では、JDK-17.0.1 にアップされています。一部、上位互換について、見直しを行っていきます。

　現在(2023/04)では、JDK-20.0.1 にアップされています。一部、上位互換について、見直しを行っていきます。

　現在(2024/10)では、JDK-23 にアップされています。一部、上位互換について、見直しを行っていきます。

目　次

JDesktopPaneクラスの定義とコンストラクタ

JInternalFrameクラスの定義とコンストラクタ

デスクトップペインにインターナルフレームを追加する

インターナルフレームの位置とサイズを設定する

インターナルフレームのタイトルを設定する

インターナルフレームがサイズ変更の可否を設定する

最大化、アイコン化、クローズボタンの設置を設定する

インターナルフレームのレイヤーの値を取得する

インターナルフレームのレイヤーの値を設定する

インターナルフレームを選択する

インターナルフレームにコンポーネントを追加する

インターナルフレームにメニューバーを配置する

ウィンドウアイコンを設定する

リリースノート

関連ページ

JDesktopPaneクラスの定義とコンストラクタ

　
　JDesktopPaneクラスの定義を確認します。クラス図は次のようになっています。

java.lang.Object Ｌ java.awt.Component Ｌ java.awt.Container Ｌ javax.swing.JComponent Ｌ javax.swing.JLayeredPane Ｌ javax.swing.JDesktopPane public class JDesktopPane extends JLayeredPane implements Accessible
　JDesktopPaneクラスはJComponentクラスのサブクラスとなっています。JComponentクラスはSwingで用いられる多くのコンポーネントのベースとなっているクラスです。JDesktopPaneクラスのオブジェクトを作成してフレームなどに追加することでフレーム上で仮想デスクトップ環境を作ることが出来ます。
　

JDesktopPaneクラスのコンストラクタ
　JDesktopPaneクラスをを利用するにはコンストラクタを使ってJDesktopPaneクラスのオブジェクトを作成します。どのようなコンストラクタが用意されているか確認してみます。
　

コンストラクタ

JDesktopPane()
新しい JDesktopPane を生成します。

　
　コンストラクタは1つだけ用意されています。ではコンストラクタを確認してみます。
　

JDesktopPane public JDesktopPane()
　新しい JDesktopPane を生成します。

　
　実際の使い方は次のようになります。

JDesktopPane desktop = new JDesktopPane();
　では簡単なサンプルを作成して試してみます。
　

サンプルプログラム
　下記のサンプルを実行してみよう。

/** * JDesktopPaneクラスの定義とコンストラクタ */ import javax.swing.*; import java.awt.BorderLayout; public class JDesktopPaneTest1 extends JFrame{ public static void main(String[] args){ JDesktopPaneTest1 frame = new JDesktopPaneTest1(); frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); frame.setBounds(10, 10, 300, 200); frame.setTitle("タイトル"); frame.setVisible(true); } JDesktopPaneTest1(){ JDesktopPane desktop = new JDesktopPane(); getContentPane().add(desktop, BorderLayout.CENTER); } }
　上記をコンパイルした後で実行すると次のように表示されます。
　

　
　デスクトップペインを追加しただけでは見た目上はあまり変わりがありません。

[ 目次 ]

JInternalFrameクラスの定義とコンストラクタ

　
　JInternalFrameクラスの定義を確認します。クラス図は次のようになっています。

java.lang.Object Ｌ java.awt.Component Ｌ java.awt.Container Ｌ javax.swing.JComponent Ｌ javax.swing.JInternalFrame public class JInternalFrame extends JComponent implements Accessible, WindowConstants, RootPaneContainer
　JInternalFrameクラスはJComponentクラスのサブクラスとなっています。JComponentクラスはSwingで用いられる多くのコンポーネントのベースとなっているクラスです。
　
　JInternalFrameクラスはデスクトップペインの中に追加される子ウィンドウを生成するために使われます。
　

JInternalFrameクラスのコンストラクタ
　JInternalFrameクラスをを利用するにはコンストラクタを使ってJInternalFrameクラスのオブジェクトを作成します。どのようなコンストラクタが用意されているか確認してみます。
　

コンストラクタ

JInternalFrame()
サイズ変更、クローズ、最大化、アイコン化を行うことができない JInternalFrame を、タイトルなしで作成します。

JInternalFrame(String title)
サイズ変更、クローズ、最大化、アイコン化を行うことができない JInternalFrame を、指定されたタイトルで作成します。

JInternalFrame(String title, boolean resizable)
クローズ、最大化、アイコン化を行うことができない JInternalFrame を、タイトルと、サイズ変更可能性を指定して作成します。

JInternalFrame(String title, boolean resizable, boolean closable)
最大化、アイコン化を行うことができない JInternalFrame を、タイトル、サイズ変更可能性、およびクローズ可能性を指定して作成します。

JInternalFrame(String title, boolean resizable, boolean closable, boolean maximizable)
アイコン化を行うことができない JInternalFrame を、タイトル、サイズ変更可能性、クローズ可能性、および最大化可能性を指定して作成します。

JInternalFrame(String title, boolean resizable, boolean closable, boolean maximizable, boolean iconifiable)
タイトル、サイズの変更可能性、クローズ可能性、最大化可能性、およびアイコン化の可能性を指定して、JInternalFrame を作成します。

　
　コンストラクタは6つ用意されています。JInternalFrameクラスから子ウィンドウとして表示されるフレームを作成します。フレームにはそれぞれタイトルや最大化、アイコン化、クローズのボタンの設置が行うことができ、どのようなフレームにするかによってコンストラクタを使い分けます。
　
　では1つ目のコンストラクタを確認してみます。
　

JInternalFrame public JInternalFrame()
　サイズ変更、クローズ、最大化、アイコン化を行うことができない JInternalFrameを、タイトルなしで作成します。

　
　このコンストラクタで作成されるインターナルフレームはタイトルが設定されず、最大化、アイコン、クローズのボタンも設置されません。
　
　実際の使い方は次のようになります。

JInternalFrame iframe = new JInternalFrame();
　

インターナルフレームを表示する
　JInternalFrameクラスのオブジェクトを作成した段階では、インターナルフレームは非表示となっています。表示するためにはJInternalFrameクラスの親クラスであるJComponentクラスで用意されている「」メソッドを使います。
　

setVisible public void setVisible(boolean aFlag)
　コンポーネントを可視または不可視にします。Component.setVisible をオーバーライドします。
　
　パラメータ:
　　　aFlag - コンポーネントを可視にする場合は true、不可視にする場合は false

　
　引数には表示するかどうかを表すboolean型の値を設定します。「true」の場合は表示、「false」の場合は非表示となります。
　
　実際の使い方は次のようになります。

JInternalFrame iframe = new JInternalFrame(); iframe.setVisible(true);
　では簡単なサンプルを作成して試してみます。
　

サンプルプログラム
　下記のサンプルを実行してみよう。

/** * JInternalFrameクラスの定義とコンストラクタ */ import javax.swing.*; import java.awt.BorderLayout; public class JDesktopPaneTest2 extends JFrame{ public static void main(String[] args){ JDesktopPaneTest2 frame = new JDesktopPaneTest2(); frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); frame.setBounds(10, 10, 300, 200); frame.setTitle("タイトル"); frame.setVisible(true); } JDesktopPaneTest2(){ JDesktopPane desktop = new JDesktopPane(); JInternalFrame iframe = new JInternalFrame(); iframe.setSize(150, 100); iframe.setLocation(10, 10); iframe.setVisible(true); desktop.add(iframe); getContentPane().add(desktop, BorderLayout.CENTER); } }
　上記をコンパイルした後で実行すると次のように表示されます。
　

　
　インターナルフレームのサイズや位置、そしてデスクトップに追加する方法は次のページ以降で確認していきます。

[ 目次 ]

デスクトップペインにインターナルフレームを追加する

　
　デスクトップペインにインターナルフレームを追加する方法を確認します。JDesktopPaneクラスの親クラスであるContainerクラスで用意されている「add」メソッドを使います。
　

add public Component add(Component comp)
　指定されたコンポーネントをこのコンテナの最後に追加します。これは addImpl(java.awt.Component, java.lang.Object, int) の簡易メソッドです。
　
　パラメータ:
　　　comp - 追加されるコンポーネント
　戻り値:
　　　コンポーネント引数
　例外:
　　　NullPointerException - comp が null の場合

　
　引数に追加したいJInternalFrameクラスのオブジェクトを指定します。
　
　実際の使い方は次のようになります。

JDesktopPane desktop = new JDesktopPane(); JInternalFrame iframe = new JInternalFrame(); iframe.setSize(150, 100); iframe.setLocation(10, 10); iframe.setVisible(true); desktop.add(iframe);
　では簡単なサンプルを作成して試してみます。
　

サンプルプログラム
　下記のサンプルを実行してみよう。

/** * デスクトップペインにインターナルフレームを追加する */ import javax.swing.*; import java.awt.BorderLayout; public class JDesktopPaneTest3 extends JFrame{ public static void main(String[] args){ JDesktopPaneTest3 frame = new JDesktopPaneTest3(); frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); frame.setBounds(10, 10, 300, 200); frame.setTitle("タイトル"); frame.setVisible(true); } JDesktopPaneTest3(){ JDesktopPane desktop = new JDesktopPane(); JInternalFrame iframe1 = new JInternalFrame(); iframe1.setSize(150, 100); iframe1.setLocation(10, 10); iframe1.setVisible(true); JInternalFrame iframe2 = new JInternalFrame(); iframe2.setSize(150, 100); iframe2.setLocation(30, 30); iframe2.setVisible(true); desktop.add(iframe1); desktop.add(iframe2); getContentPane().add(desktop, BorderLayout.CENTER); } }
　上記をコンパイルした後で実行すると次のように表示されます。
　

　
　インターナルフレームのサイズや位置、そしてデスクトップに追加する方法は次項のページ以降で確認していきます。

[ 目次 ]

インターナルフレームの位置とサイズを設定する

　
　JInternalFrameクラスのオブジェクトを作成した時点ではインターナルフレームはサイズが0となっています。その為、適切なサイズを設定する必要があります。インターナルフレームのサイズを設定するにはJInternalFrameクラスの親クラスであるComponentクラスで用意されている「setSize」メソッドを使います。
　

setSize public void setSize(int width, int height)
　このコンポーネントのサイズを width および height に変更します。
　
　パラメータ:
　　　width - このコンポーネントの新しい幅 (ピクセル単位)
　　　height - このコンポーネントの新しい高さ (ピクセル単位)

　
　1番目の引数にインターナルフレームの幅を、2番目の引数にインターナルフレームの高さを表すint型の値を指定します。単位はピクセルです。
　
　実際の使い方は次のようになります。

JDesktopPane desktop = new JDesktopPane(); JInternalFrame iframe = new JInternalFrame(); iframe.setSize(150, 100);
　

インターナルフレームの位置を指定する
　インターナルフレームをデスクトップペインの中のどの位置に配置するのかを指定します。デスクトップペインの左上座標を原点として右方向にx軸、下方向にy軸を取った場合の座標を指定します。配置位置を設定するにはJInternalFrameクラスの親クラスであるComponentクラスで用意されている「setLocation」メソッドを使います。
　

setLocation public void setLocation(int x, int y)
　このコンポーネントを新しい位置に移動します。新しい位置の左上隅は、このコンポーネントの親の座標空間の x パラメータおよび y パラメータによって指定されます。
　
　パラメータ:
　　　x - 親の座標空間での新しい位置の左上隅の x 座標
　　　y - 親の座標空間での新しい位置の左上隅の y 座標

　
　1番目の引数にインターナルフレームのx座標を、2番目の引数にインターナルフレームのy座標を表すint型の値を指定します。単位はピクセルです。
　
　実際の使い方は次のようになります。

JDesktopPane desktop = new JDesktopPane(); JInternalFrame iframe = new JInternalFrame(); iframe.setSize(150, 100); iframe.setLocation(10, 10);
　

インターナルフレームのサイズと位置をまとめて指定する
　インターナルフレームのサイズと位置をまとめて指定する方法を確認します。JInternalFrameクラスの親クラスであるComponentクラスで用意されている「setBounds」メソッドを使います。
　

setBounds public void setBounds(int x, int y, int width, int height)
　このコンポーネントを移動し、サイズ変更します。左上隅の新しい位置は x および y によって指定され、新しいサイズは width および height によって指定されます。
　
　パラメータ:
　　　x - このコンポーネントの新しい x 座標
　　　y - このコンポーネントの新しい y 座標
　　　width - このコンポーネントの新しい width
　　　height - このコンポーネントの新しい height

　
　1番目の引数にインターナルフレームのx座標を、2番目の引数にインターナルフレームのy座標を表すint型の値を指定します。3番目の引数にインターナルフレームの幅を、4番目の引数にインターナルフレームの高さを表すint型の値を指定します。単位はピクセルです。
　
　実際の使い方は次のようになります。

JDesktopPane desktop = new JDesktopPane(); JInternalFrame iframe = new JInternalFrame(); iframe.setBounds(10, 10, 150, 100);
　setSizeとsetLocationを使って別々に指定しても構いませんし、setBoundsを使ってまとめて指定してもどちらでも構いません。
　
　では簡単なサンプルを作成して試してみます。
　

サンプルプログラム
　下記のサンプルを実行してみよう。

/** * インターナルフレームの位置とサイズを設定する */ import javax.swing.*; import java.awt.BorderLayout; public class JDesktopPaneTest4 extends JFrame{ public static void main(String[] args){ JDesktopPaneTest4 frame = new JDesktopPaneTest4(); frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); frame.setBounds(10, 10, 300, 200); frame.setTitle("タイトル"); frame.setVisible(true); } JDesktopPaneTest4(){ JDesktopPane desktop = new JDesktopPane(); JInternalFrame iframe1 = new JInternalFrame(); iframe1.setBounds(10, 10, 150, 100); iframe1.setVisible(true); JInternalFrame iframe2 = new JInternalFrame(); iframe2.setSize(250, 120); iframe2.setLocation(30, 30); iframe2.setVisible(true); desktop.add(iframe1); desktop.add(iframe2); getContentPane().add(desktop, BorderLayout.CENTER); } }
　上記をコンパイルした後で実行すると次のように表示されます。
　

[ 目次 ]

インターナルフレームのタイトルを設定する

　
　インターナルフレームのタイトルを設定する方法を確認します。タイトルを設定するにはコンストラクタで指定する方法とメソッドで指定する方法があります。まずはコンストラクタで設定する方法を確認します。
　

JInternalFrame public JInternalFrame(String title)
　サイズ変更、クローズ、最大化、アイコン化を行うことができない JInternalFrame を、指定されたタイトルで作成します。title を null で渡すと動作は保証されず、例外となる場合があります。
　
　パラメータ:
　　　title - タイトルバーに表示する null 以外の String

　
　引数にインターナルフレームのタイトルに表示される文字列をString型の値で指定します。
　
　実際の使い方は次のようになります。

JInternalFrame iframe = new JInternalFrame("title");
　

メソッドで指定する
　作成されたJInternalFramクラスのオブジェクトに対してメソッドを使ってタイトルを設定することも可能です。タイトルを設定するにはJInternalFrameクラスで用意されている「setTitle」メソッドを使います。
　

setTitle public void setTitle(String title)
　JInternalFrame タイトルを設定します。title には null 値が付くことがあります。
　
　パラメータ:
　　　title - タイトルバーに表示する String

　
　引数にインターナルフレームのタイトルに表示される文字列をString型の値で指定します。
　
　実際の使い方は次のようになります。

JInternalFrame iframe = new JInternalFrame(); iframe.setTitle("title");
　では簡単なサンプルを作成して試してみます。
　

サンプルプログラム
　下記のサンプルを実行してみよう。

/** * インターナルフレームのタイトルを設定する */ import javax.swing.*; import java.awt.BorderLayout; public class JDesktopPaneTest5 extends JFrame{ public static void main(String[] args){ JDesktopPaneTest5 frame = new JDesktopPaneTest5(); frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); frame.setBounds(10, 10, 300, 200); frame.setTitle("タイトル"); frame.setVisible(true); } JDesktopPaneTest5(){ JDesktopPane desktop = new JDesktopPane(); JInternalFrame iframe1 = new JInternalFrame("IFrame1"); iframe1.setSize(250, 120); iframe1.setLocation(10, 10); iframe1.setVisible(true); JInternalFrame iframe2 = new JInternalFrame(); iframe2.setSize(250, 120); iframe2.setLocation(30, 30); iframe2.setTitle("IFrame2"); iframe2.setVisible(true); desktop.add(iframe1); desktop.add(iframe2); getContentPane().add(desktop, BorderLayout.CENTER); } }
　上記をコンパイルした後で実行すると次のように表示されます。
　

　
　2番目のフレームが隠れているのでマウスでクリックして前面に出しと2番目のフレームにもタイトルが設定されていることが確認出来ます。
　

[ 目次 ]

インターナルフレームがサイズ変更の可否を設定する

　
　インターナルフレームのサイズが変更を許可するかどうかを設定する方法を確認します。サイズ変更の可否を設定するにはコンストラクタで指定する方法とメソッドで指定する方法があります。まずはコンストラクタで設定する方法を確認します。
　

JInternalFrame public JInternalFrame(String title, boolean resizable)
　クローズ、最大化、アイコン化を行うことができない JInternalFrame を、タイトルと、サイズ変更可能性を指定して作成します。
　
　パラメータ:
　　　title - タイトルバーに表示する String
　　　resizable - true の場合、内部フレームはサイズ変更できる

　
　1番目の引数にインターナルフレームのタイトルに表示される文字列をString型の値で指定します。
　
　2番目の引数にインターナルフレームのサイズを変更出来るかどうかを表すboolean型の値を設定します。「true」を設定した場合はサイズの変更が行えます。
　
　実際の使い方は次のようになります。

JInternalFrame iframe = new JInternalFrame("title", true);
　

メソッドで指定する
　作成されたJInternalFramクラスのオブジェクトに対してメソッドを使ってサイズ変更の可否を設定することも可能です。サイズ変更の可否を設定するにはJInternalFrameクラスで用意されている「setResizable」メソッドを使います。
　

setResizable public void setResizable(boolean b)
　ユーザーアクションによって JInternalFrame のサイズ変更ができるかどうかを設定します。
　
　パラメータ:
　　　b - boolean 値。true の場合は、この内部フレームをサイズ変更できる

　
　引数にインターナルフレームのサイズを変更出来るかどうかを表すboolean型の値を設定します。「true」を設定した場合はサイズの変更が行えます。
　
　実際の使い方は次のようになります。

JInternalFrame iframe = new JInternalFrame(); iframe.setResizable(true);
　では簡単なサンプルを作成して試してみます。
　

サンプルプログラム
　下記のサンプルを実行してみよう。

/** * インターナルフレームがサイズ変更の可否を設定する */ import javax.swing.*; import java.awt.BorderLayout; public class JDesktopPaneTest6 extends JFrame{ public static void main(String[] args){ JDesktopPaneTest6 frame = new JDesktopPaneTest6(); frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); frame.setBounds(10, 10, 300, 200); frame.setTitle("タイトル"); frame.setVisible(true); } JDesktopPaneTest6(){ JDesktopPane desktop = new JDesktopPane(); JInternalFrame iframe1 = new JInternalFrame("IFrame1", true); iframe1.setSize(250, 120); iframe1.setLocation(10, 10); iframe1.setVisible(true); JInternalFrame iframe2 = new JInternalFrame("IFrame2"); iframe2.setSize(250, 120); iframe2.setLocation(30, 30); iframe2.setResizable(false); iframe2.setVisible(true); desktop.add(iframe1); desktop.add(iframe2); getContentPane().add(desktop, BorderLayout.CENTER); } }
　上記をコンパイルした後で実行すると次のように表示されます。
　

　
　1番目のフレームはサイズ変更が出来るように設定していますので、フレームの枠をマウスでドラックすることでサイズを変更できます。
　

[ 目次 ]

最大化、アイコン化、クローズボタンの設置を設定する

　
　インターナルフレームに最大化ボタン、アイコン化ボタン、クローズボタンの設置を設定する方法を確認します。ボタンの設置を設定するにはコンストラクタで指定する方法とメソッドで指定する方法があります。まずはコンストラクタで設定する方法を確認します。
　

JInternalFrame public JInternalFrame(String title, boolean resizable, boolean closable, boolean maximizable, boolean iconifiable)
　タイトル、サイズの変更可能性、クローズ可能性、最大化可能性、およびアイコン化の可能性を指定して、JInternalFrame を作成します。すべての JInternalFrame コンストラクタは、これを使用します。
　
　パラメータ:
　　　title - タイトルバーに表示する String
　　　resizable - true の場合、内部フレームはサイズ変更できる
　　　closable - true の場合、内部フレームはクローズできる
　　　maximizable - true の場合、内部フレームは最大化できる
　　　iconifiable - true の場合、内部フレームはアイコン化できる

　
　1番目の引数にインターナルフレームのタイトルに表示される文字列をString型の値で指定します。
　
　2番目の引数にインターナルフレームのサイズを変更出来るかどうかを表すboolean型の値を設定します。「true」を設定した場合はサイズの変更が行えます。
　
　3番目の引数にクローズボタンを設置するかどうか表すboolean型の値を設定します。「true」を設定した場合はクローズボタンが設置されます。
　
　4番目の引数に最大化ボタンを設置するかどうか表すboolean型の値を設定します。「true」を設定した場合は最大化ボタンが設置されます。
　
　5番目の引数にアイコン化ボタンを設置するかどうか表すboolean型の値を設定します。「true」を設定した場合はアイコン化が設置されます。
　
　実際の使い方は次のようになります。

JInternalFrame iframe = new JInternalFrame("title", true, true, true, true);
　

メソッドで指定する
　作成されたJInternalFramクラスのオブジェクトに対してメソッドを使って最大化ボタン、アイコン化ボタン、クローズボタンの設置を設定することも可能です。
　
　まず最大化ボタンを設置するかどうかを設定するにはJInternalFrameクラスで用意されている「setMaximizable」メソッドを使います。
　

setMaximizable public void setMaximizable(boolean b)
　maximizable プロパティーを設定します。このプロパティーは、ユーザーアクションによって JInternalFrame を最大化できるかどうかを指定します。内部フレームの最大化を実装していない Look & Feel もあり、その場合このプロパティーは無視されます。
　
　パラメータ:
　　　b - true の場合はこの内部フレームは最大化できるように指定され、false
　　　　の場合は最大化できないように指定される

　
　引数に最大化ボタンを設置するかどうかを表すboolean型の値を設定します。「true」を設定した場合は最大化ボタンが設置されます。
　
　次にアイコン化ボタンを設置するかどうかを設定するにはJInternalFrameクラスで用意されている「setIconifiable」メソッドを使います。
　

setIconifiable public void setIconifiable(boolean b)
　iconable プロパティーを設定します。ユーザーが JInternalFrame をアイコン化できるようにするには true にする必要があります。Look & Feel によってはアイコン化機能が実装されないことがあり、その場合このプロパティーは無視されます。
　
　パラメータ:
　　　b - boolean 値。true の場合は、この内部フレームをアイコン化できる

　
　引数にアイコン化ボタンを設置するかどうかを表すboolean型の値を設定します。「true」を設定した場合はアイコン化ボタンが設置されます。
　
　次にクローズボタンを設置するかどうかを設定するにはJInternalFrameクラスで用意されている「setClosable」メソッドを使います。
　

setClosable public void setClosable(boolean b)
　ユーザーアクションによってこの JInternalFrame を閉じることができるかどうかを設定します。
　
　パラメータ:
　　　b - boolean 値。true の場合は、この内部フレームを閉じることができる

　
　引数にクローズボタンを設置するかどうかを表すboolean型の値を設定します。「true」を設定した場合はクローズボタンが設置されます。
　
　実際の使い方は次のようになります。

JInternalFrame iframe = new JInternalFrame(); iframe.setMaximizable(true); iframe.setIconifiable(true); iframe.setClosable(true);
　では簡単なサンプルを作成して試してみます。
　

サンプルプログラム
　下記のサンプルを実行してみよう。

/** * 最大化、アイコン化、クローズボタンの設置を設定する */ import javax.swing.*; import java.awt.BorderLayout; public class JDesktopPaneTest7 extends JFrame{ public static void main(String[] args){ JDesktopPaneTest7 frame = new JDesktopPaneTest7(); frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); frame.setBounds(10, 10, 300, 200); frame.setTitle("タイトル"); frame.setVisible(true); } JDesktopPaneTest7(){ JDesktopPane desktop = new JDesktopPane(); JInternalFrame iframe1 = new JInternalFrame("IFrame1", true, true, true, true); iframe1.setSize(250, 120); iframe1.setLocation(10, 10); iframe1.setVisible(true); JInternalFrame iframe2 = new JInternalFrame("IFrame2"); iframe2.setSize(250, 120); iframe2.setLocation(30, 30); iframe2.setMaximizable(true); iframe2.setClosable(true); iframe2.setVisible(true); desktop.add(iframe1); desktop.add(iframe2); getContentPane().add(desktop, BorderLayout.CENTER); } }
　上記をコンパイルした後で実行すると次のように表示されます。
　

　
　子フレームの右上に表示されているのが最大化/アイコン化/クローズボタンです。一番左のボタンがアイコン化ボタンです。
　

　
　アイコン化ボタンをクリックすると子フレームがアイコン化して表示されます。
　

　
　真ん中のボタンが最大化ボタンです。
　

　
　最大化ボタンをクリックすると子フレームが最大化して表示されます。
　

　
　一番右のボタンがクローズボタンです。
　

　
　クローズボタンをクリックすると子フレームが閉じられます。
　

[ 目次 ]

インターナルフレームのレイヤーの値を取得する

　
　インターナルフレームがデスクトップペインの中で複数存在する場合にどのインターナルフレームが上位に表示されるかはレイヤーと呼ばれる値を使って管理しています。
　
　まずインターナルフレームが作成された時点でレイヤーの値を取得してみます。JInternalFrameクラスで用意されている「getLayer」メソッドを使います。
　

getLayer public int getLayer()
　このコンポーネントのレイヤー属性を取得する簡易メソッドです。
　
　戻り値:
　　　このフレームのデスクトップレイヤーを指定する Integer オブジェクト

　
　戻り値としてインターナルフレームに設定されているレイヤーの値を表すint型の値を取得出来ます。
　
　実際の使い方は次のようになります。

JInternalFrame iframe = new JInternalFrame("title"); int layer = iframe.getLayer();
　では簡単なサンプルを作成して試してみます。
　

サンプルプログラム
　下記のサンプルを実行してみよう。

/** * インターナルフレームのレイヤーの値を取得する */ import javax.swing.*; import java.awt.BorderLayout; public class JDesktopPaneTest8 extends JFrame{ public static void main(String[] args){ JDesktopPaneTest8 frame = new JDesktopPaneTest8(); frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); frame.setBounds(10, 10, 300, 200); frame.setTitle("タイトル"); frame.setVisible(true); } JDesktopPaneTest8(){ JDesktopPane desktop = new JDesktopPane(); JInternalFrame iframe1 = new JInternalFrame(); iframe1.setSize(250, 120); iframe1.setLocation(10, 10); iframe1.setVisible(true); int layer1 = iframe1.getLayer(); iframe1.setTitle("IFrame1[" + layer1 + "]"); JInternalFrame iframe2 = new JInternalFrame(); iframe2.setSize(250, 120); iframe2.setLocation(30, 30); iframe2.setVisible(true); int layer2 = iframe2.getLayer(); iframe2.setTitle("IFrame2[" + layer2 + "]"); desktop.add(iframe1); desktop.add(iframe2); getContentPane().add(desktop, BorderLayout.CENTER); } }
　上記をコンパイルした後で実行すると次のように表示されます。
　

　
　フレームにタイトルの括弧([])の中にレイヤーの値を表示しています。特に設定していない場合はレイヤーは「0」となります。2番目のインターナルフレームをクリックしてみても同じように表示されます。
　

　
　またレイヤーの値が同じ場合には、フレームをクリックして選択状態にすると同じレイヤーが設定されたフレームの中で最前面に表示されます。

[ 目次 ]

インターナルフレームのレイヤーの値を設定する

　
　インターナルフレームのレイヤーの値を設定する方法を確認します。なおレイヤーの値は大きいほどデスクトップペインの中で上位に表示されます。JInternalFrameクラスで用意されている「setLayer」メソッドを使います。
　

setLayer public void setLayer(int layer)
　このコンポーネントのレイヤー属性を設定する簡易メソッドです。
　setLayer(Integer) メソッドは、JLayeredPane で事前に定義されたレイヤー値に使用する必要があります。setLayer(int) を使用する場合、それらの値とクラッシュしないように注意してください。
　
　パラメータ:
　　　layer - この内部フレームのデスクトップレイヤーを指定する整数

　
　引数にインターナルフレームに設定したいレイヤーの値をint型の値で指定します。
　
　実際の使い方は次のようになります。

JInternalFrame iframe = new JInternalFrame("title"); iframe.setLayer(1);
　では簡単なサンプルを作成して試してみます。
　

サンプルプログラム
　下記のサンプルを実行してみよう。

/** * インターナルフレームのレイヤーの値を設定する */ import javax.swing.*; import java.awt.BorderLayout; public class JDesktopPaneTest9 extends JFrame{ public static void main(String[] args){ JDesktopPaneTest9 frame = new JDesktopPaneTest9(); frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); frame.setBounds(10, 10, 400, 300); frame.setTitle("タイトル"); frame.setVisible(true); } JDesktopPaneTest9(){ JDesktopPane desktop = new JDesktopPane(); JInternalFrame iframe1 = new JInternalFrame(); iframe1.setSize(250, 120); iframe1.setLocation(10, 10); iframe1.setVisible(true); int layer1 = iframe1.getLayer(); iframe1.setTitle("IFrame1[" + layer1 + "]"); JInternalFrame iframe2 = new JInternalFrame(); iframe2.setSize(250, 120); iframe2.setLocation(20, 80); iframe2.setVisible(true); int layer2 = iframe2.getLayer(); iframe2.setTitle("IFrame1[" + layer2 + "]"); JInternalFrame iframe3 = new JInternalFrame(); iframe3.setSize(250, 120); iframe3.setLocation(100, 50); iframe3.setVisible(true); iframe3.setLayer(1); int layer3 = iframe3.getLayer(); iframe3.setTitle("IFrame1[" + layer3 + "]"); desktop.add(iframe1); desktop.add(iframe2); desktop.add(iframe3); getContentPane().add(desktop, BorderLayout.CENTER); } }
　上記をコンパイルした後で実行すると次のように表示されます。
　

　
　今回は3番目のインターナルフレームにだけレイヤーとして「1」を設定しています。他の2つのレイヤーはデフォルトのままですので「0」となっています。この為、レイヤーの値が一番大きい3番目のインターナルフレームが最前面に表示されています。
　
　ではレイヤーが「0」の1番目のインターナルフレームをクリックして下さい。
　

　
　クリックされたインターナルフレームが選択状態になりましたが最前面には表示されません。このようにインターナルフレームは選択状態に有る無しに関わらずレイヤーが上位のインターナルフレームが前面に表示されます。
　
　ではレイヤーが同じく「0」の2番目のインターナルフレームをクリックして下さい。
　

　
　この時、同じレイヤーの値を持つ1番目のインターナルフレームよりは前面に表示されますが、レイヤーの値が大きい3番目のインターナルフレームよりは後ろに表示されます。

[ 目次 ]

インターナルフレームを選択する

　
　デスクトップペインにインターナルフレームを追加する際、追加しただけではどのインターナルフレームも選択状態となっていません。ここでは特定のインターナルフレームを選択状態にする方法を確認します。選択するにはJInternalFrameクラスで用意されている「setSelected」メソッドを使います。
　

setSelected public void setSelected(boolean selected) throws PropertyVetoException
　内部フレームが表示されている場合に、その内部フレームを選択または選択解除します。JInternalFrame は通常、選択されている場合はタイトルバーを異なるように描画します。これにより、この内部フレームがフォーカスを持つことがユーザーに示されます。このメソッドによって内部フレームの状態が選択解除から選択へ変更されると、このメソッドは InternalFrameEvent.INTERNAL_FRAME_ACTIVATED イベントをトリガーします。選択から選択解除への変更の場合は、 InternalFrameEvent.INTERNAL_FRAME_DEACTIVATED イベントがトリガーされます。
　
　パラメータ:
　　　selected - boolean 値。true の場合はこの内部フレームが選択された状態に
　　　　なり (現在アクティブである)、false の場合は選択解除された状態になる
　例外:
　　　PropertyVetoException - プロパティーの設定の試みが JInternalFrame に拒
　　　　否された場合

　
　引数には選択状態とするかどうかを表すboolean型の値を設定します。「true」を設定すると選択状態となり「false」を設定すると非選択状態となります。
　
　実際の使い方は次のようになります。

import java.beans.PropertyVetoException; JInternalFrame iframe = new JInternalFrame("title"); iframe.setLayer(1);
　では簡単なサンプルを作成して試してみます。
　

サンプルプログラム
　下記のサンプルを実行してみよう。

/** * インターナルフレームを選択する */ import javax.swing.*; import java.awt.BorderLayout; import java.beans.PropertyVetoException; import java.awt.event.*; public class JDesktopPaneTest10 extends JFrame implements ActionListener{ JDesktopPane desktop; int frameCount; public static void main(String[] args){ JDesktopPaneTest10 frame = new JDesktopPaneTest10(); frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); frame.setBounds(10, 10, 400, 300); frame.setTitle("タイトル"); frame.setVisible(true); } JDesktopPaneTest10(){ desktop = new JDesktopPane(); frameCount = 1; JInternalFrame iframe = new JInternalFrame("IFrame" + frameCount); iframe.setSize(250, 120); iframe.setLocation(10 + frameCount * 10, 10 + frameCount * 10); iframe.setVisible(true); frameCount++; desktop.add(iframe); JButton button = new JButton("add"); button.addActionListener(this); JPanel buttonPanel = new JPanel(); buttonPanel.add(button); getContentPane().add(desktop, BorderLayout.CENTER); getContentPane().add(buttonPanel, BorderLayout.PAGE_END); } public void actionPerformed(ActionEvent e){ JInternalFrame iframe = new JInternalFrame("IFrame" + frameCount); iframe.setSize(250, 120); iframe.setLocation(10 + frameCount * 10, 10 + frameCount * 10); iframe.setVisible(true); frameCount++; desktop.add(iframe); try{ iframe.setSelected(true); }catch(PropertyVetoException ex){ System.out.println(ex.getMessage()); } } }
　上記をコンパイルした後で実行すると次のように表示されます。
　

　
　画面下部のボタンをクリックすると新しいインターナルフレームが作成され選択状態にします。今回インターナルフレームは全て同じレイヤーとなっているため選択状態にすると最前面に表示されます。
　

　

[ 目次 ]

インターナルフレームにコンポーネントを追加する

　
　JInternalFrameクラスのオブジェクトに対してもコンポーネントを追加する事が出来ます。基本的にJFrameクラスの場合と同じです。コンポーネントを追加するにはJFrameクラスの場合と同じくインターナルフレームから「ContentPane」を取りだし、コンテントペインにコンポーネントを追加していきます。
　
　インターナルフレームからコンテントペインを取り出すにはJInternalFrameクラスで用意されている「getContentPane」メソッドを使います。
　

getContentPane public Container getContentPane()
　この内部フレームのコンテンツ区画を返します。
　
　戻り値:
　　　コンテンツ区画

　
　メソッドを実行するとインターナルフレームから「ContentPane」を表すコンテナを取得できます。コンテナは「Container」クラスのオブジェクトです。
　
　次に取り出したコンテナに対してコンポーネントを追加していきます。追加するにはContainerクラスで用意されている「add」メソッドを使います。
　

add public Component add(Component comp)
　指定されたコンポーネントをこのコンテナの最後に追加します。これは addImpl(java.awt.Component, java.lang.Object, int) の簡易メソッドです。
　
　注:コンポーネントを、表示されているコンテナに追加した場合、そのコンテナに対して validate を呼び出し、新しいコンポーネントを表示する必要があります。複数のコンポーネントを追加する場合は、すべてのコンポーネントを追加したあとで、validate を 1 回だけ呼び出すことによって、効率を向上できます。
　
　パラメータ:
　　　comp - 追加されるコンポーネント
　戻り値:
　　　コンポーネント引数
　例外:
　　　NullPointerException - comp が null の場合

　
　引数には追加したいComponentクラスのオブジェクトを指定します。
　
　またコンポーネントを追加する時に配置方法を指定するメソッドも用意されています。Containerクラスで用意されている「add」メソッドを使います。
　

add public void add(Component comp, Object constraints)
　指定されたコンポーネントをこのコンテナの最後に追加します。また、指定された制約オブジェクトを使用して、このコンテナの配置にコンポーネントを追加することをレイアウトマネージャーに通知します。これは addImpl(java.awt.Component, java.lang.Object, int) の簡易メソッドです。
　
　パラメータ:
　　　comp - 追加されるコンポーネント
　　　constraints - このコンポーネントの配置条件を表現するオブジェクト
　例外:
　　　NullPointerException - comp が null の場合

　
　1番目の引数に追加したいコンポーネントを指定し、2番目の引数には使用しているレイアウトマネージャーで用意された配置条件を表す値を指定します。
　
　実際の使い方は次のようになります。

JInternalFrame iframe = new JInternalFrame(); JButton button = new JButton("button"); iframe.getContentPane().add(button, BorderLayout.CENTER);
　※JInternalFrameクラスのデフォルトレイアウトマネージャーはBorderLayoutのようです。
　
　では簡単なサンプルを作成して試してみます。
　

サンプルプログラム
　下記のサンプルを実行してみよう。

/** * インターナルフレームにコンポーネントを追加する */ import javax.swing.*; import java.awt.BorderLayout; public class JDesktopPaneTest11 extends JFrame{ public static void main(String[] args){ JDesktopPaneTest11 frame = new JDesktopPaneTest11(); frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); frame.setBounds(10, 10, 400, 300); frame.setTitle("タイトル"); frame.setVisible(true); } JDesktopPaneTest11(){ JDesktopPane desktop = new JDesktopPane(); JInternalFrame iframe = new JInternalFrame("IFrame"); iframe.setSize(250, 120); iframe.setLocation(10, 10); iframe.setVisible(true); JLabel label = new JLabel("Name"); JTextField text = new JTextField("", 10); JPanel p = new JPanel(); p.add(label); p.add(text); iframe.getContentPane().add(p, BorderLayout.CENTER); desktop.add(iframe); getContentPane().add(desktop, BorderLayout.CENTER); } }
　上記をコンパイルした後で実行すると次のように表示されます。
　

[ 目次 ]

インターナルフレームにメニューバーを配置する

　
　インターナルフレームにメニューバーを配置する方法を確認します。JInternalFrameクラスで用意されている「setJMenuBar」メソッドを使います。
　
　※メニューの詳しい使い方については『JMenuクラス,JMenuBarクラス,JMenuItemクラス』を参照して下さい。
　

setJMenuBar public void setJMenuBar(JMenuBar m)
　この JInternalFrame の menuBar プロパティーを設定します。
　
　パラメータ:
　　　m - この内部フレームで使用する JMenuBar

　
　引数にはメニュー全体を表すJMenuBarクラスのオブジェクトを指定します。
　
　実際の使い方は次のようになります。

JInternalFrame iframe = new JInternalFrame(); JMenuBar menubar = new JMenuBar(); iframe.setJMenuBar(menubar);
　では簡単なサンプルを作成して試してみます。
　

サンプルプログラム
　下記のサンプルを実行してみよう。

/** * インターナルフレームにメニューバーを配置する */ import javax.swing.*; import java.awt.BorderLayout; public class JDesktopPaneTest12 extends JFrame{ public static void main(String[] args){ JDesktopPaneTest12 frame = new JDesktopPaneTest12(); frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); frame.setBounds(10, 10, 400, 300); frame.setTitle("タイトル"); frame.setVisible(true); } JDesktopPaneTest12(){ JDesktopPane desktop = new JDesktopPane(); JInternalFrame iframe = new JInternalFrame("IFrame"); iframe.setSize(250, 120); iframe.setLocation(10, 10); iframe.setVisible(true); JLabel label = new JLabel("Name"); JTextField text = new JTextField("", 10); JPanel p = new JPanel(); p.add(label); p.add(text); iframe.getContentPane().add(p, BorderLayout.CENTER); JMenuBar menuBar = new JMenuBar(); JMenu menu1 = new JMenu("File"); JMenuItem item1 = new JMenuItem("Open"); JMenuItem item2 = new JMenuItem("Close"); menu1.add(item1); menu1.add(item2); JMenu menu2 = new JMenu("Edit"); menuBar.add(menu1); menuBar.add(menu2); iframe.setJMenuBar(menuBar); desktop.add(iframe); getContentPane().add(desktop, BorderLayout.CENTER); } }
　上記をコンパイルした後で実行すると次のように表示されます。
　

　

[ 目次 ]

ウィンドウアイコンを設定する

　
　インターナルフレームの左上に表示される小さいアイコンを設定します。これはフレームが最小化した場合にも表示されるアイコンです。JInternalFrameクラスで用意されている「setFrameIcon」メソッドを使います。
　

setFrameIcon public void setFrameIcon(Icon icon)
　この内部フレームのタイトルバー (通常は左上隅) に表示するイメージを設定します。このイメージは desktopIcon オブジェクトとは異なります。desktopIcon オブジェクトは、この内部フレームがアイコン化されたときに JDesktop に表示されるイメージです。この関数には null を渡すことができますが、場面に応じて Look & Feel は、アイコンを表示しない、Look & Feel のデフォルトアイコンを表示するなど、適切な動作を選択できます。
　
　パラメータ:
　　　icon - タイトルバーに表示する Icon

　
　引数には表示したい画像を表すIconインターフェースを実装したクラスのオブジェクトを指定します。JavaではIconインターフェースを実装したクラスとしてImageIconクラスが用意されていますので通常はImageIconクラスのオブジェクトを指定して下さい。(ImageIconクラスについては『ImageIconクラス』を参照して下さい)。
　
　実際の使い方は次のようになります。

JInternalFrame iframe = new JInternalFrame(); ImageIcon icon = new ImageIcon("./img/sample.png"); iframe.setFrameIcon(icon);
　では簡単なサンプルを作成して試してみます。
　
　※今回使用させて頂いた画像は『牛飼いとアイコンの部屋』で公開されている画像を使用させて頂いています。
　

サンプルプログラム
　下記のサンプルを実行してみよう。

/** * ウィンドウアイコンを設定する */ import javax.swing.*; import java.awt.BorderLayout; public class JDesktopPaneTest13 extends JFrame{ public static void main(String[] args){ JDesktopPaneTest13 frame = new JDesktopPaneTest13(); frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); frame.setBounds(10, 10, 400, 300); frame.setTitle("タイトル"); frame.setVisible(true); } JDesktopPaneTest13(){ JDesktopPane desktop = new JDesktopPane(); ImageIcon icon = new ImageIcon("./img/mem10.gif"); JInternalFrame iframe1 = new JInternalFrame("IFrame1"); iframe1.setSize(250, 150); iframe1.setLocation(10, 10); iframe1.setVisible(true); iframe1.setFrameIcon(icon); JInternalFrame iframe2 = new JInternalFrame("IFrame2"); iframe2.setSize(250, 150); iframe2.setLocation(100, 100); iframe2.setVisible(true); desktop.add(iframe1); desktop.add(iframe2); getContentPane().add(desktop, BorderLayout.CENTER); } }
　上記をコンパイルした後で実行すると次のように表示されます。
　

　
　2番目のフレームはデフォルトの状態です。大きめのアイコンを指定してもフレームバーのサイズが大きくなるということはないようです。
　

[ 目次 ]

リリースノート

2024/10/11 Ver=2.04 JDK_23 で確認
2023/04/22 Ver=2.03 JDK_20 で確認
2021/12/01 Ver=1.04 JDK_17 で確認
2021/08/06 Ver=1.03 JDK_16 で確認
2020/10/21 Ver=1.02 JDK_15 で確認
2017/01/13 Ver=1.01 初版リリース

[ 目次 ]

関連ページ

[ 目次 ]