モジュール java.desktop
パッケージ javax.swing

クラスJTabbedPane

java.lang.Object
java.awt.Component
java.awt.Container
javax.swing.JComponent
javax.swing.JTabbedPane
すべての実装されたインタフェース:
ImageObserver, MenuContainer, Serializable, Accessible, SwingConstants
@JavaBean(defaultProperty="UI", description="A component which provides a tab folder metaphor for displaying one component from a set of components.") public class JTabbedPane extends JComponent implements Serializable, Accessible, SwingConstants
指定されたタイトルやアイコンを持つタブをクリックすることにより、ユーザーがコンポーネントのグループを切り替えられるようにするコンポーネントです。 タブ・ペインの例および情報については、『The Java Tutorial』の「How to Use Tabbed Panes」を参照してください。

タブまたはコンポーネントは、addTabおよびinsertTabメソッドを使用してTabbedPaneオブジェクトに追加されます。 タブは、追加された位置に対応するインデックスで表され、1番目のタブがインデックス0となり、最後のタブがタブの総数より1小さいインデックスになります。

TabbedPaneはSingleSelectionModelを使用してタブ・インデックスのセットと現在選択されているインデックスを表します。 タブの総数が0より大きい場合、選択されているインデックスが常にあり、デフォルトでは、1番目のタブが選択されるように初期化されます。 タブの総数が0の場合、選択されるインデックスは -1になります。

タブのタイトルはComponentを使ってレンダリングできます。 たとえば、次のコードを使用しても同じ結果になります。 

 // In this case the look and feel renders the title for the tab.
 tabbedPane.addTab("Tab", myComponent);
 // In this case the custom component is responsible for rendering the
 // title of the tab.
 tabbedPane.addTab(null, myComponent);
 tabbedPane.setTabComponentAt(0, new JLabel("Tab"));
後者は、通常、タブ上でカスタム・コンポーネントを使用する、より複雑なユーザー操作が必要な場合に使用します。 たとえば、アニメーション効果を提供するカスタム・コンポーネントや、タブを閉じるためのウィジェットを持つカスタム・コンポーネントを提供できます。

タブのコンポーネントを指定した場合、JTabbedPaneは、ユーザーがタブに指定したテキストやアイコンをレンダリングしません。

ノート: タブ・コンポーネントを可視化する場合は、タブ・コンポーネント上で直接setVisibleを使用するのではなく、setSelectedComponentメソッドまたはsetSelectedIndexメソッドを使用してください。

警告: Swingはスレッドに対して安全ではありません。 詳細は、「Swing's Threading Policy」を参照してください。

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

導入されたバージョン:
1.2
関連項目: