JavaTM 2
Platform
Std. Ed. v1.4.0

javax.swing
クラス JList

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.Container
              |
              +--javax.swing.JComponent
                    |
                    +--javax.swing.JList
すべての実装インタフェース:
Accessible, ImageObserver, MenuContainer, Scrollable, Serializable

public class JList
extends JComponent
implements Scrollable, Accessible

ユーザがリストから 1 つまたは複数のオブジェクトを選択するためのコンポーネントです。別のモデルである ListModel は、リストの内容を表します。ListModel のインスタンスを生成する JList コンストラクタを使用すれば、オブジェクトの配列またはベクタを簡単に表示できます。

// Create a JList that displays the strings in data[]
String[] data = {"one", "two", "three", "four"};
JList dataList = new JList(data);
 
// The value of the JList model property is an object that provides
// a read-only view of the data.  It was constructed automatically.
for(int i = 0; i < dataList.getModel().getSize(); i++) {
System.out.println(dataList.getModel().getElementAt(i));
 }
// Create a JList that displays the superclass of JList.class.
// We store the superclasses in a java.util.Vector.
Vector superClasses = new Vector();
Class rootClass = javax.swing.JList.class;
for(Class cls = rootClass; cls != null; cls = cls.getSuperclass()) {
superClasses.addElement(cls);
 }
JList classList = new JList(superClasses);

JList はスクロールを直接サポートしていません。スクロールリストを作成するには、JListJScrollPane のビューポートビューとして設定します。次に例を示します。

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

デフォルトでは、定数 MULTIPLE_INTERVAL_SELECTION を使って、JList の選択モデルにより項目の組み合わせを一度に選択することができます。選択状態は実際には個別の委譲オブジェクト、ListSelectionModel のインスタンスで管理されています。ただし、JList では選択管理に便利なプロパティが提供されます。

String[] data = {"one", "two", "three", "four"};
JList dataList = new JList(data);
dataList.setSelectedIndex(1);  // select "two"
dataList.getSelectedValue();   // returns "two"

JList の内容は動的です。つまり、JList の作成後にリスト要素の値やリストのサイズを変更できます。JList は、swing.event.ListDataListener 実装によってモデルの変更を監視します。ListModel が正しく実装されていれば、変更が発生するたびにリスナーに通知します。変更は、修正、追加、または削除されたリストインデックスの範囲を識別する swing.event.ListDataEvent によって記述されます。単純な動的内容の JList アプリケーションは、DefaultListModel クラスを使用してリスト要素を格納できます。このクラスは、ListModel インタフェースを実装し、java.util.Vector API も提供します。カスタム ListModel 実装を提供する必要があるアプリケーションは、基本的な ListDataListener サポートを提供する AbstractListModel をサブクラス化することができます。次に例を示します。

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

ListModel bigData = new AbstractListModel() {
public int getSize() { return Short.MAX_VALUE; }
public Object getElementAt(int index) { return "Index " + index; }
 };
JList bigDataList = new JList(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 は、cellRenderer を呼び出す委譲によって提供される java.awt.Component を使用して、リスト内で可視セルを描画します。可視の各行は、セルレンダリングコンポーネントを「ゴムスタンプ」のように使用して描画されます。JList は、セルを描画する必要があるたびに、セルレンダリングにコンポーネントを要求し、setBounds() を使用して適切な場所に配置してから、レンダリングの描画メソッドを呼び出して描画します。デフォルトのセルレンダリングは、JLabel コンポーネントを使用して、各コンポーネントの文字列値を描画します。次のようなコードにより、自分のセルレンダリングを使用することもできます。

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

class MyCellRenderer extends JLabel implements ListCellRenderer {
final static ImageIcon longIcon = new ImageIcon("long.gif");
final static 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,
Object value,            // value to display
int index,               // cell index
boolean isSelected,      // is the cell selected
boolean cellHasFocus)    // the list and the cell have the 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;
     }
 }
String[] data = {"one", "two", "three", "four"};
JList dataList = new JList(data);
dataList.setCellRenderer(new MyCellRenderer());

JList は、ダブルクリックやトリプル (およびそれ以上の回数の) クリックを特別にはサポートしていませんが、MouseListener を利用すればそれらを簡単に処理することができます。クリックされたセルを調べるには、JListlocationToIndex() メソッドを使用します。次に例を示します。

final JList list = new JList(dataModel);
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);
この例では、dataList は匿名の MouseListener クラスによって参照されているため、final となっています。

標準の Look & Feel (L&F) 表現でこのコンポーネントが使用するキーボードのキーについては、JList のキーの割り当てを参照してください。

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

詳細は、「The Java Tutorial」「How to Use Lists」を参照してください。また、「The Swing Connection」「Advanced JList Programming」も参照してください。

関連項目:
ListModel, AbstractListModel, DefaultListModel, ListSelectionModel, DefaultListSelectionModel, ListCellRenderer

入れ子クラスの概要
protected  class JList.AccessibleJList
          このクラスは JList クラス用のユーザ補助機能のサポートを実装しています。
 
クラス javax.swing.JComponent から継承した入れ子クラス
 
クラス java.awt.Container から継承した入れ子クラス
 
クラス java.awt.Component から継承した入れ子クラス
Component.BltBufferStrategy, Component.FlipBufferStrategy
 
フィールドの概要
static int HORIZONTAL_WRAP
          セルが水平方向の次に垂直方向の順で並ぶ「ニュースペーパースタイル」レイアウトを示します。
static int VERTICAL
          デフォルトのレイアウトを示します。
static int VERTICAL_WRAP
          セルが垂直方向の次に水平方向の順で並ぶ「ニュースペーパースタイル」レイアウトを示します。
 
クラス javax.swing.JComponent から継承したフィールド
accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
 
クラス java.awt.Component から継承したフィールド
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
 
インタフェース java.awt.image.ImageObserver から継承したフィールド
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
 
コンストラクタの概要
JList()
          空のモデルで JList を構築します。
JList(ListModel dataModel)
          指定された null 以外のモデルの要素を表示する JList を構築します。
JList(Object[] listData)
          指定された配列の要素を表示する JList を構築します。
JList(Vector listData)
          指定された Vector の要素を表示する JList を構築します。
 
メソッドの概要
 void addListSelectionListener(ListSelectionListener listener)
          選択が変更されるたびに通知されるリストにリスナーを追加します。
 void addSelectionInterval(int anchor, int lead)
          指定された区間を現在の選択に加えます。
 void clearSelection()
          選択をクリアします。
protected  ListSelectionModel createSelectionModel()
          DefaultListSelectionModel のインスタンスを返します。
 void ensureIndexIsVisible(int index)
          ビューポートをスクロールし、指定されたセルを完全に可視にします。
protected  void fireSelectionValueChanged(int firstIndex, int lastIndex, boolean isAdjusting)
          選択モデルが変更されたことを JListListSelectionListener に通知します。
 AccessibleContext getAccessibleContext()
          この JList に関連した AccessibleContext を返します。
 int getAnchorSelectionIndex()
          最後の addSelectionModel または setSelectionInterval 呼び出しにおける最初のインデックス引数を返します。
 Rectangle getCellBounds(int index0, int index1)
          JList 座標で指定された項目範囲の境界を返します。
 ListCellRenderer getCellRenderer()
          リスト項目を描画するオブジェクトを返します。
 boolean getDragEnabled()
          dragEnabled プロパティを取得します。
 int getFirstVisibleIndex()
          最初の可視セルのインデックスを返します。
 int getFixedCellHeight()
          固定セル高の値を返します。
 int getFixedCellWidth()
          固定セル幅の値を返します。
 int getLastVisibleIndex()
          最後の可視セルのインデックスを返します。
 int getLayoutOrientation()
          レイアウトがセルの単一の列の場合は JList.VERTICAL、コンテンツが垂直方向の次に水平方向の順に並ぶ「ニュースペーパースタイル」の場合は JList.VERTICAL_WRAP、コンテンツが水平方向の次に垂直方向の順に並ぶ「ニュースペーパースタイル」の場合は JList.HORIZONTAL_WRAP を返します。
 int getLeadSelectionIndex()
          最後の addSelectionInterval または setSelectionInterval 呼び出しにおける 2 番目のインデックス引数を返します。
 ListSelectionListener[] getListSelectionListeners()
          この JList に addListSelectionListener() で追加されたすべての ListSelectionListener の配列を返します。
 int getMaxSelectionIndex()
          選択されているセルの最大インデックスを返します。
 int getMinSelectionIndex()
          選択されているセルの最小インデックスを返します。
 ListModel getModel()
          JList コンポーネントによって表示される項目のリストを保持するデータモデルを返します。
 int getNextMatch(String prefix, int startIndex, Position.Bias bias)
          接頭辞で始まる、次のリスト要素を返します。
 Dimension getPreferredScrollableViewportSize()
          visibleRowCount の行を表示するために必要なビューポートのサイズを計算します。
 Object getPrototypeCellValue()
          「プロトタイプセル」のセル幅を返します。
 int getScrollableBlockIncrement(Rectangle visibleRect, int orientation, int direction)
          次または前のブロックを表示するためにスクロールする距離を返します。
 boolean getScrollableTracksViewportHeight()
          この JListJViewport に表示され、ビューポートが JList の適切な高さよりも高い場合、またはレイアウト方向が VERTICAL_WRAP であり、可視行カウントが <= 0 の場合は true を返します。
 boolean getScrollableTracksViewportWidth()
          この JListJViewport に表示され、ビューポートが JList の適切な幅よりも広い場合、またはレイアウト方向が HORIZONTAL_WRAP であり、可視行カウントが <= 0 の場合は true を返します。
 int getScrollableUnitIncrement(Rectangle visibleRect, int orientation, int direction)
          前または次の行 (垂直スクロール)、または文字 (水平スクロール) を表示するためにスクロールする距離を返します。
 int getSelectedIndex()
          最初に選択されたインデックスを返すか、選択項目がない場合は -1 を返します。
 int[] getSelectedIndices()
          選択されているすべてのインデックスの昇順配列を返します。
 Object getSelectedValue()
          最初に選択されたインデックスを返すか、選択が空の場合は null を返します。
 Object[] getSelectedValues()
          選択されたセルの値の配列を返します。
 Color getSelectionBackground()
          選択されたセルのバックグラウンドカラーを返します。
 Color getSelectionForeground()
          フォアグラウンドカラーの選択を返します。
 int getSelectionMode()
          単一項目選択または複数項目選択のどちらが許容されているかを返します。
 ListSelectionModel getSelectionModel()
          現在の選択モデルの値を返します。
 String getToolTipText(MouseEvent event)
          JComponentgetToolTipText メソッドをオーバーライドして、レンダリングのヒント (テキストセットがある場合) を使用できるようにします。
 ListUI getUI()
          このコンポーネントを描画する Look & Feel (L&F) オブジェクトを返します。
 String getUIClassID()
          Look & Feel (L&F) クラスの名前の構築に使用された接頭辞を返します。
 boolean getValueIsAdjusting()
          データモデルの isAdjusting プロパティの値を返します。
 int getVisibleRowCount()
          可視行の適切な数を返します。
 Point indexToLocation(int index)
          指定された項目の JList 座標における原点を返します。
 boolean isSelectedIndex(int index)
          指定されたインデックスが選択されている場合は true を返します。
 boolean isSelectionEmpty()
          何も選択されていない場合は true を返します。
 int locationToIndex(Point location)
          JList の座標上の点をその位置にあるセルのインデックスに変換します。
protected  String paramString()
          この JList の文字列表現を返します。
 void removeListSelectionListener(ListSelectionListener listener)
          選択が変更されるたびに通知されるリスナーをリストから削除します。
 void removeSelectionInterval(int index0, int index1)
          選択範囲を、指定された区間と現在の選択範囲との差集合に設定します。
 void setCellRenderer(ListCellRenderer cellRenderer)
          リスト内の各セルを描画する委譲を設定します。
 void setDragEnabled(boolean b)
          dragEnabled プロパティを設定します。
 void setFixedCellHeight(int height)
          リストにあるすべてのセルの高さを設定します。
 void setFixedCellWidth(int width)
          リストにあるすべてのセルの幅を設定します。
 void setLayoutOrientation(int layoutOrientation)
          リストのセルの配置方法を定義します。
 void setListData(Object[] listData)
          Object の配列から ListModel を構築し、setModel を適用します。
 void setListData(Vector listData)
          Vector から ListModel を構築し、setModel を適用します。
 void setModel(ListModel model)
          リストの内容または「値」を表すモデルを設定し、PropertyChangeListener への通知後にリストの選択物をクリアします。
 void setPrototypeCellValue(Object prototypeCellValue)
          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 setSelectionModel(ListSelectionModel selectionModel)
          リストの selectionModelnull ではない ListSelectionModel 実装に設定します。
 void setUI(ListUI ui)
          このコンポーネントを描画する Look & Feel (L&F) オブジェクトを設定します。
 void setValueIsAdjusting(boolean b)
          データモデルの isAdjusting プロパティを true に設定し、すべての選択イベント (選択モードでリスト項目上をマウスでドラッグしている場合など) が完了した時点で単一イベントが生成されるようにします。
 void setVisibleRowCount(int visibleRowCount)
          スクロールバーを使用せずに表示できるリスト内の行の適切な数を設定します。
 void updateUI()
          現在の Look & Feel からの値を持つ UI プロパティをリセットします。
 
クラス javax.swing.JComponent から継承したメソッド
addAncestorListener, addNotify, addPropertyChangeListener, addPropertyChangeListener, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBorder, getBounds, getClientProperty, getComponentGraphics, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getGraphics, getHeight, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPreferredSize, getPropertyChangeListeners, getPropertyChangeListeners, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isOptimizedDrawingEnabled, isPaintingTile, isPreferredSizeSet, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFont, setForeground, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update
 
クラス java.awt.Container から継承したメソッド
add, add, add, add, add, addContainerListener, addImpl, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setFocusCycleRoot, setFocusTraversalKeys, setFocusTraversalPolicy, setLayout, transferFocusBackward, transferFocusDownCycle, validate, validateTree
 
クラス java.awt.Component から継承したメソッド
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMouseWheelListeners, getName, getParent, getPeer, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, 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, processMouseEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusUpCycle
 
クラス java.lang.Object から継承したメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

フィールドの詳細

VERTICAL

public static final int VERTICAL
デフォルトのレイアウトを示します。セルの 1 つの列です。

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

VERTICAL_WRAP

public static final int VERTICAL_WRAP
セルが垂直方向の次に水平方向の順で並ぶ「ニュースペーパースタイル」レイアウトを示します。

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

HORIZONTAL_WRAP

public static final int HORIZONTAL_WRAP
セルが水平方向の次に垂直方向の順で並ぶ「ニュースペーパースタイル」レイアウトを示します。

導入されたバージョン:
1.4
関連項目:
setLayoutOrientation(int), 定数フィールド値
コンストラクタの詳細

JList

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

パラメータ:
dataModel - このリストのデータモデル
例外:
IllegalArgumentException - dataModelnull の場合

JList

public JList(Object[] listData)
指定された配列の要素を表示する JList を構築します。このコンストラクタは、ListModel コンストラクタに委譲します。

パラメータ:
listData - データモデルにロードされる Object の配列

JList

public JList(Vector listData)
指定された Vector の要素を表示する JList を構築します。このコンストラクタは、ListModel コンストラクタに委譲します。

パラメータ:
listData - データモデルにロードされる Vector

JList

public JList()
空のモデルで JList を構築します。

メソッドの詳細

getUI

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

戻り値:
このコンポーネントを描画する ListUI オブジェクト

setUI

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

パラメータ:
ui - ListUI L&F オブジェクト
関連項目:
UIDefaults.getUI(javax.swing.JComponent)

updateUI

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

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

getUIClassID

public String getUIClassID()
Look & Feel (L&F) クラスの名前の構築に使用された接頭辞を返します。このクラスは、このコンポーネントを描画するのに使用されます。

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

getPrototypeCellValue

public Object getPrototypeCellValue()
「プロトタイプセル」のセル幅を返します。他のすべてのリスト項目と同じ値を持つため、プロトタイプセルはセル幅の計算に使用されます。

戻り値:
prototypeCellValue プロパティの値
関連項目:
setPrototypeCellValue(java.lang.Object)

setPrototypeCellValue

public void setPrototypeCellValue(Object prototypeCellValue)
fixedCellWidth および fixedCellHeight プロパティを計算します。インデックス 0 の cellRenderer を指定値に設定してから、レンダリングコンポーネントの優先サイズを計算します。リストが長すぎて JList が各セルの幅と高さを計算できず、他のセルと同じスペースを持つことがわかっているセルがある場合には、このプロパティが便利です。

fixedCellWidth および fixedCellHeight プロパティをここで設定しても、prototypeCellValue だけで PropertyChangeEvent がトリガされることに注意してください。

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

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

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

パラメータ:
prototypeCellValue - fixedCellWidth および fixedCellHeight のベースとなる値
関連項目:
getPrototypeCellValue(), setFixedCellWidth(int), setFixedCellHeight(int), JComponent.addPropertyChangeListener(java.beans.PropertyChangeListener)

getFixedCellWidth

public int getFixedCellWidth()
固定セル幅の値を返します。固定セル幅の値とは、リスト要素から計算された値ではなく、fixedCellWidth プロパティで指定されている値です。

戻り値:
固定セル幅
関連項目:
setFixedCellWidth(int)

setFixedCellWidth

public void setFixedCellWidth(int width)
リストにあるすべてのセルの幅を設定します。width が -1 の場合、各リスト要素の cellRenderer コンポーネントに getPreferredSize を適用することにより、セル幅が計算されます。

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

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

パラメータ:
width - ピクセル単位の、リスト内のすべてのセルの幅
関連項目:
getPrototypeCellValue(), setFixedCellWidth(int), JComponent.addPropertyChangeListener(java.beans.PropertyChangeListener)

getFixedCellHeight

public int getFixedCellHeight()
固定セル高の値を返します。固定セル高の値とは、リスト要素から計算された値ではなく、fixedCellHeight プロパティで指定されている値です。

戻り値:
ピクセル単位の固定セル高
関連項目:
setFixedCellHeight(int)

setFixedCellHeight

public void setFixedCellHeight(int height)
リストにあるすべてのセルの高さを設定します。height が -1 の場合、各リスト要素の cellRenderer コンポーネントに getPreferredSize を適用することにより、セルの高さが計算されます。

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

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

パラメータ:
height - リスト内のすべてのセルの高さをピクセル数で指定する整数
関連項目:
getPrototypeCellValue(), setFixedCellWidth(int), JComponent.addPropertyChangeListener(java.beans.PropertyChangeListener)

getCellRenderer

public ListCellRenderer getCellRenderer()
リスト項目を描画するオブジェクトを返します。

戻り値:
ListCellRenderer
関連項目:
setCellRenderer(javax.swing.ListCellRenderer)

setCellRenderer

public void setCellRenderer(ListCellRenderer cellRenderer)
リスト内の各セルを描画する委譲を設定します。prototypeCellValue が設定されていれば、fixedCellWidth および fixedCellHeight プロパティも設定されます。しかし、cellRenderer プロパティに対しては PropertyChangeEvent は 1 つだけ生成されます。

このプロパティのデフォルト値は ListUI 委譲 (Look & Feel の実装) によって提供されます。

セルレンダリングの設定例を参照するには、上記の クラスの説明を参照してください。

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

パラメータ:
cellRenderer - リスト内のセルを描画する ListCellRenderer
関連項目:
getCellRenderer()

getSelectionForeground

public Color getSelectionForeground()
フォアグラウンドカラーの選択を返します。

戻り値:
フォアグラウンドプロパティの Color オブジェクト
関連項目:
setSelectionForeground(java.awt.Color), setSelectionBackground(java.awt.Color)

setSelectionForeground

public void setSelectionForeground(Color selectionForeground)
選択されたセルのフォアグラウンドカラーを設定します。セルレンダリングはこの色を使って、選択されたセルのテキストとグラフィックスを描画します。

このプロパティのデフォルト値は、Look & Feel の実装によって定義されます。

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

パラメータ:
selectionForeground - 選択されたリスト項目のフォアグラウンドで使う Color
関連項目:
getSelectionForeground(), setSelectionBackground(java.awt.Color), JComponent.setForeground(java.awt.Color), JComponent.setBackground(java.awt.Color), JComponent.setFont(java.awt.Font)

getSelectionBackground

public Color getSelectionBackground()
選択されたセルのバックグラウンドカラーを返します。

戻り値:
選択されたリスト項目のバックグラウンドで使う Color
関連項目:
setSelectionBackground(java.awt.Color), setSelectionForeground(java.awt.Color)

setSelectionBackground

public void setSelectionBackground(Color selectionBackground)
選択されたセルのバックグラウンドカラーを設定します。セルレンダリングはこの色を使って、選択されたセルを塗りつぶすことができます。

このプロパティのデフォルト値は、Look & Feel の実装によって定義されます。

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

パラメータ:
selectionBackground - 選択されたセルのバックグラウンドで使う Color
関連項目:
getSelectionBackground(), setSelectionForeground(java.awt.Color), JComponent.setForeground(java.awt.Color), JComponent.setBackground(java.awt.Color), JComponent.setFont(java.awt.Font)

getVisibleRowCount

public int getVisibleRowCount()
可視行の適切な数を返します。

戻り値:
スクロールバーを使用せずに表示できる行の適切な数を示す整数
関連項目:
setVisibleRowCount(int)

setVisibleRowCount

public void setVisibleRowCount(int visibleRowCount)
スクロールバーを使用せずに表示できるリスト内の行の適切な数を設定します。この値は、もっとも近い JViewport の上位オブジェクト (存在する場合のみ) によって決定されます。このプロパティ値は、JListpreferredScrollableViewportSize の値にのみ影響します。

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

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

パラメータ:
visibleRowCount - 可視行の適切な数を指定する整数
関連項目:
getVisibleRowCount(), JComponent.getVisibleRect(), JViewport

getLayoutOrientation

public int getLayoutOrientation()
レイアウトがセルの単一の列の場合は JList.VERTICAL、コンテンツが垂直方向の次に水平方向の順に並ぶ「ニュースペーパースタイル」の場合は JList.VERTICAL_WRAP、コンテンツが水平方向の次に垂直方向の順に並ぶ「ニュースペーパースタイル」の場合は JList.HORIZONTAL_WRAP を返します。

戻り値:
layoutOrientation プロパティの値
導入されたバージョン:
1.4
関連項目:
setLayoutOrientation(int)

setLayoutOrientation

public void setLayoutOrientation(int layoutOrientation)
リストのセルの配置方法を定義します。4 つのセルを持つ JList の場合、次の方法のいずれかで配置することができます。
   0
   1
   2
   3
   0  1
   2  3
   0  2
   1  3

これらは次の値に対応します。
JList.VERTICAL セルは 1 つの列で垂直方向に配置される
JList.HORIZONTAL_WRAP セルは水平方向に配置され、必要に応じて次の行へ折り返される。使用する行数は、0 より大きい場合 getVisibleRowCount で定義され、そうでない場合は JList の幅で指定される
JList.VERTICAL_WRAP セルは垂直方向に配置され、必要に応じて次の列へ折り返される。使用する行数は、0 より大きい場合 getVisibleRowCount で定義され、そうでない場合は JList の高さで指定される
このプロパティのデフォルト値は JList.VERTICAL です。

layoutOrientationJList.HORIZONTAL_WRAPJList.VERTICAL、または JList.VERTICAL_WRAP のどれでもない場合は、IllegalArgumentException がスローされます。

パラメータ:
layoutOrientation - 新しい orientation。JList.HORIZONTAL_WRAPJList.VERTICAL、または JList.VERTICAL_WRAP のうちの 1 つ
導入されたバージョン:
1.4
関連項目:
getLayoutOrientation(), setVisibleRowCount(int), getScrollableTracksViewportHeight()

getFirstVisibleIndex

public int getFirstVisibleIndex()
最初の可視セルのインデックスを返します。セルを「最初」であると見なすかどうかは componentOrientation プロパティによります。方向が、左から右への水平方向である場合、最初の可視セルはリストの左上隅になり、右から左への水平方向の場合は右上隅になります。どのセルも可視ではない場合やリストが空である場合には -1 を返します。返されたセルは部分的に可視でもかまいません。

戻り値:
最初の可視セルのインデックス
関連項目:
getLastVisibleIndex(), JComponent.getVisibleRect()

getLastVisibleIndex

public int getLastVisibleIndex()
最後の可視セルのインデックスを返します。セルを「最後」であると見なすかどうかは componentOrientation プロパティによります。方向が、左から右への水平方向である場合、最後の可視セルは JList の右下隅になり、右から左への水平方向の場合は左下隅になります。どのセルも可視ではない場合やリストが空である場合には -1 を返します。返されたセルは部分的に可視でもかまいません。

戻り値:
最後の可視セルのインデックス
関連項目:
getFirstVisibleIndex(), JComponent.getVisibleRect()

ensureIndexIsVisible

public void ensureIndexIsVisible(int index)
ビューポートをスクロールし、指定されたセルを完全に可視にします。このメソッドを有効にするには、JViewport 内で JList を表示する必要があります。

パラメータ:
index - 可視にするセルのインデックス
関連項目:
JComponent.scrollRectToVisible(java.awt.Rectangle), JComponent.getVisibleRect()

setDragEnabled

public void setDragEnabled(boolean b)
dragEnabled プロパティを設定します。このコンポーネントの自動ドラッグ処理 (ドラッグ&ドロップの最初の部分) を使用可能にするには true にする必要があります。ドラッグして何らかの操作を行うには transferHandler プロパティは null 以外の値に設定します。dragEnabled プロパティのデフォルト値は false です。

自動ドラッグ処理が使用可能にされると、ほとんどの Look & Feel は、ユーザが選択範囲上でマウスボタンを押してからマウスを数ピクセル移動したときにドラッグ&ドロップ操作を開始します。したがって、このプロパティを true に設定すると、選択範囲の動作にわずかに影響します。

自動ドラッグ処理をサポートしていない Look & Feel もあり、その場合このプロパティは無視されます。サポートしていない Look & Feel を回避するには、TransferHandlerexportAsDrag メソッドを直接呼び出してコンポーネントを変更します。

パラメータ:
b - dragEnabled プロパティに設定する値
例外:
HeadlessException - btrue かつ GraphicsEnvironment.isHeadless()true を返す場合
導入されたバージョン:
1.4
関連項目:
GraphicsEnvironment.isHeadless(), getDragEnabled(), JComponent.setTransferHandler(javax.swing.TransferHandler), TransferHandler

getDragEnabled

public boolean getDragEnabled()
dragEnabled プロパティを取得します。

戻り値:
dragEnabled プロパティの値
導入されたバージョン:
1.4
関連項目:
setDragEnabled(boolean)

getNextMatch

public int getNextMatch(String prefix,
                        int startIndex,
                        Position.Bias bias)
接頭辞で始まる、次のリスト要素を返します。

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

getToolTipText

public String getToolTipText(MouseEvent event)
JComponentgetToolTipText メソッドをオーバーライドして、レンダリングのヒント (テキストセットがある場合) を使用できるようにします。

注: JList がレンダリングのツールヒントを適切に表示できるようにするには、JListToolTipManager に登録済みのコンポーネントでなければなりません。これはコンストラクタで自動的に行われますが、あとで JListsetToolTipText(null) を通知すると、リストコンポーネントを登録解除するので、レンダリングからのヒントはそれ以上表示されません。

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

locationToIndex

public int locationToIndex(Point location)
JList の座標上の点をその位置にあるセルのインデックスに変換します。セルが実際にその位置を含むかどうかを判定するには、このメソッドと getCellBounds を組み合わせて使用します。モデルが空の場合は、-1 を返します。

パラメータ:
location - JList に関連したセルの座標
戻り値:
整数 -- 指定位置のセルのインデックス、または -1

indexToLocation

public Point indexToLocation(int index)
指定された項目の JList 座標における原点を返します。index が無効な場合は、null を返します。

パラメータ:
index - JList セルのインデックス
戻り値:
index で指定された番号のセルの原点

getCellBounds

public Rectangle getCellBounds(int index0,
                               int index1)
JList 座標で指定された項目範囲の境界を返します。インデックスが無効な場合は null を返します。

パラメータ:
index0 - 範囲内の最初の JList セルのインデックス
index1 - 範囲内の最後の JList セルのインデックス
戻り値:
インデックスで指定されたセルのピクセル単位の境界

getModel

public ListModel getModel()
JList コンポーネントによって表示される項目のリストを保持するデータモデルを返します。

戻り値:
表示される項目のリストを提供する ListModel
関連項目:
setModel(javax.swing.ListModel)

setModel

public void setModel(ListModel model)
リストの内容または「値」を表すモデルを設定し、PropertyChangeListener への通知後にリストの選択物をクリアします。

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

パラメータ:
model - 表示される項目のリストを提供する ListModel
例外:
IllegalArgumentException - modelnull の場合
関連項目:
getModel()

setListData

public void setListData(Object[] listData)
Object の配列から ListModel を構築し、setModel を適用します。

パラメータ:
listData - リストに表示する項目を保持する Object の配列
関連項目:
setModel(javax.swing.ListModel)

setListData

public void setListData(Vector listData)
Vector から ListModel を構築し、setModel を適用します。

パラメータ:
listData - リストに表示する項目を保持する Vector
関連項目:
setModel(javax.swing.ListModel)

createSelectionModel

protected ListSelectionModel createSelectionModel()
DefaultListSelectionModel のインスタンスを返します。このメソッドは、コンストラクタが selectionModel プロパティを初期化するのに使用します。

戻り値:
この JList が使用する ListSelectionModel
関連項目:
setSelectionModel(javax.swing.ListSelectionModel), DefaultListSelectionModel

getSelectionModel

public ListSelectionModel getSelectionModel()
現在の選択モデルの値を返します。選択モデルは、単一選択、隣接した範囲の選択、および非隣接選択の作成タスクを処理します。

戻り値:
リスト選択を実装する ListSelectionModel
関連項目:
setSelectionModel(javax.swing.ListSelectionModel), ListSelectionModel

fireSelectionValueChanged

protected void fireSelectionValueChanged(int firstIndex,
                                         int lastIndex,
                                         boolean isAdjusting)
選択モデルが変更されたことを JListListSelectionListener に通知します。このメソッドは、ListSelectionEventselectionModel から、直接 JList に追加された ListSelectionListener に転送するために使用されます。

パラメータ:
firstIndex - 選択されている最初のインデックス
lastIndex - 選択されている最後のインデックス
isAdjusting - 複数の変更が行われた場合は true
関連項目:
addListSelectionListener(javax.swing.event.ListSelectionListener), removeListSelectionListener(javax.swing.event.ListSelectionListener), EventListenerList

addListSelectionListener

public void addListSelectionListener(ListSelectionListener listener)
選択が変更されるたびに通知されるリストにリスナーを追加します。JList に直接追加されるリスナーは、(ListSelectionModel の代わりに) ListSelectionEvent.getSource() (この JList) を持ちます。

パラメータ:
listener - 追加する ListSelectionListener
関連項目:
getSelectionModel()

removeListSelectionListener

public void removeListSelectionListener(ListSelectionListener listener)
選択が変更されるたびに通知されるリスナーをリストから削除します。

パラメータ:
listener - 削除する ListSelectionListener
関連項目:
addListSelectionListener(javax.swing.event.ListSelectionListener), getSelectionModel()

getListSelectionListeners

public ListSelectionListener[] getListSelectionListeners()
この JList に addListSelectionListener() で追加されたすべての ListSelectionListener の配列を返します。

戻り値:
追加されたすべての ListSelectionListener。追加されたリスナーがない場合は空の配列
導入されたバージョン:
1.4

setSelectionModel

public void setSelectionModel(ListSelectionModel selectionModel)
リストの selectionModelnull ではない ListSelectionModel 実装に設定します。選択モデルは、単一選択、隣接した範囲の選択、および非隣接選択を作成するタスクを処理します。

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

パラメータ:
selectionModel - 選択を実装する ListSelectionModel
例外:
IllegalArgumentException - selectionModelnull の場合
関連項目:
getSelectionModel()

setSelectionMode

public void setSelectionMode(int selectionMode)
単一項目選択または複数項目選択が可能かどうかを判定します。次の selectionMode 値を指定できます。

パラメータ:
selectionMode - 可能な選択タイプを指定する整数
関連項目:
getSelectionMode()

getSelectionMode

public int getSelectionMode()
単一項目選択または複数項目選択のどちらが許容されているかを返します。

戻り値:
selectionMode プロパティの値
関連項目:
setSelectionMode(int)

getAnchorSelectionIndex

public int getAnchorSelectionIndex()
最後の addSelectionModel または setSelectionInterval 呼び出しにおける最初のインデックス引数を返します。selectionModel に委譲する簡易メソッドです。

戻り値:
最後の区間選択の先頭を示すインデックス
関連項目:
ListSelectionModel.getAnchorSelectionIndex(), addSelectionInterval(int, int), setSelectionInterval(int, int), addListSelectionListener(javax.swing.event.ListSelectionListener)

getLeadSelectionIndex

public int getLeadSelectionIndex()
最後の addSelectionInterval または setSelectionInterval 呼び出しにおける 2 番目のインデックス引数を返します。selectionModel に委譲する簡易メソッドです。

戻り値:
最後の区間選択の末尾を示すインデックス
関連項目:
ListSelectionModel.getLeadSelectionIndex(), addSelectionInterval(int, int), setSelectionInterval(int, int), addListSelectionListener(javax.swing.event.ListSelectionListener)

getMinSelectionIndex

public int getMinSelectionIndex()
選択されているセルの最小インデックスを返します。selectionModel に委譲する簡易メソッドです。

戻り値:
選択されているセルの最小インデックス
関連項目:
ListSelectionModel.getMinSelectionIndex(), addListSelectionListener(javax.swing.event.ListSelectionListener)

getMaxSelectionIndex

public int getMaxSelectionIndex()
選択されているセルの最大インデックスを返します。selectionModel に委譲する簡易メソッドです。

戻り値:
選択されているセルの最大インデックス
関連項目:
ListSelectionModel.getMaxSelectionIndex(), addListSelectionListener(javax.swing.event.ListSelectionListener)

isSelectedIndex

public boolean isSelectedIndex(int index)
指定されたインデックスが選択されている場合は true を返します。selectionModel に委譲する簡易メソッドです。

パラメータ:
index - 選択状態が照会されるインデックス
戻り値:
指定のインデックスが選択されている場合は true
関連項目:
ListSelectionModel.isSelectedIndex(int), setSelectedIndex(int), addListSelectionListener(javax.swing.event.ListSelectionListener)

isSelectionEmpty

public boolean isSelectionEmpty()
何も選択されていない場合は true を返します。selectionModel に委譲する簡易メソッドです。

戻り値:
何も選択されていない場合は true
関連項目:
ListSelectionModel.isSelectionEmpty(), clearSelection(), addListSelectionListener(javax.swing.event.ListSelectionListener)

clearSelection

public void clearSelection()
選択をクリアします。このメソッドを呼び出したあとは、isSelectionEmpty は true を返します。selectionModel に委譲する簡易メソッドです。

関連項目:
ListSelectionModel.clearSelection(), isSelectionEmpty(), addListSelectionListener(javax.swing.event.ListSelectionListener)

setSelectionInterval

public void setSelectionInterval(int anchor,
                                 int lead)
指定された区間を選択します。anchor および lead インデックスが含まれます。anchorlead より小さくなくてもかまいません。selectionModel に委譲する簡易メソッドです。anchor または leadが -1 の場合、DefaultListSelectionModel 実装は何も行いません。anchor または leadが -1 未満の場合、IndexOutOfBoundsException がスローされます。

パラメータ:
anchor - 選択する最初のインデックス
lead - 選択する最後のインデックス
例外:
IndexOutOfBoundsException - anchor または lead が -1 未満の場合
関連項目:
ListSelectionModel.setSelectionInterval(int, int), addSelectionInterval(int, int), removeSelectionInterval(int, int), addListSelectionListener(javax.swing.event.ListSelectionListener)

addSelectionInterval

public void addSelectionInterval(int anchor,
                                 int lead)
指定された区間を現在の選択に加えます。先頭および最終インデックスが含まれます。先頭インデックスが最終インデックスより小さくなくてもかまいません。selectionModel に委譲する簡易メソッドです。anchor または leadが -1 の場合、DefaultListSelectionModel 実装は何も行いません。anchor または leadが -1 未満の場合、IndexOutOfBoundsException がスローされます。

パラメータ:
anchor - 選択に追加する最初のインデックス
lead - 選択に追加する最後のインデックス
例外:
IndexOutOfBoundsException - anchor または lead が -1 未満の場合
関連項目:
ListSelectionModel.addSelectionInterval(int, int), setSelectionInterval(int, int), removeSelectionInterval(int, int), addListSelectionListener(javax.swing.event.ListSelectionListener)

removeSelectionInterval

public void removeSelectionInterval(int index0,
                                    int index1)
選択範囲を、指定された区間と現在の選択範囲との差集合に設定します。index0 および index1 インデックスが削除されます。index0index1 より小さくなくてもかまいません。selectionModel に委譲する簡易メソッドです。index0 または index1が -1 の場合、DefaultListSelectionModel 実装は何も行いません。index0 または index1が -1 未満の場合、IndexOutOfBoundsException がスローされます。

パラメータ:
index0 - 選択から削除する最初のインデックス
index1 - 選択から削除する最後のインデックス
例外:
IndexOutOfBoundsException - index0 または index1 が -1 未満の場合
関連項目:
ListSelectionModel.removeSelectionInterval(int, int), setSelectionInterval(int, int), addSelectionInterval(int, int), addListSelectionListener(javax.swing.event.ListSelectionListener)

setValueIsAdjusting

public void setValueIsAdjusting(boolean b)
データモデルの isAdjusting プロパティを true に設定し、すべての選択イベント (選択モードでリスト項目上をマウスでドラッグしている場合など) が完了した時点で単一イベントが生成されるようにします。

パラメータ:
b - プロパティ値の boolean 値
関連項目:
ListSelectionModel.setValueIsAdjusting(boolean)

getValueIsAdjusting

public boolean getValueIsAdjusting()
データモデルの isAdjusting プロパティの値を返します。複数の変更が行われている場合には true を返します。

戻り値:
複数の選択変更が発生している場合 (リスト項目上をマウスでドラッグしている場合など) は true
関連項目:
ListSelectionModel.getValueIsAdjusting()

getSelectedIndices

public int[] getSelectedIndices()
選択されているすべてのインデックスの昇順配列を返します。

戻り値:
選択されているすべてのインデックス (昇順)
関連項目:
removeSelectionInterval(int, int), addListSelectionListener(javax.swing.event.ListSelectionListener)

setSelectedIndex

public void setSelectedIndex(int index)
単一セルを選択します。

パラメータ:
index - 選択する単一セルのインデックス
関連項目:
ListSelectionModel.setSelectionInterval(int, int), isSelectedIndex(int), addListSelectionListener(javax.swing.event.ListSelectionListener)

setSelectedIndices

public void setSelectedIndices(int[] indices)
セルのセットを選択します。

パラメータ:
indices - 選択するセルのインデックスの配列
関連項目:
ListSelectionModel.addSelectionInterval(int, int), isSelectedIndex(int), addListSelectionListener(javax.swing.event.ListSelectionListener)

getSelectedValues

public Object[] getSelectedValues()
選択されたセルの値の配列を返します。値はインデックスの昇順に並べられます。

戻り値:
選択された値。何も選択されていない場合は空のリスト
関連項目:
isSelectedIndex(int), getModel(), addListSelectionListener(javax.swing.event.ListSelectionListener)

getSelectedIndex

public int getSelectedIndex()
最初に選択されたインデックスを返すか、選択項目がない場合は -1 を返します。

戻り値:
getMinSelectionIndex の値
関連項目:
getMinSelectionIndex(), addListSelectionListener(javax.swing.event.ListSelectionListener)

getSelectedValue

public Object getSelectedValue()
最初に選択されたインデックスを返すか、選択が空の場合は null を返します。

戻り値:
最初に選択された値
関連項目:
getMinSelectionIndex(), getModel(), addListSelectionListener(javax.swing.event.ListSelectionListener)

setSelectedValue

public void setSelectedValue(Object anObject,
                             boolean shouldScroll)
指定されたオブジェクトをリストから選択します。

パラメータ:
anObject - 選択するオブジェクト
shouldScroll - オブジェクトが存在し、リストをスクロールして選択したオブジェクトを表示する場合は true。そうでない場合は false

getPreferredScrollableViewportSize

public Dimension getPreferredScrollableViewportSize()
visibleRowCount の行を表示するために必要なビューポートのサイズを計算します。fixedCellWidth および fixedCellHeight プロパティが指定されている場合には、このサイズは明らかです。これらのプロパティ値は、prototypeCellValue プロパティによって暗黙に指定されることもあります。fixedCellWidth が指定されていない場合には、このサイズはもっとも幅の広いリスト要素を見つけることによって計算されます。fixedCellHeight が指定されていない場合には、次のような経験則に頼ります。 レイアウト方向が VERTICAL でない場合、getPreferredSize からの値を返します。現在の ListUI により、適切な値を返すよう getPreferredSize がオーバーライドされることが予想されます。

定義:
インタフェース Scrollable 内の getPreferredScrollableViewportSize
戻り値:
visibleRowCount 行の表示に必要なビューポートのサイズを含む寸法
関連項目:
getPreferredScrollableViewportSize(), setPrototypeCellValue(java.lang.Object)

getScrollableUnitIncrement

public int getScrollableUnitIncrement(Rectangle visibleRect,
                                      int orientation,
                                      int direction)
前または次の行 (垂直スクロール)、または文字 (水平スクロール) を表示するためにスクロールする距離を返します。水平スクロールの場合は、リストのフォントサイズを返します。フォントが null であれば、1 を返します。標準的な文字列 ("m" など) の幅ではなく、計算が容易なフォントサイズを使用しています。

垂直スクロールの場合は、下方向にスクロールする場合に (direction が 0 より大きい)、先頭行が visibleRect に対して完全に可視であれば、先頭行の高さを返します。下方向にスクロールする場合に、先頭行が部分的にのみ可視であれば、先頭行の可視分の高さを返します。同じように、上方向にスクロールする場合に、先頭行が完全に可視であれば、先頭行の上の行の高さを返します。

visibleRect の値は、this.getVisibleRect() と同じでなければなりません。

定義:
インタフェース Scrollable 内の getScrollableUnitIncrement
パラメータ:
visibleRect - 可視矩形
orientation - HORIZONTAL または VERTICAL
direction - <= 0 の場合はスクロールアップ、> 0 の場合はスクロールダウン
戻り値:
次または前の行を表示するためにスクロールする、ピクセル単位の距離
例外:
IllegalArgumentException - visibleRect が null の場合、あるいは orientation が SwingConstants.VERTICAL または SwingConstants.HORIZONTAL のどちらかでない場合
関連項目:
Scrollable.getScrollableUnitIncrement(java.awt.Rectangle, int, int)

getScrollableBlockIncrement

public int getScrollableBlockIncrement(Rectangle visibleRect,
                                       int orientation,
                                       int direction)
次または前のブロックを表示するためにスクロールする距離を返します。垂直方向のスクロールには次のルールを使用します。
  • 下にスクロールする (direction が 0 より大きい) 場合は、最後の可視要素が最初の完全な可視要素になる
  • 上にスクロールする場合は、最初の可視要素が最後の完全な可視要素になる
  • リストが空の場合は、visibleRect.height

水平方向のスクロールには、リストが水平方向に配置されている場合 (orientation が VERTICAL_WRAP または HORIZONTAL_WRAP)、次のルールを使用します。

  • 右にスクロールする (direction が 0 より大きい) 場合は、次の列が最初の可視列になる
  • 左にスクロールし、最初の列の開始位置が可視の場合は前の列が可視になる。最初の列の開始位置が不可視の場合は、それが可視になる
またリストが垂直方向に配置されているか、リストが空の場合は、visibleRect.width を使用します

visibleRect の値は、this.getVisibleRect() と同じでなければなりません。

定義:
インタフェース Scrollable 内の getScrollableBlockIncrement
パラメータ:
visibleRect - 可視矩形
orientation - HORIZONTAL または VERTICAL
direction - <= 0 の場合はスクロールアップ、> 0 の場合はスクロールダウン
戻り値:
ブロックの増分量
例外:
IllegalArgumentException - visibleRect が null の場合、あるいは orientation が SwingConstants.VERTICAL または SwingConstants.HORIZONTAL のどちらかでない場合
関連項目:
Scrollable.getScrollableUnitIncrement(java.awt.Rectangle, int, int)

getScrollableTracksViewportWidth

public boolean getScrollableTracksViewportWidth()
この JListJViewport に表示され、ビューポートが JList の適切な幅よりも広い場合、またはレイアウト方向が HORIZONTAL_WRAP であり、可視行カウントが <= 0 の場合は true を返します。そうでない場合は false を返します。false の場合、ビューポートの幅を追跡しません。これにより、JViewport 自体が JScrollPane に組み込まれている場合、水平スクロールができるようになります。

定義:
インタフェース Scrollable 内の getScrollableTracksViewportWidth
戻り値:
ビューポートが JList の適切な幅よりも広い場合は true、そうでない場合は false
関連項目:
Scrollable.getScrollableTracksViewportWidth()

getScrollableTracksViewportHeight

public boolean getScrollableTracksViewportHeight()
この JListJViewport に表示され、ビューポートが JList の適切な高さよりも高い場合、またはレイアウト方向が VERTICAL_WRAP であり、可視行カウントが <= 0 の場合は true を返します。そうでない場合は false を返します。false の場合、ビューポートの高さを追跡しません。これにより、JViewport 自体が JScrollPane に組み込まれている場合、垂直スクロールができるようになります。

定義:
インタフェース Scrollable 内の getScrollableTracksViewportHeight
戻り値:
ビューポートが Jlist の適切な高さよりも高い場合は true、そうでない場合は false
関連項目:
Scrollable.getScrollableTracksViewportHeight()

paramString

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

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

getAccessibleContext

public AccessibleContext getAccessibleContext()
この JList に関連した AccessibleContext を返します。JList の場合、AccessibleContext は AccessibleJList の形式を取ります。必要に応じて新規の AccessibleJList インスタンスが作成されます。

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

JavaTM 2
Platform
Std. Ed. v1.4.0

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

Java、Java 2D、および JDBC は米国ならびにその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.