クラスJList<E>

型パラメータ:
E - このリストの要素のタイプ
すべての実装されたインタフェース:
ImageObserver, MenuContainer, Serializable, Accessible, Scrollable

@JavaBean(defaultProperty="UI", description="A component which allows for the selection of one or more objects from a list.") public class JList<E> extends JComponent implements Scrollable, Accessible
オブジェクトのリストを表示し、ユーザーが1つまたは複数のオブジェクトを選択できるようにするコンポーネントです。 別のモデルであるListModelが、リストの内容を保持します。

読取り専用のListModelのインスタンスを自動生成するJListコンストラクタを使用すれば、オブジェクトの配列またはVectorを簡単に表示できます。


// Create a JList that displays strings from an array

String[] data = {"one", "two", "three", "four"};
JList<String> myList = new JList<String>(data);

// Create a JList that displays the superclasses of JList.class, by
// creating it with a Vector populated with this data

Vector<Class<?>> superClasses = new Vector<Class<?>>();
Class<JList> rootClass = javax.swing.JList.class;
for(Class<?> cls = rootClass; cls != null; cls = cls.getSuperclass()) {
    superClasses.addElement(cls);
}
JList<Class<?>> myList = new JList<Class<?>>(superClasses);

// The automatically created model is stored in JList's "model"
// property, which you can retrieve

ListModel<Class<?>> model = myList.getModel();
for(int i = 0; i < model.getSize(); i++) {
    System.out.println(model.getElementAt(i));
}

コンストラクタまたはsetModelメソッドを使用して、ListModelJListに直接指定できます。 コンテンツがstaticである必要はありません。項目数や項目の値は、時間の経過とともに変化してもかまいません。 ListModelが正しく実装されていれば、変更が発生するたびに、追加されたjavax.swing.event.ListDataListenerのセットに通知が送られます。 これらの変更は、修正、追加または削除されたリスト・インデックスの範囲を識別するjavax.swing.event.ListDataEventによって記述されます。 JListListUIは、モデルの変更を待機することによって、ビジュアルな表現が常に最新の状態になるようにします。

単純な動的コンテンツのJListアプリケーションは、DefaultListModelクラスを使用してリスト要素を管理できます。 このクラスは、ListModelインタフェースを実装し、java.util.Vectorと同様のAPIも提供します。 一方、カスタムListModel実装を必要とするアプリケーションは、リスナーの管理および通知に関する基本機能を提供するAbstractListModelのサブクラスとすることができます。 たとえば、AbstractListModelの読取り専用実装の場合、次のようになります。


// This list model has about 2^16 elements.  Enjoy scrolling.

ListModel<String> bigData = new AbstractListModel<String>() {
    public int getSize() { return Short.MAX_VALUE; }
    public String getElementAt(int index) { return "Index " + index; }
};

JListの選択状態は、ListSelectionModelのインスタンスである別のモデルによって管理されます。 JListは、構築時に選択モデルによって初期化され、また、この選択モデルの照会や設定を行う各メソッドを含んでいます。 JListは、選択を簡単に管理できる便利なメソッドも提供します。 たとえばsetSelectedIndexgetSelectedValueなどのカバー・メソッドでは、選択モデルとのやりとりの詳細を管理できます。 デフォルトでは、JListの選択モデルは、任意の項目の組み合わせを一度に選択できるように設定されます(MULTIPLE_INTERVAL_SELECTION選択モード)。 選択モードは、選択モデル上で直接変更するか、JListのカバー・メソッドを使って変更します。 ユーザーのジェスチャに応じて選択モデルを更新する処理は、リストのListUIによって行われます。

ListSelectionModelが正しく実装されていれば、選択が変更されるたびに追加されたjavax.swing.event.ListSelectionListenerのセットに通知が送られます。 これらの変更は、選択範囲の変更を識別するjavax.swing.event.ListSelectionEventによって記述されます。

リスト選択の変更をリスンする方法としては、JListに直接ListSelectionListenerを追加することをお勧めします。 JListは、選択モデルをリスニングし、リスナーに変更を通知します。

リストのビジュアルな表現を常に最新の状態にしておくため、選択の変更を待機する処理は、リストのListUIによって行われます。

JList内のセルのペイントは、リスト上にcellRendererプロパティとしてインストールされた、セル・レンダラと呼ばれる委譲によって処理されます。 このレンダラは、「ゴムスタンプ」のように使用してセルをペイントできるjava.awt.Componentを提供します。 セルをペイントする必要が生じるたびに、リストのListUIはセル・レンダラにコンポーネントを要求し、それを適切な位置に移動した後、paintメソッドを使用してセルのコンテンツをペイントします。 JLabelコンポーネントを使用してレンダリングを行うデフォルトのセル・レンダラは、リストのListUIによってインストールされます。 次のようなコードにより、独自のレンダラを使用することもできます。


 // Display an icon and a string for each object in the list.

class MyCellRenderer extends JLabel implements ListCellRenderer<Object> {
    static final ImageIcon longIcon = new ImageIcon("long.gif");
    static final ImageIcon shortIcon = new ImageIcon("short.gif");

    // This is the only method defined by ListCellRenderer.
    // We just reconfigure the JLabel each time we're called.

    public Component getListCellRendererComponent(
      JList<?> list,           // the list
      Object value,            // value to display
      int index,               // cell index
      boolean isSelected,      // is the cell selected
      boolean cellHasFocus)    // does the cell have focus
    {
        String s = value.toString();
        setText(s);
        setIcon((s.length() > 10) ? longIcon : shortIcon);
        if (isSelected) {
            setBackground(list.getSelectionBackground());
            setForeground(list.getSelectionForeground());
        } else {
            setBackground(list.getBackground());
            setForeground(list.getForeground());
        }
        setEnabled(list.isEnabled());
        setFont(list.getFont());
        setOpaque(true);
        return this;
    }
}

myList.setCellRenderer(new MyCellRenderer());

セル・レンダリングの別のジョブは、リストのサイズ情報の特定にも役立ちます。 デフォルトでは、リストのListUIがセル・レンダリングに各リスト項目の推奨サイズを問い合わせることによって、セルのサイズを決定します。 リストの項目数が多い場合、この処理は負荷が大きくなります。 これらの計算を回避するには、リスト上にfixedCellWidthfixedCellHeightを設定するか、これらの値が単一のプロトタイプ値に基づいて自動計算されるように設定します。


JList<String> bigDataList = new JList<String>(bigData);

// We don't want the JList implementation to compute the width
// or height of all of the list cells, so we give it a string
// that's as big as we'll need for any cell.  It uses this to
// compute values for the fixedCellWidth and fixedCellHeight
// properties.

bigDataList.setPrototypeCellValue("Index 1234567890");

JListはスクロールを直接実装していません。 スクロール・リストを作成するには、これをJScrollPaneのビューポート・ビューとして設定します。 たとえば:

JScrollPane scrollPane = new JScrollPane(myList);

// Or in two steps:
JScrollPane scrollPane = new JScrollPane();
scrollPane.getViewport().setView(myList);

JListは、ダブルクリックやトリプル・クリック(またはそれ以上の回数のクリック)のような特別な処理は行いませんが、これらのイベントの発生時にアクションを実行したい場合は、MouseListenerを簡単に追加できます。 クリックされたセルを調べるには、locationToIndexメソッドを使用します。 たとえば:

MouseListener mouseListener = new MouseAdapter() {
    public void mouseClicked(MouseEvent e) {
        if (e.getClickCount() == 2) {
            int index = list.locationToIndex(e.getPoint());
            System.out.println("Double clicked on Item " + index);
         }
    }
};
list.addMouseListener(mouseListener);

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

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

詳細は、「The Java Tutorial」の「How to Use Lists」を参照してください。

導入されたバージョン:
1.2
関連項目:
  • ネストされたクラスのサマリー

    ネストされたクラス
    修飾子と型
    クラス
    説明
    protected class 
    このクラスはJListクラスのアクセシビリティ・サポートを実装しています。
    static final class 
    TransferHandler.DropLocationのサブクラスであり、JListのドロップ位置を表します。

    クラスJComponentで宣言されたネストされたクラス/インタフェース

    JComponent.AccessibleJComponent
    修飾子と型
    クラス
    説明
    class 
    アクセシビリティのデフォルト・サポートを提供するために使用されるJComponentの内部クラスです。

    Containerクラスで宣言されたネストされたクラス/インタフェース

    Container.AccessibleAWTContainer
    修飾子と型
    クラス
    説明
    protected class 
    アクセシビリティのデフォルト・サポートの提供に使用するContainerの内部クラスです。

    クラスComponentで宣言されたネストされたクラス/インタフェース

    Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
    修飾子と型
    クラス
    説明
    protected class 
    アクセシビリティのデフォルト・サポートの提供に使用するComponentの内部クラスです。
    static enum 
    コンポーネントのサイズが変化するにつれてベースラインが変化する共通の方法を列挙します。
    protected class 
    オフスクリーン表面のコンポーネントへのBlit用内部クラスです。
    protected class 
    コンポーネントのバッファ反転用内部クラス。
  • フィールドのサマリー

    フィールド
    修飾子と型
    フィールド
    説明
    static final int
    セルが水平方向の次に垂直方向の順で並ぶ「ニュースペーパー・スタイル」レイアウトを示します。
    static final int
    セルを垂直方向に1列に並べたレイアウト(デフォルト)を示します。
    static final int
    セルが垂直方向の次に水平方向の順で並ぶ「ニュースペーパー・スタイル」レイアウトを示します。

    クラスで宣言されたフィールド JComponent

    listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
    修飾子と型
    フィールド
    説明
    このコンポーネントのイベント・リスナー・リストです。
    static final String
    カーソルがコンポーネント上にあるときに表示されるコメントです。「値ヒント」、「浮遊ヘルプ」、または「浮遊ラベル」とも呼ばれます。
    protected ComponentUI
    このコンポーネントのルック・アンド・フィール委譲です。
    static final int
    いくつかのAPIで使用される定数です。条件が定義されていないことを示します。
    static final int
    registerKeyboardActionで使用される定数です。受信側コンポーネントがフォーカスを持つコンポーネントの上位であるか、それ自体がフォーカスを持つコンポーネントである場合に、コマンドを呼び出すことを示します。
    static final int
    registerKeyboardActionで使用される定数です。コンポーネントにフォーカスが設定されたときにコマンドを呼び出すことを示します。
    static final int
    registerKeyboardActionで使用される定数です。受信側コンポーネントがフォーカスを持つウィンドウ内にあるか、それ自体がフォーカスを持つコンポーネントである場合に、コマンドを呼び出すことを示します。

    クラスコンポーネントで宣言されたフィールド

    accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
    修飾子と型
    フィールド
    説明
    このComponentに関連付けられたAccessibleContext
    static final float
    getAlignmentYのための便利な定数。
    static final float
    getAlignmentYおよびgetAlignmentXのための便利な定数。
    static final float
    getAlignmentXのための便利な定数。
    static final float
    getAlignmentXのための便利な定数。
    static final float
    getAlignmentY()のための便利な定数。

    インタフェースで宣言されたフィールド ImageObserver

    ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
    修飾子と型
    フィールド
    説明
    static final int
    imageUpdateメソッドのinfoflags引数の1要素であるこのフラグは、非同期的に記録されていたイメージの生成がその完了前に中断したことを示します。
    static final int
    imageUpdateメソッドのinfoflags引数の1要素であるこのフラグは、それまでに描画されたスタティック・イメージが現在は完成し、その最終形式で再び描画できることを示します。
    static final int
    imageUpdateメソッドのinfoflags引数の1要素であるこのフラグは、非同期的に追跡されたイメージでエラーが検出されたことを示します。
    static final int
    imageUpdateメソッドのinfoflags引数の1要素であるこのフラグは、マルチフレーム・イメージの、それまでに描画されたもう1つの完全なフレームを再描画に利用できることを示します。
    static final int
    imageUpdateメソッドのinfoflags引数の1要素であるこのフラグは、ベース・イメージの幅が利用可能であることを示し、imageUpdateコールバック・メソッドの引数heightから取得できます。
    static final int
    imageUpdateメソッドのinfoflags引数の1要素であるこのフラグは、イメージのプロパティを現在利用できることを示します。
    static final int
    imageUpdateメソッドのinfoflags引数の1要素であるこのフラグは、イメージをスケーリングしたバリエーションを描画するために必要なピクセルが現在利用可能であることを示します。
    static final int
    imageUpdateメソッドのinfoflags引数の1要素であるこのフラグは、ベース・イメージの幅が利用可能であることを示し、imageUpdateコールバック・メソッドの引数widthから取得できます。
  • コンストラクタのサマリー

    コンストラクタ
    コンストラクタ
    説明
    空の読取り専用モデルでJListを構築します。
    JList(E[] listData)
    指定された配列の要素を表示するJListを構築します。
    JList(Vector<? extends E> listData)
    指定されたVectorの要素を表示するJListを構築します。
    JList(ListModel<E> dataModel)
    指定されたnull以外のモデルの要素を表示するJListを構築します。
  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    void
    選択が変更されるたびに通知されるリストにリスナーを追加します。選択状態の変更を待機する方法としてお勧めです。
    void
    addSelectionInterval(int anchor, int lead)
    指定された区間を現在の選択に加えます。
    void
    選択をクリアします。このメソッドを呼び出したあとは、isSelectionEmptytrueを返します。
    リストの選択モデル・プロパティを初期化するため、構築中に呼び出されるDefaultListSelectionModelのインスタンスを返します。
    void
    囲み側のビュー・ポート内のリストをスクロールし、指定されたセルを完全に可視にします。
    protected void
    fireSelectionValueChanged(int firstIndex, int lastIndex, boolean isAdjusting)
    選択のリストに直接追加されたListSelectionListenerに、選択モデルに変更が加えられたことを通知します。
    このJListに関連付けられているAccessibleContextを取得します。
    int
    アンカー選択インデックスを返します。
    getCellBounds(int index0, int index1)
    2つのインデックスで指定されたセルの範囲を示す、リストの座標系内の境界の矩形を返します。
    リスト項目をペイントするオブジェクトを返します。
    boolean
    自動ドラッグ処理が有効であるかどうかを返します。
    このコンポーネントがコンポーネントのドラッグ・アンド・ドロップ時にドロップ位置として視覚的に示す位置を返します。現在位置が表示されていない場合はnullを返します。
    final DropMode
    このコンポーネントのドロップ・モードを返します。
    int
    現在表示されている最小のリスト・インデックスを返します。
    int
    fixedCellHeightプロパティの値を返します。
    int
    fixedCellWidthプロパティの値を返します。
    int
    現在表示されている最大のリスト・インデックスを返します。
    int
    リストのレイアウト方向のプロパティを返します。レイアウトがセルの単一の列の場合はVERTICAL、コンテンツが垂直方向の次に水平方向の順に並ぶ「ニュースペーパー・スタイル」の場合はVERTICAL_WRAP、コンテンツが水平方向の次に垂直方向の順に並ぶ「ニュースペーパー・スタイル」の場合はHORIZONTAL_WRAPを返します。
    int
    選択範囲のリード・インデックスを返します。
    addListSelectionListenerを使用してこのJListに追加されたすべてのListSelectionListenerの配列を返します。
    int
    選択されているセルの最大インデックスを返すか、選択範囲が空の場合は-1を返します。
    int
    選択されているセルの最小インデックスを返すか、選択範囲が空の場合は-1を返します。
    JListコンポーネントによって表示される項目のリストを保持するデータ・モデルを返します。
    int
    getNextMatch(String prefix, int startIndex, Position.Bias bias)
    指定された接頭辞で始まる、toString値を持つ次のリスト要素を返します。
    visibleRowCount行を表示するために必要なビュー・ポートのサイズを計算します。
    セルの固定幅と固定の高さを計算するために使用する値、「プロトタイプ」セル値を返します。
    int
    getScrollableBlockIncrement(Rectangle visibleRect, int orientation, int direction)
    次または前のブロックを表示するためにスクロールする距離を返します。
    boolean
    このJListJViewport内に表示され、ビュー・ポートの幅がリストの適切な高さよりも高い場合、またはレイアウト方向がVERTICAL_WRAPvisibleRowCount <= 0である場合はtrueを返します。それ以外の場合はfalseを返します。
    boolean
    このJListJViewport内に表示され、ビュー・ポートの幅がリストの適切な幅よりも広い場合、またはレイアウト方向がHORIZONTAL_WRAPvisibleRowCount <= 0である場合はtrueを返します。それ以外の場合はfalseを返します。
    int
    getScrollableUnitIncrement(Rectangle visibleRect, int orientation, int direction)
    次または前の行(垂直スクロール)または列(水平スクロール)を表示するためにスクロールする距離を返します。
    int
    選択されているセルの最小インデックスを返します。リスト内の項目が1つだけ選択されている場合は「選択値」
    int[]
    選択されているすべてのインデックスの昇順配列を返します。
    選択されているセルの最小インデックスの値を返します。リスト内の項目が1つだけ選択されている場合は「選択値」
    非推奨。
    JDK 1.7で、getSelectedValuesList()に置き換えられています
    選択されているすべての項目を、リスト内のインデックスに基づいて昇順のリストにして返します。
    選択された項目のバックグラウンドの描画に使用する色を返します。
    選択された項目のフォアグラウンドの描画に使用する色を返します。
    int
    リストの現在の選択モードを返します。
    現在の選択モデルを返します。
    指定されたイベントで使用されるツールヒント・テキストを返します。
    このコンポーネントをレンダリングするルック・アンド・フィールオブジェクトのListUIを返します。
    このコンポーネントのルック・アンド・フィールを定義するjavax.swing.plaf.ListUIクラスの名前を検索するために使用するUIDefaultsキー、"ListUI"を返します。
    boolean
    選択モデルのisAdjustingプロパティの値を返します。
    int
    visibleRowCountプロパティの値を返します。
    indexToLocation(int index)
    リストの座標系内の指定された項目の原点を返します。
    boolean
    isSelectedIndex(int index)
    指定のインデックスが選択されている場合はtrueを返し、それ以外の場合はfalseを返します。
    boolean
    何も選択されていない場合はtrueを返し、それ以外の場合はfalseを返します。
    int
    リストの座標系内の指定された位置にもっとも近いセル・インデックスを返します。
    protected String
    このJListString表現を返します。
    void
    リストから選択リスナーを削除します。
    void
    removeSelectionInterval(int index0, int index1)
    選択範囲を、指定された区間と現在の選択範囲との差集合に設定します。
    void
    setCellRenderer(ListCellRenderer<? super E> cellRenderer)
    リスト内の各セルをペイントするために使用される委譲を設定します。
    void
    setDragEnabled(boolean b)
    自動ドラッグ処理をオンまたはオフにします。
    final void
    このコンポーネントのドロップ・モードを設定します。
    void
    setFixedCellHeight(int height)
    リストに含まれるすべてのセルの高さとして使用する固定値を設定します。
    void
    setFixedCellWidth(int width)
    リストに含まれるすべてのセルの幅として使用する固定値を設定します。
    void
    setLayoutOrientation(int layoutOrientation)
    リスト・セルのレイアウト方法を定義します。
    void
    setListData(E[] listData)
    項目の配列から読取り専用ListModelを構築し、このモデルを使ってsetModelを呼び出します。
    void
    setListData(Vector<? extends E> listData)
    Vectorから読取り専用ListModelを構築し、このモデルを使ってsetModelを呼び出します。
    void
    リストの内容または「値」を表すモデルを設定し、プロパティ変更リスナーに通知して、リストの選択をクリアします。
    void
    setPrototypeCellValue(E prototypeCellValue)
    prototypeCellValueプロパティを設定し、新しい値がnon-nullである場合は、セル・レンダリング・コンポーネントにセル・レンダラからの指定の値(およびインデックス0)を要求し、このコンポーネントの推奨サイズを使用して、fixedCellWidthプロパティとfixedCellHeightプロパティを計算します。
    void
    setSelectedIndex(int index)
    単一セルを選択します。
    void
    setSelectedIndices(int[] indices)
    選択を、指定の配列によって示される一連のインデックスに変更します。
    void
    setSelectedValue(Object anObject, boolean shouldScroll)
    指定されたオブジェクトをリストから選択します。
    void
    setSelectionBackground(Color selectionBackground)
    選択された項目のバックグラウンドのレンダリングに使用する色(セル・レンダリングが選択したセルの塗りつぶしに使用できる色)を設定します。
    void
    setSelectionForeground(Color selectionForeground)
    選択された項目のフォアグラウンドのレンダリングに使用する色(セル・レンダリングがテキストとグラフィックスのレンダリングに使用できる色)を設定します。
    void
    setSelectionInterval(int anchor, int lead)
    指定された区間を選択します。
    void
    setSelectionMode(int selectionMode)
    リストの選択モードを設定します。
    void
    リストのselectionModelnullではないListSelectionModel実装に設定します。
    void
    このコンポーネントをレンダリングするルック・アンド・フィールオブジェクトのListUIを設定します。
    void
    選択モデルのvalueIsAdjustingプロパティを設定します。
    void
    setVisibleRowCount(int visibleRowCount)
    visibleRowCountプロパティ(レイアウト方向によって意味が異なる)を設定します。レイアウト方向がVERTICALの場合、スクロールしないで表示できる適切な行数が設定されます。これ以外の方向の場合、セルの折返しに影響があります。
    void
    ListUIプロパティに現在のルック・アンド・フィールが提供する値を設定することにより、このプロパティをリセットします。

    クラスで宣言されたメソッド JComponent

    addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, 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, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, 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
    修飾子と型
    メソッド
    説明
    void
    listenerを登録し、コンポーネントまたはその祖先が移動するか、あるいは可視または不可視になるときにそのリスナーがAncestorEventsを受け取れるようにします。
    void
    このコンポーネントに現在親コンポーネントがあることを、このコンポーネントに通知します。
    void
    リスナー・リストにVetoableChangeListenerを追加します。
    void
    Componentの「可視矩形」を返します。これは、このコンポーネントとそのすべての上位オブジェクトの可視矩形の共通部分です。
    boolean
    contains(int x, int y)
    マウス処理のために、このコンポーネントの正確な形状を定義する機会をUI委譲に提供します。
    ツールヒントを表示するために使用されるJToolTipのインスタンスを返します。
    void
    非推奨。
    JDKバージョン1.1で、java.awt.Component.setEnabled(boolean)に置き換えられています。
    void
    非推奨。
    JDKバージョン1.1で、java.awt.Component.setEnabled(boolean)に置き換えられています。
    void
    firePropertyChange(String propertyName, boolean oldValue, boolean newValue)
    boolean型プロパティに対するバウンド・プロパティの変更の報告をサポートします。
    void
    firePropertyChange(String propertyName, int oldValue, int newValue)
    整数型プロパティに対するバウンド・プロパティの変更の報告をサポートします。
    protected void
    fireVetoableChange(String propertyName, Object oldValue, Object newValue)
    制約プロパティの変更の報告をサポートします。
    指定されたキー・ストロークに対して登録されているアクションを実行するオブジェクトを返します。
    final ActionMap
    特定のKeyStrokeバインディングに対してトリガーするActionの指定に使用されるActionMapを返します。
    float
    Container.getAlignmentXをオーバーライドして水平方向の位置合せを返します。
    float
    Container.getAlignmentYをオーバーライドして、垂直方向の位置合せを返します。
    このコンポーネントに登録されているすべての祖先リスナーの配列を返します。
    boolean
    autoscrollsプロパティを取得します。
    int
    getBaseline(int width, int height)
    ベースラインを返します。
    サイズの変化に合わせてコンポーネントのベースラインがどのように変化するかを示す列挙を返します。
    このコンポーネントのボーダーを返します。ボーダーが現在設定されていない場合はnullを返します。
    このコンポーネントの境界を「戻り値」rvに格納し、rvを返します。
    final Object
    指定されたキーを持つプロパティの値を返します。
    protected Graphics
    このコンポーネントをペイントするために使用されるグラフィックス・オブジェクトを返します。
    このコンポーネントに割り当てられたJPopupMenuを返します。
    int
    登録されているアクションが、指定されたキー・ストロークに反応して発生するかどうかを決める条件を返します。
    int
    グラフィックス・デバッギングの状態を返します。
    static Locale
    各JComponentのロケール・プロパティを生成時に初期化するために使用するデフォルト・ロケールを返します。
    指定されたFontFontMetricsを取得します。
    このコンポーネントのグラフィックス・コンテキストを返します。グラフィックス・コンテキストを使用すると、コンポーネントを描画できます。
    int
    このコンポーネントの現在の高さを返します。
    boolean
    JPopupMenuが親から継承されるはずである場合はtrueを返します。
    final InputMap
    コンポーネントがフォーカスを取得したときに使用するInputMapを返します。
    final InputMap
    getInputMap(int condition)
    conditionで使用されているInputMapを返します。
    このコンポーネントの入力ベリファイアを返します。
    このコンポーネントでボーダーが設定されている場合はボーダーのイン・セットを返し、それ以外の場合はsuper.getInsetsを呼び出します。
    getInsets(Insets insets)
    このコンポーネントのイン・セット値を含むInsetsオブジェクトを返します。
    <T extends EventListener>
    T[]
    getListeners(Class<T> listenerType)
    このJComponentFooListenerとして現在登録されているすべてのオブジェクトの配列を返します。
    このコンポーネントのx,y原点を「戻り値」rvに格納し、rvを返します。
    最大サイズがnull以外の値に設定されている場合はその値を返します。
    最小サイズがnull以外の値に設定されている場合はその値を返します。
    非推奨。
    1.4で、FocusTraversalPolicyに置き換えられます。
    このコンポーネントの座標系にポップアップ・メニューを表示するのに適切な位置を返します。
    preferredSizenull以外の値に設定されている場合にその値を返します。
    登録されているアクションを開始するKeyStrokesを返します。
    このコンポーネントのJRootPane上位コンポーネントを返します。
    このコンポーネントの幅と高さを「戻り値」rvに格納し、rvを返します。
    このコンポーネントの座標系におけるツールヒントの位置を返します。
    setToolTipTextで設定されているツールヒントの文字列を返します。
    このコンポーネントの最上位の祖先(Windowを含む)またはnull (このコンポーネントがコンテナに追加されていない場合)を返します。
    transferHandlerプロパティを取得します。
    boolean
    このコンポーネントがフォーカスを要求する前に、現在のフォーカスを持つコンポーネントに入力ベリファイアを呼び出すかどうかを示す値を返します。
    このコンポーネントに登録されているすべての拒否可能変更リスナーの配列を返します。
    Componentの「可視矩形」を返します。これは、このコンポーネントの可視矩形、new Rectangle(0, 0, getWidth(), getHeight())、およびそのすべての上位オブジェクトの可視矩形の共通部分です。
    int
    このコンポーネントの現在の幅を返します。
    int
    コンポーネントの原点の現在のx座標を返します。
    int
    コンポーネントの原点の現在のy座標を返します。
    void
    このComponentが入力フォーカスを取得すること、およびこのComponentのトップ・レベルの祖先がフォーカスされたWindowになることを要求します。
    void
    非推奨。
    boolean
    このコンポーネントがバッファを使用してペイントするかどうかを返します。
    static boolean
    このコンポーネントが軽量の場合、つまりネイティブのウィンドウ・システム・ピアを持たない場合にtrueを返します。
    boolean
    非推奨。
    1.4で、Component.setFocusTraversalKeys(int, Set)およびContainer.setFocusCycleRoot(boolean)に置き換えられます。
    boolean
    このコンポーネントが完全に不透明な場合にtrueを返します。
    boolean
    このコンポーネントがその子をタイリングする場合、つまり子がオーバーラップしないことが保証される場合にtrueを返します。
    final boolean
    このコンポーネント上の現在のペイント操作が別のprint操作の一部である場合はtrueを返します。
    protected boolean
    子コンポーネントでトリガーされるペイントによって、このComponentまたはその上位コンポーネントのいずれかからペイントが実行される場合は、trueを返します。
    boolean
    コンポーネントが現在タイルをペイントしている場合にtrueを返します。
    boolean
    このJComponentがフォーカスを取得する場合はtrueを返し、それ以外の場合はfalseを返します。
    boolean
    このメソッドがtrueを返す場合、このコンポーネントの下位コンポーネントによってrevalidateが呼び出されると、このルートから始まるツリー全体が検証されます。
    void
    コンポーネントを描画するためにSwingによって呼び出されます。
    protected void
    コンポーネントのボーダーをペイントします。
    protected void
    このコンポーネントの子をペイントします。
    protected void
    UI委譲がnullでない場合に、UI委譲のペイント・メソッドを呼び出します。
    void
    paintImmediately(int x, int y, int w, int h)
    このコンポーネントの指定された領域、およびその領域とオーバーラップするすべての下位コンポーネントをすぐにペイントします。
    void
    指定された領域をすぐにペイントします。
    void
    コンポーネントを指定のGraphicsに出力するときに、このメソッドを呼び出します。
    void
    コンポーネントを出力するときにこのメソッドを呼び出します。
    protected void
    コンポーネントのボーダーを出力します。
    protected void
    このコンポーネントの子を出力します。
    protected void
    このメソッドは出力操作中に呼び出されます。
    protected void
    コンポーネント自体が認識するキー・イベントを処理します。
    protected boolean
    processKeyBinding(KeyStroke ks, KeyEvent e, int condition, boolean pressed)
    KeyEvent eの結果としてksのキー・バインドを処理するために呼び出されます。
    protected void
    イベントを処理するprocessKeyEventをオーバーライドします。
    protected void
    このコンポーネントで発生するマウス・イベントを、登録されているMouseListenerオブジェクトにディスパッチすることによって処理します。このメソッドの詳細については、Component.processMouseEvent(MouseEvent)を参照してください。
    protected void
    MouseEvent.MOUSE_DRAGGEDなどのマウス・モーション・イベントを処理します。
    final void
    任意のキーと値を組み合わせたクライアント・プロパティをこのコンポーネントに追加します。
    void
    registerKeyboardAction(ActionListener anAction, String aCommand, KeyStroke aKeyStroke, int aCondition)
    このメソッドは現在使われていません。類似の動作にはgetActionMap()getInputMap()を組み合わせて使用してください。
    void
    registerKeyboardAction(ActionListener anAction, KeyStroke aKeyStroke, int aCondition)
    このメソッドは現在使われていません。類似の動作にはgetActionMap()getInputMap()を組み合わせて使用してください。
    void
    listenerの登録を解除し、そのリスナーがAncestorEventsを受け取らないようにします。
    void
    このコンポーネントに親コンポーネントがなくなったことを、このコンポーネントに通知します。
    void
    VetoableChangeListenerをリスナー・リストから削除します。
    void
    repaint(long tm, int x, int y, int width, int height)
    コンポーネントが表示されている場合に、指定された領域をダーティ・リージョン・リストに追加します。
    void
    コンポーネントが表示されている場合に、指定された領域をダーティ・リージョン・リストに追加します。
    boolean
    非推奨。
    1.4で、FocusTraversalPolicy.getDefaultComponent(Container).requestFocus()に置き換えられます
    void
    このComponentが入力フォーカスを取得することを要求します。
    boolean
    requestFocus(boolean temporary)
    このComponentが入力フォーカスを取得することを要求します。
    boolean
    このComponentが入力フォーカスを取得することを要求します。
    protected boolean
    requestFocusInWindow(boolean temporary)
    このComponentが入力フォーカスを取得することを要求します。
    void
    第1レイヤーのInputMapsActionMapのバインディングをすべて登録解除します。
    void
    reshape(int x, int y, int w, int h)
    非推奨。
    JDK 5で、Component.setBounds(int, int, int, int)に置き換えられました。
    void
    遅延自動レイアウトをサポートします。
    void
    scrollRectToVisible()メッセージをJComponentの親に転送します。
    final void
    ActionMapamに設定します。
    void
    setAlignmentX(float alignmentX)
    水平方向の位置合わせを設定します。
    void
    setAlignmentY(float alignmentY)
    垂直方向の位置合わせを設定します。
    void
    setAutoscrolls(boolean autoscrolls)
    autoscrollsプロパティを設定します。
    void
    このコンポーネントのバックグラウンド・カラーを設定します。
    void
    setBorder(Border border)
    このコンポーネントのボーダーを設定します。
    void
    このJComponentJPopupMenuを設定します。
    void
    setDebugGraphicsOptions(int debugOptions)
    このコンポーネント、またはその子のどれかで実行されるすべてのグラフィック操作についての診断情報を有効化または無効化します。
    static void
    各JComponentのロケール・プロパティを生成時に初期化するために使用するデフォルト・ロケールを設定します。
    void
    setDoubleBuffered(boolean aFlag)
    このコンポーネントがバッファを使用してペイントするかどうかを設定します。
    void
    setEnabled(boolean enabled)
    このコンポーネントが有効であるかどうかを設定します。
    void
    setFocusTraversalKeys(int id, Set<? extends AWTKeyStroke> keystrokes)
    このComponentの、指定されたトラバーサル操作のフォーカス・トラバーサル・キーを設定します。
    void
    setFont(Font font)
    このコンポーネントのフォントを設定します。
    void
    このコンポーネントのフォアグラウンド・カラーを設定します。
    void
    setInheritsPopupMenu(boolean value)
    このコンポーネントにJPopupMenuが割り当てられていない場合にgetComponentPopupMenuが親に委譲されるかどうかを設定します。
    final void
    setInputMap(int condition, InputMap map)
    条件conditionで使用するInputMapmapに設定します。
    void
    このコンポーネントの入力ベリファイアを設定します。
    void
    このコンポーネントの最大サイズを定数値に設定します。
    void
    このコンポーネントの最小サイズを定数値に設定します。
    void
    非推奨。
    1.4で、FocusTraversalPolicyに置き換えられます
    void
    setOpaque(boolean isOpaque)
    trueの場合、コンポーネントはその境界内のすべてのピクセルをペイントします。
    void
    setPreferredSize(Dimension preferredSize)
    このコンポーネントの適切なサイズを設定します。
    void
    setRequestFocusEnabled(boolean requestFocusEnabled)
    このJComponentがフォーカスを取得するかどうかについてのヒントを提供します。
    void
    ツールヒントに表示するテキストを登録します。
    void
    カット、コピー、ペーストおよびドラッグ・アンド・ドロップを使用した、このコンポーネントとのデータ転送をサポートするTransferHandlerを設定します。
    protected void
    このコンポーネントのルック・アンド・フィールの委譲を設定します。
    void
    setVerifyInputWhenFocusTarget(boolean verifyInputWhenFocusTarget)
    このコンポーネントがフォーカスを要求する前に、現在のフォーカスを持つコンポーネントに入力ベリファイアを呼び出すかどうかを示す値を設定します。
    void
    setVisible(boolean aFlag)
    コンポーネントを可視または不可視にします。
    void
    このメソッドは現在使われていません。
    void
    paintを呼び出します。

    Containerクラスで宣言されたメソッド

    add, add, add, add, add, addContainerListener, addImpl, 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, transferFocusDownCycle, validate, validateTree
    修飾子と型
    メソッド
    説明
    add(Component comp)
    指定されたコンポーネントをこのコンテナの最後に追加します。
    add(Component comp, int index)
    指定されたコンポーネントを、このコンテナの指定された位置に追加します。
    void
    add(Component comp, Object constraints)
    指定されたコンポーネントをこのコンテナの末尾に追加します。
    void
    add(Component comp, Object constraints, int index)
    指定されたコンポーネントを、指定されたインデックスと指定された制約で、コンテナへ追加します。
    add(String name, Component comp)
    指定されたコンポーネントをこのコンテナに追加します。
    void
    このコンテナからのコンテナ・イベントを受け取れるように、指定されたコンテナ・リスナーを追加します。
    protected void
    addImpl(Component comp, Object constraints, int index)
    指定されたコンポーネントを、指定されたインデックスで、コンテナへ追加します。
    void
    PropertyChangeListenerをリスナー・リストに追加します。
    void
    特定のプロパティのリスナー・リストにPropertyChangeListenerを追加します。
    void
    このコンテナと、その中に含まれているすべてのコンポーネントのComponentOrientationプロパティを設定します。
    boolean
    指定されたフォーカス・トラバーサル操作に対するフォーカス・トラバーサル・キーのセットが、このコンテナに明示的に定義されているかどうかを返します。
    int
    非推奨。
    JDKバージョン1.1で、getComponentCount()に置き換えられています。
    void
    非推奨。
    JDKバージョン1.1で、dispatchEvent(AWTEvent e)に置き換えられています
    void
    このコンテナによってコンポーネントが配置されます。
    findComponentAt(int x, int y)
    指定された位置を格納する可視の子コンポーネントを探します。
    指定された点を格納する可視の子コンポーネントを探します。
    getComponent(int n)
    コンテナ内のn番目のコンポーネントを取得します。
    getComponentAt(int x, int y)
    x、y座標を含むコンポーネントを探します。
    指定された点を含むコンポーネントを取得します。
    int
    このパネル内のコンポーネントの数を取得します。
    コンテナ内のすべてのコンポーネントを取得します。
    int
    コンテナ内のコンポーネントのZ軸順インデックスを返します。
    このコンテナに登録されているすべてのコンテナ・リスナーの配列を返します。
    このコンテナの指定されたトラバーサル操作のフォーカス・トラバーサル・キーのセットを返します。
    このContainerの子のキーボード・トラバーサルを管理するフォーカス・トラバーサル・ポリシーを返します。このContainerがフォーカス・サイクル・ルートでない場合はnullを返します。
    このコンテナのレイアウト・マネージャを取得します。
    getMousePosition(boolean allowChildren)
    nullがマウス・ポインタの下にある場合は、このContainerの座標空間内のマウス・ポインタの位置を返します。それ以外の場合はContainerを返します。
    非推奨。
    JDKバージョン1.1で、getInsets()に置き換えられています。
    void
    コンテナを無効にします。
    boolean
    コンポーネントがこのコンテナのコンポーネント階層に含まれているかどうかを判定します。
    boolean
    このコンテナがフォーカス・トラバーサル・サイクルのルートであるかどうかを返します。
    boolean
    指定されたコンテナが、このコンテナのフォーカス・トラバーサル・サイクルのフォーカス・サイクル・ルートであるかどうかを返します。
    final boolean
    このコンテナがフォーカス・トラバーサル・ポリシーを提供するかどうかを返します。
    boolean
    フォーカス・トラバーサル・ポリシーがこのコンテナに対して明示的に設定されているかどうかを返します。
    void
    非推奨。
    JDKバージョン1.1で、doLayout()に置き換えられています。
    void
    list(PrintStream out, int indent)
    指定された出力ストリームにこのコンテナの一覧を出力します。
    void
    list(PrintWriter out, int indent)
    指定されたインデント位置から、指定されたプリント・ライターに一覧を出力します。
    locate(int x, int y)
    非推奨。
    JDKバージョン1.1で、getComponentAt(int, int)に置き換えられています。
    非推奨。
    JDKバージョン1.1で、getMinimumSize()に置き換えられています。
    void
    このコンテナ内の各コンポーネントをペイントします。
    非推奨。
    JDKバージョン1.1で、getPreferredSize()に置き換えられています。
    void
    このコンテナ内の各コンポーネントを出力します。
    protected void
    このコンテナで発生するコンテナ・イベントを、登録されているContainerListenerオブジェクトにディスパッチすることで処理します。
    protected void
    このコンテナのイベントを処理します。
    void
    remove(int index)
    このコンテナから、indexによって指定されたコンポーネントを削除します。
    void
    このコンテナから、指定されたコンポーネントを削除します。
    void
    このコンテナからすべてのコンポーネントを削除します。
    void
    このコンテナからのコンテナ・イベントを受け取らないように、指定されたコンテナ・リスナーを削除します。
    void
    setComponentZOrder(Component comp, int index)
    指定されたコンポーネントを、コンテナの指定されたZ軸順のインデックスに移動します。
    void
    setFocusCycleRoot(boolean focusCycleRoot)
    このコンテナがフォーカス・トラバーサル・サイクルのルートであるかどうかを設定します。
    void
    このContainerがフォーカス・サイクル・ルートの場合、このContainerの子のキーボード・トラバーサルを管理するフォーカス・トラバーサル・ポリシーを設定します。
    final void
    このコンテナを使用して、フォーカス・トラバーサル・ポリシーを提供するかどうかを設定します。
    void
    このコンテナのレイアウト・マネージャを設定します。
    void
    フォーカスを1フォーカス・トラバーサル・サイクルだけ下位に移動します。
    void
    このコンテナおよびすべてのサブコンポーネントを検証します。
    protected void
    コンテナ・ツリーを再帰的に下位までたどり、必要であるとマークされたすべてのサブツリー、そして無効とマークされたすべてのサブツリーのレイアウトを再計算します。

    クラス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, 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, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, 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, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle
    修飾子と型
    メソッド
    説明
    boolean
    action(Event evt, Object what)
    非推奨。
    JDKバージョン1.1では、アクション・イベントを起動するコンポーネントに対して、このコンポーネントをActionListenerとして登録する必要があります。
    void
    add(PopupMenu popup)
    指定されたポップアップ・メニューをコンポーネントに追加します。
    void
    このコンポーネントからコンポーネント・イベントを受け取るために、指定されたコンポーネント・リスナーを追加します。
    void
    このコンポーネントが入力フォーカスを取得したときにこのコンポーネントからフォーカス・イベントを受け取るために、指定されたフォーカス・リスナーを追加します。
    void
    このコンテナが所属する階層が変更されたときに、このコンポーネントから階層境界イベントを受け取るために、指定された階層境界リスナーを追加します。
    void
    このコンテナが所属する階層が変更されたときにこのコンポーネントから階層変更イベントを受け取るために、指定された階層リスナーを追加します。
    void
    このコンポーネントからインプット・メソッド・イベントを受け取るために、指定されたインプット・メソッド・リスナーを追加します。
    void
    このコンポーネントからキー・イベントを受け取るために、指定されたキー・リスナーを追加します。
    void
    このコンポーネントからマウス・イベントを受け取るために、指定されたマウス・リスナーを追加します。
    void
    このコンポーネントからマウス・モーション・イベントを受け取るために、指定されたマウス・モーション・リスナーを追加します。
    void
    このコンポーネントからマウス・ホイール・イベントを受け取るために、指定されたマウス・ホイール・リスナーを追加します。
    非推奨。
    JDKバージョン1.1で、getBounds()に置き換えられています。
    int
    checkImage(Image image, int width, int height, ImageObserver observer)
    指定されたイメージの画面表現の構築ステータスを返します。
    int
    checkImage(Image image, ImageObserver observer)
    指定されたイメージの画面表現の構築ステータスを返します。
    protected AWTEvent
    coalesceEvents(AWTEvent existingEvent, AWTEvent newEvent)
    必要に応じて、送信されるイベントと既存のイベントを合体させます。
    boolean
    このコンポーネントに、指定された点が「含まれている」かどうかをチェックします。ここで、この点のxおよびy座標は、このコンポーネントの座標系を基準にして定義されます。
    createImage(int width, int height)
    ダブル・バッファリングのために使用されるオフスクリーン描画イメージを生成します。
    指定されたイメージ・プロデューサからイメージを生成します。
    createVolatileImage(int width, int height)
    ダブル・バッファリングのために使用される揮発性オフスクリーン描画イメージを生成します。
    createVolatileImage(int width, int height, ImageCapabilities caps)
    指定された機能で、揮発性オフスクリーン描画イメージを作成します。
    protected final void
    disableEvents(long eventsToDisable)
    指定されたイベント・マスク・パラメータによって定義されたイベントについて、このコンポーネントへの送信を不可能にします。
    final void
    このコンポーネントまたはそのサブコンポーネントの1つにイベントをディスパッチします。
    void
    enable(boolean b)
    非推奨。
    JDKバージョン1.1で、setEnabled(boolean)に置き換えられています。
    protected final void
    enableEvents(long eventsToEnable)
    指定されたイベント・マスク・パラメータによって定義されたイベントについて、このコンポーネントへの送信を使用可能にします。
    void
    enableInputMethods(boolean enable)
    このコンポーネントのインプット・メソッド・サポートを使用可能または使用不可にします。
    void
    firePropertyChange(String propertyName, byte oldValue, byte newValue)
    バウンド・プロパティの変更を通知します。
    void
    firePropertyChange(String propertyName, char oldValue, char newValue)
    バウンド・プロパティの変更を通知します。
    void
    firePropertyChange(String propertyName, double oldValue, double newValue)
    バウンド・プロパティの変更を通知します。
    void
    firePropertyChange(String propertyName, float oldValue, float newValue)
    バウンド・プロパティの変更を通知します。
    void
    firePropertyChange(String propertyName, long oldValue, long newValue)
    バウンド・プロパティの変更を通知します。
    void
    firePropertyChange(String propertyName, short oldValue, short newValue)
    バウンド・プロパティの変更を通知します。
    protected void
    firePropertyChange(String propertyName, Object oldValue, Object newValue)
    Objectプロパティに対するバウンド・プロパティの変更の報告をサポートします。
    このコンポーネントのバックグラウンド・カラーを取得します。
    このコンポーネントの境界をRectangleオブジェクトの形式で取得します。
    コンポーネントを出力デバイス上に表示するために使用されるColorModelのインスタンスを取得します。
    このコンポーネントに登録されたすべてのコンポーネント・リスナーの配列を返します。
    このコンポーネント内の要素またはテキストを整列するために使用する、言語に依存する方向を取得します。
    コンポーネントのカーソル・セットを取得します。
    このComponentに関連付けられているDropTargetを取得します。
    このComponentのフォーカス・トラバーサル・サイクルのフォーカス・サイクル・ルートであるContainerを返します。
    このコンポーネントに登録されたすべてのフォーカス・リスナーの配列を返します。
    boolean
    このコンポーネントに対してフォーカス・トラバーサル・キーが使用できるかどうかを返します。
    このコンポーネントのフォントを取得します。
    このコンポーネントのフォアグラウンド・カラーを取得します。
    このComponentに関連付けられたGraphicsConfigurationを取得します。
    このコンポーネントに登録されているすべての階層境界リスナーの配列を返します。
    このコンポーネントに登録されているすべての階層リスナーの配列を返します。
    boolean
    オペレーティング・システムから受信したペイント・メッセージを無視するかどうかを返します。
    テキストがこのコンポーネントに入力されたときに、インプット・メソッドとの通信を処理するためにこのコンポーネントによって使用される入力コンテキストを取得します。
    このコンポーネントに登録されているすべてのインプット・メソッド・リスナーの配列を返します。
    このコンポーネントのインプット・メソッドからの要求をサポートするインプット・メソッド要求ハンドラを取得します。
    このコンポーネントに登録されているすべてのキー・リスナーの配列を返します。
    このコンポーネントのロケールを取得します。
    このコンポーネントの位置を、コンポーネントの左上隅を指定する点の形式で取得します。
    このコンポーネントの位置を、画面の座標空間でのコンポーネントの左上隅を指定する点の形式で取得します。
    このコンポーネントに登録されたすべてのマウス・リスナーの配列を返します。
    このコンポーネントに登録されたすべてのマウス・モーション・リスナーの配列を返します。
    Componentがマウス・ポインタの直下にある場合は、このComponentの座標空間内のマウス・ポインタの位置を返します。それ以外の場合はnullを返します。
    このコンポーネントに登録されたすべてのマウス・ホイール・リスナーの配列を返します。
    コンポーネントの名前を取得します。
    このコンポーネントの親を取得します。
    このコンポーネントに登録されているすべてのプロパティ変更リスナーの配列を返します。
    指定されたプロパティに関連付けられているすべてのリスナーの配列を返します。
    このコンポーネントのサイズをDimensionオブジェクトの形式で返します。
    このコンポーネントのツールキットを返します。
    final Object
    AWTコンポーネント・ツリーおよびレイアウト操作に対する、このコンポーネントのロック・オブジェクト(スレッド同期化モニターを所有するオブジェクト)を取得します。
    boolean
    gotFocus(Event evt, Object what)
    非推奨。
    JDKバージョン1.1で、processFocusEvent(FocusEvent)に置き換えられています。
    boolean
    非推奨。
    JDKバージョン1.1で、processEvent(AWTEvent)に置き換えられています。
    boolean
    このComponentがフォーカス所有者である場合はtrueを返します。
    boolean
    imageUpdate(Image img, int infoflags, int x, int y, int w, int h)
    イメージが変更されたときにコンポーネントをふたたびペイントします。
    boolean
    inside(int x, int y)
    非推奨。
    JDKバージョン1.1で、contains(int, int)に置き換えられています。
    boolean
    バックグラウンド・カラーがこのコンポーネントに対して明示的に設定されているかどうかを返します。
    boolean
    カーソルがこのコンポーネントに対して明示的に設定されているかどうかを返します。
    boolean
    このコンポーネントが表示可能かどうかを判定します。
    boolean
    このコンポーネントが使用可能であるかどうかを判定します。
    boolean
    このコンポーネントにフォーカスが設定可能かどうかを返します。
    boolean
    このComponentがフォーカス所有者である場合はtrueを返します。
    boolean
    非推奨。
    1.4で、isFocusable()に置き換えられます。
    boolean
    フォントがこのコンポーネントに対して明示的に設定されているかどうかを返します。
    boolean
    フォアグラウンド・カラーがこのコンポーネントに対して明示的に設定されているかどうかを返します。
    boolean
    軽量コンポーネントはネイティブなツールキットのピアを持ちません。
    boolean
    最大サイズがnull以外の値に設定されている場合はtrueを返します。それ以外の場合はfalseを返します。
    boolean
    setMinimumSizeがnull以外の値を使用して呼び出されたかどうかを返します。
    boolean
    優先サイズがnull以外の値に設定されている場合はtrueを返します。それ以外の場合はfalseを返します。
    boolean
    このコンポーネントが画面に表示されているかどうかを判定します。
    boolean
    このコンポーネントが有効であるかどうかを判定します。
    boolean
    親が可視になったときにこのコンポーネントが可視になるかどうかを判定します。
    boolean
    keyDown(Event evt, int key)
    非推奨。
    JDKバージョン1.1で、processKeyEvent(KeyEvent)に置き換えられています。
    boolean
    keyUp(Event evt, int key)
    非推奨。
    JDKバージョン1.1で、processKeyEvent(KeyEvent)に置き換えられています。
    void
    このコンポーネントの一覧を標準のシステム出力ストリームSystem.outに出力します。
    void
    指定された出力ストリームにこのコンポーネントの一覧を出力します。
    void
    指定されたプリント・ライターに一覧を出力します。
    非推奨。
    JDKバージョン1.1で、getLocation()に置き換えられています。
    boolean
    lostFocus(Event evt, Object what)
    非推奨。
    JDKバージョン1.1で、processFocusEvent(FocusEvent)に置き換えられています。
    boolean
    mouseDown(Event evt, int x, int y)
    非推奨。
    JDKバージョン1.1で、processMouseEvent(MouseEvent)に置き換えられています。
    boolean
    mouseDrag(Event evt, int x, int y)
    非推奨。
    JDKバージョン1.1で、processMouseMotionEvent(MouseEvent)に置き換えられています。
    boolean
    mouseEnter(Event evt, int x, int y)
    非推奨。
    JDKバージョン1.1で、processMouseEvent(MouseEvent)に置き換えられています。
    boolean
    mouseExit(Event evt, int x, int y)
    非推奨。
    JDKバージョン1.1で、processMouseEvent(MouseEvent)に置き換えられています。
    boolean
    mouseMove(Event evt, int x, int y)
    非推奨。
    JDKバージョン1.1で、processMouseMotionEvent(MouseEvent)に置き換えられています。
    boolean
    mouseUp(Event evt, int x, int y)
    非推奨。
    JDKバージョン1.1で、processMouseEvent(MouseEvent)に置き換えられています。
    void
    move(int x, int y)
    非推奨。
    JDKバージョン1.1で、setLocation(int, int)に置き換えられています。
    void
    非推奨。
    JDKバージョン1.1で、transferFocus()に置き換えられています。
    void
    このコンポーネントおよびそのすべてのサブコンポーネントをペイントします。
    boolean
    非推奨。
    JDKバージョン1.1で、dispatchEvent(AWTEvent)に置き換えられています。
    boolean
    prepareImage(Image image, int width, int height, ImageObserver observer)
    このコンポーネント上に描画するための、指定された幅と高さのイメージを準備します。
    boolean
    prepareImage(Image image, ImageObserver observer)
    このコンポーネント上に描画するためのイメージを準備します。
    protected void
    このコンポーネントで発生するコンポーネント・イベントを、登録されているComponentListenerオブジェクトにディスパッチすることによって処理します。
    protected void
    このコンポーネントで発生するフォーカス・イベントを、登録されているFocusListenerオブジェクトにディスパッチすることによって処理します。
    protected void
    このコンポーネントで発生する階層境界イベントを、登録されているHierarchyBoundsListenerオブジェクトにディスパッチすることによって処理します。
    protected void
    このコンポーネントで発生する階層イベントを、登録されているHierarchyListenerオブジェクトにディスパッチすることによって処理します。
    protected void
    このコンポーネントで発生するインプット・メソッド・イベントを、登録されているInputMethodListenerオブジェクトにディスパッチすることによって処理します。
    protected void
    このコンポーネントで発生するマウス・ホイール・イベントを、登録されているMouseWheelListenerオブジェクトにディスパッチすることによって処理します。
    void
    指定されたポップアップ・メニューをコンポーネントから削除します。
    void
    以降このコンポーネントからコンポーネント・イベントを受け取らないように、指定されたコンポーネント・リスナーを削除します。
    void
    以降このコンポーネントからフォーカス・イベントを受け取らないように、指定されたフォーカス・リスナーを削除します。
    void
    以降このコンポーネントから階層境界イベントを受け取らないように、指定された階層境界リスナーを削除します。
    void
    以降このコンポーネントから階層変更イベントを受け取らないように、指定された階層リスナーを削除します。
    void
    以降このコンポーネントからインプット・メソッド・イベントを受け取らないように、指定されたインプット・メソッド・リスナーを削除します。
    void
    以降このコンポーネントからキー・イベントを受け取らないように、指定されたキー・リスナーを削除します。
    void
    以降このコンポーネントからマウス・イベントを受け取らないように、指定されたマウス・リスナーを削除します。
    void
    以降このコンポーネントからマウス・モーション・イベントを受け取らないように、指定されたマウス・モーション・リスナーを削除します。
    void
    以降このコンポーネントからマウス・ホイール・イベントを受け取らないように、指定されたマウス・ホイール・リスナーを削除します。
    void
    PropertyChangeListenerをリスナー・リストから削除します。
    void
    特定のプロパティのリスナー・リストからPropertyChangeListenerを削除します。
    void
    このコンポーネントをふたたびペイントします。
    void
    repaint(int x, int y, int width, int height)
    このコンポーネントの指定された矩形をふたたびペイントします。
    void
    repaint(long tm)
    このコンポーネントをふたたびペイントします。
    protected boolean
    requestFocus(boolean temporary, FocusEvent.Cause cause)
    このComponentが入力フォーカスを取得し、このComponentの最上位の祖先がフォーカスされたWindowになるというcauseの理由によるリクエスト。
    void
    このコンポーネントによって入力フォーカスが取得され、このコンポーネントの最上位の祖先がフォーカスされたウィンドウになるというcauseの理由によるリクエスト。
    boolean
    このコンポーネントの最上位の祖先がすでにフォーカスされたウィンドウである場合、このコンポーネントに入力フォーカスを取得するcauseの理由によるリクエスト。
    void
    resize(int width, int height)
    非推奨。
    JDKバージョン1.1で、setSize(int, int)に置き換えられています。
    void
    非推奨。
    JDKバージョン1.1で、setSize(Dimension)に置き換えられています。
    void
    setBounds(int x, int y, int width, int height)
    このコンポーネントを移動し、サイズ変更します。
    void
    新しい境界の矩形rに適合するように、このコンポーネントを移動し、サイズ変更します。
    void
    このコンポーネント内の要素またはテキストを整列するために使用する、言語に依存する方向を設定します。
    void
    setCursor(Cursor cursor)
    カーソル・イメージを指定されたカーソルに設定します。
    void
    DropTargetをこのコンポーネントに関連付けます。
    void
    setFocusable(boolean focusable)
    このコンポーネントのフォーカス可能性を指定された値に設定します。
    void
    setFocusTraversalKeysEnabled(boolean focusTraversalKeysEnabled)
    このコンポーネントに対してフォーカス・トラバーサル・キーが使用できるかどうかを設定します。
    void
    setIgnoreRepaint(boolean ignoreRepaint)
    オペレーティング・システムからの、ペイントについてのメッセージを無視するかどうかを設定します。
    void
    このコンポーネントのロケールを設定します。
    void
    setLocation(int x, int y)
    このコンポーネントを新しい位置に移動します。
    void
    このコンポーネントを新しい位置に移動します。
    void
    この軽量コンポーネントに「ミックス・カット・アウト」シェイプを設定します。
    void
    コンポーネントの名前を、指定された文字列に設定します。
    void
    setSize(int width, int height)
    幅がwidthで、高さがheightになるように、このコンポーネントのサイズを変更します。
    void
    幅がd.widthで、高さがd.heightになるように、このコンポーネントのサイズを変更します。
    void
    非推奨。
    JDKバージョン1.1で、setVisible(boolean)に置き換えられています。
    void
    show(boolean b)
    非推奨。
    JDKバージョン1.1で、setVisible(boolean)に置き換えられています。
    非推奨。
    JDKバージョン1.1で、getSize()に置き換えられています。
    このコンポーネントおよびその値の文字列表現を返します。
    void
    このコンポーネントがフォーカス所有者であるかのように、フォーカスを次のコンポーネントに転送します。
    void
    このコンポーネントがフォーカス所有者であるかのように、フォーカスを前のコンポーネントに転送します。
    void
    フォーカスを1フォーカス・トラバーサル・サイクルだけ上位に移動します。

    クラスオブジェクトで宣言されたメソッド

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
    修飾子と型
    メソッド
    説明
    protected Object
    このオブジェクトのコピーを作成して、返します。
    boolean
    このオブジェクトと他のオブジェクトが等しいかどうかを示します。
    protected void
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    最終決定は非推奨であり、将来のリリースで削除される可能性があります。
    final Class<?>
    このObjectの実行時クラスを返します。
    int
    このオブジェクトに対するハッシュ・コード値を返します。
    final void
    このオブジェクトのモニターで待機中のスレッドを1つ再開します。
    final void
    このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
    final void
    現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
    final void
    wait(long timeoutMillis)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
    final void
    wait(long timeoutMillis, int nanos)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
  • フィールド詳細

    • VERTICAL

      public static final int VERTICAL
      セルを垂直方向に1列に並べたレイアウト(デフォルト)を示します。
      導入されたバージョン:
      1.4
      関連項目:
    • VERTICAL_WRAP

      public static final int VERTICAL_WRAP
      セルが垂直方向の次に水平方向の順で並ぶ「ニュースペーパー・スタイル」レイアウトを示します。
      導入されたバージョン:
      1.4
      関連項目:
    • HORIZONTAL_WRAP

      public static final int HORIZONTAL_WRAP
      セルが水平方向の次に垂直方向の順で並ぶ「ニュースペーパー・スタイル」レイアウトを示します。
      導入されたバージョン:
      1.4
      関連項目:
  • コンストラクタの詳細

    • JList

      public JList(ListModel<E> dataModel)
      指定されたnull以外のモデルの要素を表示するJListを構築します。 すべてのJListコンストラクタは、このオブジェクトに委譲します。

      このコンストラクタは、ToolTipManagerにリストを登録することにより、セル・レンダリングのツールヒントが提供されるようにします。

      パラメータ:
      dataModel - リストのモデル
      スロー:
      IllegalArgumentException - モデルがnullの場合
    • JList

      public JList(E[] listData)
      指定された配列の要素を表示するJListを構築します。 このコンストラクタは、指定された配列の読取り専用モデルを作成し、ListModelをとるコンストラクタに委譲します。

      このメソッドにnull値を渡そうとすると未定義の動作が発生し、さらに多くの場合は例外が発生します。 作成されたモデルは、指定された配列を直接参照します。 リストの作成後に配列を変更しようとすると、不確定な動作が生じます。

      パラメータ:
      listData - データ・モデルにロードされるObjectの配列(null以外)
    • JList

      public JList(Vector<? extends E> listData)
      指定されたVectorの要素を表示するJListを構築します。 このコンストラクタは、指定されたVectorの読取り専用モデルを作成し、ListModelをとるコンストラクタに委譲します。

      このメソッドにnull値を渡そうとすると未定義の動作が発生し、さらに多くの場合は例外が発生します。 作成されたモデルは、指定されたVectorを直接参照します。 リストの作成後にVectorを変更しようとすると、不確定な動作が生じます。

      パラメータ:
      listData - データ・モデルにロードされるVectornon-null
    • JList

      public JList()
      空の読取り専用モデルでJListを構築します。
  • メソッドの詳細

    • getUI

      public ListUI getUI()
      このコンポーネントをレンダリングするルック・アンド・フィールオブジェクトのListUIを返します。
      オーバーライド:
      クラスJComponentgetUI
      戻り値:
      このコンポーネントをレンダリングするListUIオブジェクト
    • setUI

      @BeanProperty(hidden=true, visualUpdate=true, description="The UI object that implements the Component's LookAndFeel.") public void setUI(ListUI ui)
      このコンポーネントをレンダリングするルック・アンド・フィールオブジェクトのListUIを設定します。
      パラメータ:
      ui - ListUIオブジェクト
      関連項目:
    • updateUI

      public void updateUI()
      ListUIプロパティに現在のルック・アンド・フィールが提供する値を設定することにより、このプロパティをリセットします。 現在のセル・レンダリングがルック・アンド・フィールによってではなく開発者によってインストールされたものである場合、この処理を実行すると、SwingUtilities.updateComponentTreeUIが呼び出されて、セル・レンダリングとその子が更新されます。
      オーバーライド:
      updateUI、クラスJComponent
      関連項目:
    • getUIClassID

      @BeanProperty(bound=false) public String getUIClassID()
      このコンポーネントのルック・アンド・フィールを定義するjavax.swing.plaf.ListUIクラスの名前を検索するために使用するUIDefaultsキー、"ListUI"を返します。
      オーバーライド:
      getUIClassID、クラスJComponent
      戻り値:
      文字列「ListUI」
      関連項目:
    • getPrototypeCellValue

      public E getPrototypeCellValue()
      セルの固定幅と固定の高さを計算するために使用する値、「プロトタイプ」セル値を返します。 このような値が存在しない場合は、nullが返される可能性があります。
      戻り値:
      prototypeCellValueプロパティの値
      関連項目:
    • setPrototypeCellValue

      @BeanProperty(visualUpdate=true, description="The cell prototype value, used to compute cell width and height.") public void setPrototypeCellValue(E prototypeCellValue)
      prototypeCellValueプロパティを設定し、新しい値がnon-nullである場合は、セル・レンダリング・コンポーネントにセル・レンダラからの指定の値(およびインデックス0)を要求し、このコンポーネントの推奨サイズを使用して、fixedCellWidthプロパティとfixedCellHeightプロパティを計算します。

      リストが長すぎてListUIが各セルの幅と高さを計算できず、ほかのセルと同じスペースを占有することがわかっているセル値(プロトタイプ)がある場合には、このメソッドが便利です。

      prototypeCellValuefixedCellHeightfixedCellWidthの3つのプロパティはすべてこのメソッドで変更できますが、PropertyChangeEvent通知が送信されるのは、prototypeCellValueプロパティが変更された場合にかぎられます。

      このプロパティの設定例を参照するには、上記のクラスの説明を参照してください。

      このプロパティのデフォルト値はnullです。

      これはJavaBeansバウンド・プロパティです。

      パラメータ:
      prototypeCellValue - fixedCellWidthおよびfixedCellHeightのベースとなる値
      関連項目:
    • getFixedCellWidth

      public int getFixedCellWidth()
      fixedCellWidthプロパティの値を返します。
      戻り値:
      固定セル幅
      関連項目:
    • setFixedCellWidth

      @BeanProperty(visualUpdate=true, description="Defines a fixed cell width when greater than zero.") public void setFixedCellWidth(int width)
      リストに含まれるすべてのセルの幅として使用する固定値を設定します。 widthが -1の場合、リストの各要素のセル・レンダリング・コンポーネントにgetPreferredSizeを適用することにより、ListUIでセルの幅が計算されます。

      このプロパティのデフォルト値は-1です。

      これはJavaBeansバウンド・プロパティです。

      パラメータ:
      width - リスト内のすべてのセルの幅
      関連項目:
    • getFixedCellHeight

      public int getFixedCellHeight()
      fixedCellHeightプロパティの値を返します。
      戻り値:
      固定セル高
      関連項目:
    • setFixedCellHeight

      @BeanProperty(visualUpdate=true, description="Defines a fixed cell height when greater than zero.") public void setFixedCellHeight(int height)
      リストに含まれるすべてのセルの高さとして使用する固定値を設定します。 heightが -1の場合、リストの各要素のセル・レンダリング・コンポーネントにgetPreferredSizeを適用することにより、ListUIでセルの高さが計算されます。

      このプロパティのデフォルト値は-1です。

      これはJavaBeansバウンド・プロパティです。

      パラメータ:
      height - リスト内のすべてのセルに使用される高さ
      関連項目:
    • getCellRenderer

      public ListCellRenderer<? super E> getCellRenderer()
      リスト項目をペイントするオブジェクトを返します。
      戻り値:
      cellRendererプロパティの値
      関連項目:
    • setCellRenderer

      @BeanProperty(visualUpdate=true, description="The component used to draw the cells.") public void setCellRenderer(ListCellRenderer<? super E> cellRenderer)
      リスト内の各セルをペイントするために使用される委譲を設定します。 セル・レンダリングのジョブについては、クラス・レベルのドキュメントで詳しく説明します。

      prototypeCellValueプロパティがnon-nullである場合は、セル・レンダリングを設定すると、fixedCellWidthプロパティとfixedCellHeightプロパティが再計算されます。 しかし、cellRendererプロパティに対してはPropertyChangeEventは1つだけ生成されます。

      このプロパティのデフォルト値はListUI委譲(ルック・アンド・フィールの実装)によって提供されます。

      これはJavaBeansバウンド・プロパティです。

      パラメータ:
      cellRenderer - リストのセルをペイントするListCellRenderer
      関連項目:
    • getSelectionForeground

      public Color getSelectionForeground()
      選択された項目のフォアグラウンドの描画に使用する色を返します。 大多数のListUI実装によってインストールされたレンダリングと同様に、DefaultListCellRendererは、この色を使って、選択されている項目のフォアグラウンドをレンダリングします。
      戻り値:
      選択された項目のフォアグラウンドを描画する色
      関連項目:
    • setSelectionForeground

      @BeanProperty(visualUpdate=true, description="The foreground color of selected cells.") public void setSelectionForeground(Color selectionForeground)
      選択された項目のフォアグラウンドのレンダリングに使用する色(セル・レンダリングがテキストとグラフィックスのレンダリングに使用できる色)を設定します。 大多数のListUI実装によってインストールされたレンダリングと同様に、DefaultListCellRendererは、この色を使って、選択されている項目のフォアグラウンドをレンダリングします。

      このプロパティのデフォルト値は、ルック・アンド・フィールの実装によって定義されます。

      これはJavaBeansバウンド・プロパティです。

      パラメータ:
      selectionForeground - 選択されたリスト項目のフォアグラウンドで使用するColor
      関連項目:
    • getSelectionBackground

      public Color getSelectionBackground()
      選択された項目のバックグラウンドの描画に使用する色を返します。 大多数のListUI実装によってインストールされたレンダリングと同様に、DefaultListCellRendererは、この色を使って、選択されている項目のバックグラウンドをレンダリングします。
      戻り値:
      選択された項目のバックグラウンドを描画する色
      関連項目:
    • setSelectionBackground

      @BeanProperty(visualUpdate=true, description="The background color of selected cells.") public void setSelectionBackground(Color selectionBackground)
      選択された項目のバックグラウンドのレンダリングに使用する色(セル・レンダリングが選択したセルの塗りつぶしに使用できる色)を設定します。 大多数のListUI実装によってインストールされたレンダリングと同様に、DefaultListCellRendererは、この色を使って、選択されている項目のバックグラウンドを塗りつぶします。

      このプロパティのデフォルト値は、ルック・アンド・フィールの実装によって定義されます。

      これはJavaBeansバウンド・プロパティです。

      パラメータ:
      selectionBackground - 選択されたセルのバックグラウンドで使用するColor
      関連項目:
    • getVisibleRowCount

      public int getVisibleRowCount()
      visibleRowCountプロパティの値を返します。 この値の解釈方法の詳細については、setVisibleRowCount(int)のドキュメントを参照してください。
      戻り値:
      visibleRowCountプロパティの値。
      関連項目:
    • setVisibleRowCount

      @BeanProperty(visualUpdate=true, description="The preferred number of rows to display without requiring scrolling") public void setVisibleRowCount(int visibleRowCount)
      visibleRowCountプロパティ(レイアウト方向によって意味が異なる)を設定します。レイアウト方向がVERTICALの場合、スクロールしないで表示できる適切な行数が設定されます。これ以外の方向の場合、セルの折返しに影響があります。

      VERTICAL方向の場合:
      このプロパティを設定すると、囲み側のビュー・ポートの推奨サイズの計算に使用される、getPreferredScrollableViewportSize()メソッドの戻り値に影響があります。
      詳細は、該当メソッドのドキュメントを参照してください。

      HORIZONTAL_WRAP方向またはVERTICAL_WRAP方向の場合:
      セルの折返しの方法に影響があります。
      詳細は、setLayoutOrientation(int)のドキュメントを参照してください。

      このプロパティのデフォルト値は8です。

      負の値を指定してこのメソッドを呼び出した場合、プロパティが0に設定されます。

      これはJavaBeansバウンド・プロパティです。

      パラメータ:
      visibleRowCount - スクロールしないで表示できる適切な行数を指定する整数
      関連項目:
    • getLayoutOrientation

      public int getLayoutOrientation()
      リストのレイアウト方向のプロパティを返します。レイアウトがセルの単一の列の場合はVERTICAL、コンテンツが垂直方向の次に水平方向の順に並ぶ「ニュースペーパー・スタイル」の場合はVERTICAL_WRAP、コンテンツが水平方向の次に垂直方向の順に並ぶ「ニュースペーパー・スタイル」の場合はHORIZONTAL_WRAPを返します。
      戻り値:
      layoutOrientationプロパティの値
      導入されたバージョン:
      1.4
      関連項目:
    • setLayoutOrientation

      @BeanProperty(visualUpdate=true, enumerationValues={"JList.VERTICAL","JList.HORIZONTAL_WRAP","JList.VERTICAL_WRAP"}, description="Defines the way list cells are laid out.") public void setLayoutOrientation(int layoutOrientation)
      リスト・セルのレイアウト方法を定義します。 5つのセルから成るJListがあるとします。 セルは、次のいずれかの方法で配置できます:
      VERTICAL:          0
                         1
                         2
                         3
                         4
      
      HORIZONTAL_WRAP:   0  1  2
                         3  4
      
      VERTICAL_WRAP:     0  3
                         1  4
                         2
      

      これらのレイアウトの説明は、次のとおりです。

      VERTICAL、HORIZONTAL_WRAP、およびVERTICAL_WRAPのレイアウトについて説明
      説明
      VERTICAL セルは1つの列に垂直に配置されます。
      HORIZONTAL_WRAP セルは水平に配置され、必要に応じて新しい行に折り返されます。 visibleRowCountプロパティの値がゼロ以下である場合、折返しはリストの幅によって決定されます。それ以外の場合は、リスト内にvisibleRowCount行が確保されるように折返しが行われます。
      VERTICAL_WRAP セルは垂直に配置され、必要に応じて新しい列に折り返されます。 visibleRowCountプロパティの値がゼロ以下である場合、折返しはリストの高さによって決定されます。それ以外の場合は、visibleRowCount行で折返しが行われます。
      このプロパティのデフォルト値はVERTICALです。

      パラメータ:
      layoutOrientation - 新しいレイアウト方向。VERTICALHORIZONTAL_WRAP、またはVERTICAL_WRAPのどれか
      スロー:
      IllegalArgumentException - layoutOrientationが許容値のどれでもない場合
      導入されたバージョン:
      1.4
      関連項目:
    • getFirstVisibleIndex

      @BeanProperty(bound=false) public int getFirstVisibleIndex()
      現在表示されている最小のリスト・インデックスを返します。 componentOrientationが左から右である場合、最初の可視セルはリストの左上隅にもっとも近い位置に見つかります。 右から左である場合、最初の可視セルはリストの右上隅にもっとも近い位置に見つかります。 どのセルも可視ではない場合やリストが空である場合には-1を返します。 返されたセルは部分的に可視でもかまいません。
      戻り値:
      最初の可視セルのインデックス
      関連項目:
    • getLastVisibleIndex

      @BeanProperty(bound=false) public int getLastVisibleIndex()
      現在表示されている最大のリスト・インデックスを返します。 どのセルも可視ではない場合やリストが空である場合には-1を返します。 返されたセルは部分的に可視でもかまいません。
      戻り値:
      最後の可視セルのインデックス
      関連項目:
    • ensureIndexIsVisible

      public void ensureIndexIsVisible(int index)
      囲み側のビュー・ポート内のリストをスクロールし、指定されたセルを完全に可視にします。 これは、指定されたセルの境界を引数にして、scrollRectToVisibleを呼びます。 このメソッドが動作するには、JListJViewport内に存在する必要があります。

      指定されたインデックスがリストのセルの範囲外にある場合、このメソッドは何も行いません。

      パラメータ:
      index - 可視にするセルのインデックス
      関連項目:
    • setDragEnabled

      @BeanProperty(bound=false, description="determines whether automatic drag handling is enabled") public void setDragEnabled(boolean b)
      自動ドラッグ処理をオンまたはオフにします。 自動ドラッグ処理を有効にするには、このプロパティの値をtrueに設定し、リストのTransferHandlerの値をnon-nullにしてください。 dragEnabledプロパティのデフォルト値はfalseです。

      このプロパティを受け入れ、ユーザーのドラッグ・ジェスチャを認識する処理は、ルック・アンド・フィール実装(特にリストのListUI)によって行われます。 自動ドラッグ処理が有効である場合、ほとんどのルック・アンド・フィール (BasicLookAndFeelのサブクラスのルック・アンド・フィールを含む)は、ユーザーが項目の上でマウス・ボタンを押し、マウスを数ピクセル移動すると、ドラッグ・アンド・ドロップ操作を開始します。 したがって、このプロパティをtrueに設定すると、選択の動作に微妙に影響する場合があります。

      このプロパティを無視するようなルック・アンド・フィールを使用している場合も、リストのTransferHandler上でexportAsDragを呼び出すことにより、ドラッグ・アンド・ドロップ操作を開始できます。

      パラメータ:
      b - 自動ドラッグ処理を有効にするかどうか
      スロー:
      HeadlessException - btrueで、GraphicsEnvironment.isHeadless()trueを返す場合
      導入されたバージョン:
      1.4
      関連項目:
    • getDragEnabled

      public boolean getDragEnabled()
      自動ドラッグ処理が有効であるかどうかを返します。
      戻り値:
      dragEnabledプロパティの値
      導入されたバージョン:
      1.4
      関連項目:
    • setDropMode

      public final void setDropMode(DropMode dropMode)
      このコンポーネントのドロップ・モードを設定します。 下位互換性を確保するため、このプロパティのデフォルト値はDropMode.USE_SELECTIONになっています。 ただし、ユーザー側の操作を改善する場合は、ほかのモードを使用することをお勧めします。 たとえば、DropMode.ONは、リスト内の実際の選択内容に影響を及ぼすことなく、選択されたように項目を表示する動作と似た動作を提供します。

      JListは次のドロップ・モードをサポートしています。

      • DropMode.USE_SELECTION
      • DropMode.ON
      • DropMode.INSERT
      • DropMode.ON_OR_INSERT
      このコンポーネントがドロップを受け付けるTransferHandlerを持っていなければ、ドロップ・モードの効果はありません。

      パラメータ:
      dropMode - 使用するドロップ・モード
      スロー:
      IllegalArgumentException - ドロップ・モードがサポートされていないかnullの場合
      導入されたバージョン:
      1.6
      関連項目:
    • getDropMode

      public final DropMode getDropMode()
      このコンポーネントのドロップ・モードを返します。
      戻り値:
      このコンポーネントのドロップ・モード
      導入されたバージョン:
      1.6
      関連項目:
    • getDropLocation

      @BeanProperty(bound=false) public final JList.DropLocation getDropLocation()
      このコンポーネントがコンポーネントのドラッグ・アンド・ドロップ時にドロップ位置として視覚的に示す位置を返します。現在位置が表示されていない場合はnullを返します。

      このメソッドは、TransferHandlerからドロップ位置を照会する手段にはなりません。ドロップ位置は、TransferHandlercanImportが返され、ドロップ位置を表示する準備ができてから設定されるためです。

      このプロパティが変更されると、コンポーネントにより、プロパティ変更イベントdropLocationがトリガーされます。

      デフォルトでは、このプロパティに対する変更を待機し、ドロップ位置を視覚的に示す処理は、リストのListUIが行います。これは、ドロップ位置を直接ペイントするか、セル・レンダラをインストールしてこの処理を行わせるか、またはその両方の処理を行う可能性があります。 カスタム・ドロップ位置のペイントを実装するか、デフォルトのセル・レンダラを置き換えるか、またはその両方の処理を行う開発者は、このプロパティを考慮する必要がある場合があります。

      戻り値:
      ドロップ位置
      導入されたバージョン:
      1.6
      関連項目:
    • getNextMatch

      public int getNextMatch(String prefix, int startIndex, Position.Bias bias)
      指定された接頭辞で始まる、toString値を持つ次のリスト要素を返します。
      パラメータ:
      prefix - 一致をテストする文字列
      startIndex - 検索を開始するインデックス
      bias - 検索方向。Position.Bias.Forward、またはPosition.Bias.Backward。
      戻り値:
      接頭辞で始まる、次のリスト要素のインデックス。そうでない場合は-1
      スロー:
      IllegalArgumentException - 接頭辞がnullまたはstartIndexが範囲外にある場合
      導入されたバージョン:
      1.4
    • getToolTipText

      public String getToolTipText(MouseEvent event)
      指定されたイベントで使用されるツールヒント・テキストを返します。 これは、JComponentgetToolTipTextをオーバーライドして、まずイベントが発生したセルのセル・レンダリング・コンポーネントをチェックし、ツールヒント・テキストがあれば、それを返します。 この実装では、セル・レンダリング・コンポーネントに対してsetToolTipTextを使用することにより、セル・レベルでツールヒント・テキストを指定できます。

      ノート: JListがこの方法でレンダラのツールヒントを適切に表示するためには、JListToolTipManagerに登録済のコンポーネントである必要があります。 この登録は、コンストラクタで自動的に行われます。 ただし、その後setToolTipText(null)の呼出しによりJListの登録が解除された場合、レンダリングからのヒントは表示されなくなります。

      オーバーライド:
      getToolTipText、クラスJComponent
      パラメータ:
      event - ツールヒント・テキストを取得するMouseEvent
      戻り値:
      ツール・ヒントを含む文字列
      関連項目:
    • locationToIndex

      public int locationToIndex(Point location)
      リストの座標系内の指定された位置にもっとも近いセル・インデックスを返します。 セルが実際にその指定された位置を含むかどうかを判定するには、その点と、getCellBoundsで提供されるセルの境界とを比較します。 このメソッドは、モデルが空の場合、-1を返します

      これは、リストのListUI内の同じ名前のメソッドに委譲するカバー・メソッドです。 リストにListUIがない場合、-1を返します。

      パラメータ:
      location - 点の座標
      戻り値:
      指定された位置にもっとも近いセル・インデックス、または-1
    • indexToLocation

      public Point indexToLocation(int index)
      リストの座標系内の指定された項目の原点を返します。 このメソッドは、インデックスが有効でない場合にnullを返します。

      これは、リストのListUI内の同じ名前のメソッドに委譲するカバー・メソッドです。 リストにListUIがない場合、nullを返します。

      パラメータ:
      index - セルのインデックス
      戻り値:
      セルの原点、またはnull
    • getCellBounds

      public Rectangle getCellBounds(int index0, int index1)
      2つのインデックスで指定されたセルの範囲を示す、リストの座標系内の境界の矩形を返します。 これらのインデックスは、任意の順序で指定できます。

      小さいほうのインデックスがリストのセルの範囲外にある場合、このメソッドはnullを返します。 小さいほうのインデックスが有効であっても、大きいほうのインデックスがリストの範囲外にある場合、最初のインデックスの境界だけが返されます。 そうでない場合、有効な範囲の境界が返されます。

      これは、リストのListUI内の同じ名前のメソッドに委譲するカバー・メソッドです。 リストにListUIがない場合、nullを返します。

      パラメータ:
      index0 - 範囲の1番目のインデックス
      index1 - 範囲の2番目のインデックス
      戻り値:
      セルの範囲を示す境界の矩形、またはnull
    • getModel

      public ListModel<E> getModel()
      JListコンポーネントによって表示される項目のリストを保持するデータ・モデルを返します。
      戻り値:
      表示された項目のリストを提供するListModel
      関連項目:
    • setModel

      @BeanProperty(visualUpdate=true, description="The object that contains the data to be drawn by this JList.") public void setModel(ListModel<E> model)
      リストの内容または「値」を表すモデルを設定し、プロパティ変更リスナーに通知して、リストの選択をクリアします。

      これはJavaBeansバウンド・プロパティです。

      パラメータ:
      model - 表示される項目のリストを提供するListModel
      スロー:
      IllegalArgumentException - modelnullである場合
      関連項目:
    • setListData

      public void setListData(E[] listData)
      項目の配列から読取り専用ListModelを構築し、このモデルを使ってsetModelを呼び出します。

      このメソッドにnull値を渡そうとすると未定義の動作が発生し、さらに多くの場合は例外が発生します。 作成されたモデルは、指定された配列を直接参照します。 このメソッドの呼出し後に配列を変更しようとすると、不確定な動作が生じます。

      パラメータ:
      listData - リストに表示する項目を保持するEの配列
      関連項目:
    • setListData

      public void setListData(Vector<? extends E> listData)
      Vectorから読取り専用ListModelを構築し、このモデルを使ってsetModelを呼び出します。

      このメソッドにnull値を渡そうとすると未定義の動作が発生し、さらに多くの場合は例外が発生します。 作成されたモデルは、指定されたVectorを直接参照します。 このメソッドの呼出し後にVectorを変更しようとすると、不確定な動作が生じます。

      パラメータ:
      listData - リストに表示する項目を保持するVector
      関連項目:
    • createSelectionModel

      protected ListSelectionModel createSelectionModel()
      リストの選択モデル・プロパティを初期化するため、構築中に呼び出されるDefaultListSelectionModelのインスタンスを返します。
      戻り値:
      DefaultListSelectionModel。構成時にリストの選択モデル・プロパティを初期化するために使用されます。
      関連項目:
    • getSelectionModel

      public ListSelectionModel getSelectionModel()
      現在の選択モデルを返します。 選択モデルは、リストの選択状態を保持します。 詳細は、クラス・レベルのドキュメントを参照してください。
      戻り値:
      リストの選択を保持するListSelectionModel
      関連項目:
    • fireSelectionValueChanged

      protected void fireSelectionValueChanged(int firstIndex, int lastIndex, boolean isAdjusting)
      選択のリストに直接追加されたListSelectionListenerに、選択モデルに変更が加えられたことを通知します。 JListは、選択モデル内の選択に対する変更を待機し、このメソッドを呼び出すことにより、リストに直接追加されたリスナーに通知を送ります。

      このメソッドは、このリストをソースとし、指定の引数を使って、ListSelectionEventを構築します。さらに、それを登録済みのListSelectionListenersに送信します。

      パラメータ:
      firstIndex - 範囲内の最初のインデックス、<= lastIndex
      lastIndex - 範囲内の最後のインデックス、>= firstIndex
      isAdjusting - このイベントが変更中の一連のイベントに含まれているかどうか
      関連項目:
    • addListSelectionListener

      public void addListSelectionListener(ListSelectionListener listener)
      選択が変更されるたびに通知されるリストにリスナーを追加します。選択状態の変更を待機する方法としてお勧めです。 JListは、選択モデルの選択状態の変更を待機し、指定されたリスナーに個々の変更を通知します。 リスナーに送信されたListSelectionEventにより、sourceプロパティがこのリストに設定されます。
      パラメータ:
      listener - 追加するListSelectionListener
      関連項目:
    • removeListSelectionListener

      public void removeListSelectionListener(ListSelectionListener listener)
      リストから選択リスナーを削除します。
      パラメータ:
      listener - 削除するListSelectionListener
      関連項目:
    • getListSelectionListeners

      @BeanProperty(bound=false) public ListSelectionListener[] getListSelectionListeners()
      addListSelectionListenerを使用してこのJListに追加されたすべてのListSelectionListenerの配列を返します。
      戻り値:
      このリスト上のすべてのListSelectionListener。追加されたリスナーがない場合は空の配列
      導入されたバージョン:
      1.4
      関連項目:
    • setSelectionModel

      @BeanProperty(description="The selection model, recording which cells are selected.") public void setSelectionModel(ListSelectionModel selectionModel)
      リストのselectionModelnullではないListSelectionModel実装に設定します。 選択モデルは、単一選択、隣接した範囲の選択、および非隣接選択を作成するタスクを処理します。

      これはJavaBeansバウンド・プロパティです。

      パラメータ:
      selectionModel - 選択を実装するListSelectionModel
      スロー:
      IllegalArgumentException - selectionModelnullである場合
      関連項目:
    • setSelectionMode

      @BeanProperty(bound=false, enumerationValues={"ListSelectionModel.SINGLE_SELECTION","ListSelectionModel.SINGLE_INTERVAL_SELECTION","ListSelectionModel.MULTIPLE_INTERVAL_SELECTION"}, description="The selection mode.") public void setSelectionMode(int selectionMode)
      リストの選択モードを設定します。 これは、選択モデル上で直接選択モードを設定するカバー・メソッドです。

      使用可能な選択モードは、次のリストのとおりです。

      • ListSelectionModel.SINGLE_SELECTION - 1回に1つのリスト・インデックスのみを選択できます。 このモードでは、setSelectionIntervalメソッドとaddSelectionIntervalメソッドは同等であり、どちらも現在の選択を、2番目の引数で表されるインデックス(「リード・インデックス」)で置き換えます。
      • ListSelectionModel.SINGLE_INTERVAL_SELECTION - 1回に1つの連続区間のみを選択できます。 このモードでは、addSelectionIntervalは、指定された間隔が既存の選択範囲に隣接していたりオーバーラップしていたりしないかぎりsetSelectionIntervalと同様に動作するため(現在の選択を置き換える)、選択範囲を拡張する目的で使用できます。
      • ListSelectionModel.MULTIPLE_INTERVAL_SELECTION - このモードでは、選択対象に制限はありません。 このモードがデフォルトです。

      パラメータ:
      selectionMode - 選択モード
      スロー:
      IllegalArgumentException - 許可された選択モードでない場合
      関連項目:
    • getSelectionMode

      public int getSelectionMode()
      リストの現在の選択モードを返します。 これは、リストの選択モデル上の同じ名前のメソッドに委譲するカバー・メソッドです。
      戻り値:
      現在の選択モード
      関連項目:
    • getAnchorSelectionIndex

      @BeanProperty(bound=false) public int getAnchorSelectionIndex()
      アンカー選択インデックスを返します。 これは、リストの選択モデル上の同じ名前のメソッドに委譲するカバー・メソッドです。
      戻り値:
      アンカー選択インデックス
      関連項目:
    • getLeadSelectionIndex

      @BeanProperty(bound=false, description="The lead selection index.") public int getLeadSelectionIndex()
      選択範囲のリード・インデックスを返します。 これは、リストの選択モデル上の同じ名前のメソッドに委譲するカバー・メソッドです。
      戻り値:
      リード選択インデックス
      関連項目:
    • getMinSelectionIndex

      @BeanProperty(bound=false) public int getMinSelectionIndex()
      選択されているセルの最小インデックスを返すか、選択範囲が空の場合は-1を返します。 これは、リストの選択モデル上の同じ名前のメソッドに委譲するカバー・メソッドです。
      戻り値:
      選択されているセルの最小インデックス、または-1
      関連項目:
    • getMaxSelectionIndex

      @BeanProperty(bound=false) public int getMaxSelectionIndex()
      選択されているセルの最大インデックスを返すか、選択範囲が空の場合は-1を返します。 これは、リストの選択モデル上の同じ名前のメソッドに委譲するカバー・メソッドです。
      戻り値:
      選択されているセルの最大インデックス
      関連項目:
    • isSelectedIndex

      public boolean isSelectedIndex(int index)
      指定のインデックスが選択されている場合はtrueを返し、それ以外の場合はfalseを返します。 これは、リストの選択モデル上の同じ名前のメソッドに委譲するカバー・メソッドです。
      パラメータ:
      index - 選択状態が照会されるインデックス
      戻り値:
      指定のインデックスが選択されている場合はtrue、それ以外の場合はfalse
      関連項目:
    • isSelectionEmpty

      @BeanProperty(bound=false) public boolean isSelectionEmpty()
      何も選択されていない場合はtrueを返し、それ以外の場合はfalseを返します。 これは、リストの選択モデル上の同じ名前のメソッドに委譲するカバー・メソッドです。
      戻り値:
      何も選択されていない場合はtrue、それ以外の場合はfalse
      関連項目:
    • clearSelection

      public void clearSelection()
      選択をクリアします。このメソッドを呼び出したあとは、isSelectionEmptytrueを返します。 これは、リストの選択モデル上の同じ名前のメソッドに委譲するカバー・メソッドです。
      関連項目:
    • setSelectionInterval

      public void setSelectionInterval(int anchor, int lead)
      指定された区間を選択します。 anchorleadの両方のインデックスが含まれます。anchorlead以下でなくてもかまいません。 これは、リストの選択モデル上の同じ名前のメソッドに委譲するカバー・メソッドです。

      0より小さい値の処理方法については、使用する選択モデル・クラスのドキュメントを参照してください。

      パラメータ:
      anchor - 選択する最初のインデックス
      lead - 選択する最後のインデックス
      関連項目:
    • addSelectionInterval

      public void addSelectionInterval(int anchor, int lead)
      指定された区間を現在の選択に加えます。 anchorleadの両方のインデックスが含まれます。anchorlead以下でなくてもかまいません。 これは、リストの選択モデル上の同じ名前のメソッドに委譲するカバー・メソッドです。

      0より小さい値の処理方法については、使用する選択モデル・クラスのドキュメントを参照してください。

      パラメータ:
      anchor - 選択に追加する最初のインデックス
      lead - 選択に追加する最後のインデックス
      関連項目:
    • removeSelectionInterval

      public void removeSelectionInterval(int index0, int index1)
      選択範囲を、指定された区間と現在の選択範囲との差集合に設定します。 index0index1の両方のインデックスが削除されます。index0index1以下でなくてもかまいません。 これは、リストの選択モデル上の同じ名前のメソッドに委譲するカバー・メソッドです。

      0より小さい値の処理方法については、使用する選択モデル・クラスのドキュメントを参照してください。

      パラメータ:
      index0 - 選択から削除する最初のインデックス
      index1 - 選択から削除する最後のインデックス
      関連項目:
    • setValueIsAdjusting

      public void setValueIsAdjusting(boolean b)
      選択モデルのvalueIsAdjustingプロパティを設定します。 trueの場合、選択モデルに対する複数の変更は、1つの変更の一部であると見なされるはずです。 このプロパティは内部で使用され、開発者は通常、このメソッドを呼び出す必要はありません。 たとえば、ユーザーのドラッグに応じてモデルが更新される場合、プロパティの値は、ドラッグの開始時にはtrue、終了時にはfalseに設定されます。 このため、中間値をすべて処理するのではなく、変更がファイナライズされた場合にだけリスナーを更新できます。

      一連の変更を1回の変更の一部と見なす必要がある場合は、これを直接使用できます。

      これは、リストの選択モデル上の同じ名前のメソッドに委譲するカバー・メソッドです。 詳細は、ListSelectionModel.setValueIsAdjusting(boolean)のドキュメントを参照してください。

      パラメータ:
      b - プロパティの変更後の値
      関連項目:
    • getValueIsAdjusting

      public boolean getValueIsAdjusting()
      選択モデルのisAdjustingプロパティの値を返します。

      これは、リストの選択モデル上の同じ名前のメソッドに委譲するカバー・メソッドです。

      戻り値:
      選択モデルのisAdjustingプロパティの値。
      関連項目:
    • getSelectedIndices

      public int[] getSelectedIndices()
      選択されているすべてのインデックスの昇順配列を返します。
      戻り値:
      選択されているすべてのインデックス(昇順)、または何も選択されていない場合は空の配列
      関連項目:
    • setSelectedIndex

      @BeanProperty(bound=false, description="The index of the selected cell.") public void setSelectedIndex(int index)
      単一セルを選択します。 指定されたインデックスがモデル・サイズ以上である場合は、何も行いません。 これは、選択モデル上でsetSelectionIntervalを使用する簡易メソッドです。 0より小さい値の処理方法については、使用する選択モデル・クラスのドキュメントを参照してください。
      パラメータ:
      index - 選択するセルのインデックス
      関連項目:
    • setSelectedIndices

      public void setSelectedIndices(int[] indices)
      選択を、指定の配列によって示される一連のインデックスに変更します。 モデル・サイズ以上のインデックスは無視されます。 これは、選択をクリアし、選択モデル上でaddSelectionIntervalを使ってインデックスを追加する簡易メソッドです。 0より小さい値の処理方法については、使用する選択モデル・クラスのドキュメントを参照してください。
      パラメータ:
      indices - 選択するセルのインデックスの配列、null以外
      スロー:
      NullPointerException - 指定された配列がnullである場合
      関連項目:
    • getSelectedValues

      @Deprecated @BeanProperty(bound=false) public Object[] getSelectedValues()
      非推奨。
      JDK 1.7で、getSelectedValuesList()に置き換えられています
      選択されているすべての値を、リスト内のインデックスに基づいて昇順の配列にして返します。
      戻り値:
      選択された値。何も選択されていない場合は空の配列
      関連項目:
    • getSelectedValuesList

      @BeanProperty(bound=false) public List<E> getSelectedValuesList()
      選択されているすべての項目を、リスト内のインデックスに基づいて昇順のリストにして返します。
      戻り値:
      選択された項目。何も選択されていない場合は空のリスト
      導入されたバージョン:
      1.7
      関連項目:
    • getSelectedIndex

      public int getSelectedIndex()
      選択されているセルの最小インデックスを返します。リスト内の項目が1つだけ選択されている場合は「選択値」 複数の項目が選択されている場合は、単純に選択されている最小インデックスになります。 何も選択されていない場合は-1を返します。

      このメソッドは、getMinSelectionIndexに委譲するカバー・メソッドです。

      戻り値:
      選択されているセルの最小インデックス
      関連項目:
    • getSelectedValue

      @BeanProperty(bound=false) public E getSelectedValue()
      選択されているセルの最小インデックスの値を返します。リスト内の項目が1つだけ選択されている場合は「選択値」 複数の項目が選択されている場合は、単純に選択されている最小インデックスの値になります。 何も選択されていない場合はnullを返します。

      これは、単純にgetMinSelectionIndexのモデル値を返す簡易メソッドです。

      戻り値:
      最初に選択された値
      関連項目:
    • setSelectedValue

      public void setSelectedValue(Object anObject, boolean shouldScroll)
      指定されたオブジェクトをリストから選択します。 渡されたオブジェクトがnullの場合は、選択がクリアされます。
      パラメータ:
      anObject - 選択するオブジェクト
      shouldScroll - オブジェクトが存在し、選択したオブジェクトを表示するためにリストをスクロールするべきである場合はtrue。そうでない場合はfalse
    • getPreferredScrollableViewportSize

      @BeanProperty(bound=false) public Dimension getPreferredScrollableViewportSize()
      visibleRowCount行を表示するために必要なビュー・ポートのサイズを計算します。 このメソッドの戻り値は、レイアウト方向によって異なります。

      VERTICAL:
      fixedCellWidthfixedCellHeightの両方が設定されている場合(明示的に設定される場合と、セルのプロトタイプ値を指定して設定される場合がある)、この値は明らかです。
      幅は、単純にfixedCellWidthにリストの水平のイン・セットを足し合わせた値になります。 高さは、fixedCellHeightvisibleRowCountを掛けて、リストの垂直のイン・セットを足し合わせた値になります。

      fixedCellWidthfixedCellHeightのどちらかが指定されていない場合、ヒューリスティックな方法が使用されます。 モデルが空であり、幅が0より大きいか、またはハードコードされた値256である場合、幅はfixedCellWidthになります。 fixedCellHeight0より大きい場合、高さはfixedCellHeightvisibleRowCountを掛けた値になります。そうでない場合は、ハードコードされた値16visibleRowCountを掛けた値になります。

      モデルが空でなければ、幅は推奨サイズの幅(通常、もっとも幅の広いリスト要素の幅)になります。 高さは、インデックス0にvisibleRowCountを乗算したセルの高さとリストの垂直枠を掛けたものです。

      VERTICAL_WRAPまたはHORIZONTAL_WRAP:
      このメソッドは、単純にgetPreferredSizeから値を返します。
      リストのListUIは、getPreferredSizeをオーバーライドして、適切な値を返す必要があります。

      定義:
      getPreferredScrollableViewportSize、インタフェースScrollable
      戻り値:
      visibleRowCount行の表示に必要なビュー・ポートのサイズを含む寸法
      関連項目:
    • getScrollableUnitIncrement

      public int getScrollableUnitIncrement(Rectangle visibleRect, int orientation, int direction)
      次または前の行(垂直スクロール)または列(水平スクロール)を表示するためにスクロールする距離を返します。 指定されたパラメータのスクロールがすでに最も遠いエクステントにある場合を除き、戻されるスクロール距離は正になります。この場合、ゼロが返されます。

      水平方向のスクロールでは、レイアウトの方向がVERTICALである場合、リストのフォント・サイズ(フォントがnullの場合は1)が返されます。

      定義:
      getScrollableUnitIncrement、インタフェースScrollable
      パラメータ:
      visibleRect - ビュー・ポート内の可視のビュー領域
      orientation - SwingConstants.HORIZONTALまたはSwingConstants.VERTICAL
      direction - 上または左にスクロールする場合は0以下、下または右にスクロールする場合は0より大きい
      戻り値:
      指定された方向にスクロールするための負でない「単位」増分
      スロー:
      IllegalArgumentException - visibleRectnull、またはorientationSwingConstants.VERTICALまたはSwingConstants.HORIZONTALのいずれでもない場合。
      関連項目:
    • getScrollableBlockIncrement

      public int getScrollableBlockIncrement(Rectangle visibleRect, int orientation, int direction)
      次または前のブロックを表示するためにスクロールする距離を返します。

      垂直方向のスクロールには、次のルールが適用されます。

      • 下にスクロールする場合、最後の可視要素が最初の完全な可視要素になるように、スクロールする距離を返す
      • 上にスクロールする場合、最初の可視要素が最後の完全な可視要素になるように、スクロールする距離を返す
      • リストが空の場合は、visibleRect.heightを返す

      水平方向のスクロールで、レイアウト方向がVERTICAL_WRAPまたはHORIZONTAL_WRAPである場合、次のルールが適用されます。

      • 右にスクロールする場合、最後の可視要素が最初の完全な可視要素になるように、スクロールする距離を返す
      • 左にスクロールする場合、最初の可視要素が最後の完全な可視要素になるように、スクロールする距離を返す
      • リストが空の場合は、visibleRect.widthを返す

      水平方向のスクロールで、レイアウト方向がVERTICALである場合、visibleRect.widthを返します。

      visibleRectの値は、this.getVisibleRect()と同じである必要があります。

      定義:
      getScrollableBlockIncrement、インタフェースScrollable
      パラメータ:
      visibleRect - ビュー・ポート内の可視のビュー領域
      orientation - SwingConstants.HORIZONTALまたはSwingConstants.VERTICAL
      direction - 上または左にスクロールする場合は0以下、下または右にスクロールする場合は0より大きい
      戻り値:
      指定された方向にスクロールするための「ブロック」増分値。常に正の値
      スロー:
      IllegalArgumentException - visibleRectnull、またはorientationSwingConstants.VERTICALまたはSwingConstants.HORIZONTALのいずれでもない場合。
      関連項目:
    • getScrollableTracksViewportWidth

      @BeanProperty(bound=false) public boolean getScrollableTracksViewportWidth()
      このJListJViewport内に表示され、ビュー・ポートの幅がリストの適切な幅よりも広い場合、またはレイアウト方向がHORIZONTAL_WRAPvisibleRowCount <= 0である場合はtrueを返します。それ以外の場合はfalseを返します。

      falseの場合、ビュー・ポートの幅を追跡しません。 これにより、JViewport自体がJScrollPaneに組み込まれている場合、水平スクロールができるようになります。

      定義:
      getScrollableTracksViewportWidth、インタフェースScrollable
      戻り値:
      囲み側のビュー・ポートがリストの幅をそれ自体の幅に強制的に一致させるかどうか
      関連項目:
    • getScrollableTracksViewportHeight

      @BeanProperty(bound=false) public boolean getScrollableTracksViewportHeight()
      このJListJViewport内に表示され、ビュー・ポートの幅がリストの適切な高さよりも高い場合、またはレイアウト方向がVERTICAL_WRAPvisibleRowCount <= 0である場合はtrueを返します。それ以外の場合はfalseを返します。

      falseの場合、ビュー・ポートの高さを追跡しません。 これにより、JViewport自体がJScrollPaneに組み込まれている場合、垂直スクロールができるようになります。

      定義:
      getScrollableTracksViewportHeight、インタフェースScrollable
      戻り値:
      囲み側のビュー・ポートがリストの高さを自体の高さに強制的に一致させるかどうか
      関連項目:
    • paramString

      protected String paramString()
      このJListString表現を返します。 このメソッドはデバッグ専用であり、返されるStringの内容および形式は実装によって異なります。 返されるStringは空の場合がありますが、nullにはなりません。
      オーバーライド:
      paramString、クラスJComponent
      戻り値:
      このJListString表現。
    • getAccessibleContext

      @BeanProperty(bound=false) public AccessibleContext getAccessibleContext()
      このJListに関連付けられているAccessibleContextを取得します。 JListの場合、AccessibleContextAccessibleJListの形式を取ります。

      必要に応じて、新しいAccessibleJListインスタンスが作成されます。

      定義:
      getAccessibleContext、インタフェースAccessible
      オーバーライド:
      getAccessibleContext、クラスComponent
      戻り値:
      このJListAccessibleContextとして機能するAccessibleJList