🔥 Breaking News: javase/jp//docs/api/java/awt/List.html

java.lang.Object
- java.awt.Component
- - java.awt.List

すべての実装されたインタフェース:

ImageObserver, ItemSelectable, MenuContainer, Serializable, Accessible
```
public class List
extends Component
implements ItemSelectable, Accessible
```
Listコンポーネントは、ユーザーにテキスト項目のスクロール・リストを提供します。リストは、1つまたは複数の項目が選択できるように設定できます。
たとえば、次のコードは . . .
```
 List lst = new List(4, false);
 lst.add("Mercury");
 lst.add("Venus");
 lst.add("Earth");
 lst.add("JavaSoft");
 lst.add("Mars");
 lst.add("Jupiter");
 lst.add("Saturn");
 lst.add("Uranus");
 lst.add("Neptune");
 lst.add("Pluto");
 cnt.add(lst);
 
```
コンテナがcntの場合は、次のスクロール・リストを作成します。

Listが複数選択を許可する場合に、すでに選択されている項目をクリックすると、選択が解除されます。前の例では、新しいスクロール・リストの作成時に2番目の引数がfalseであるため、スクロール・リストから一度に選択できる項目は1つに限られます。 Listが複数選択を許可しない場合、項目を選択すると、ほかの選択された項目の選択が解除されます。
この例に示されるリストは、可視の4行で作成されます。リストが作成されると、表示行の数は変更できません。デフォルトのListは、lst = new List()がlist = new List(4, false)と同等になるように4行で作成されます。
Java 1.1から、Abstract Window Toolkitは、Listオブジェクトにそこで発生するすべてのマウス、キーボード、フォーカス・イベントを送ります。下位互換性のために古いAWTイベント・モデルが保持されていますが、それを使用することは非推奨です。
ユーザーによって項目が選択または選択解除されるときには、AWTはItemEventのインスタンスをリストに送ります。ユーザーがスクロール・リストの項目をダブルクリックすると、AWTは項目イベントに続いてActionEventのインスタンスをリストに送ります。 AWTは同時に、リスト内の項目が選択されている間にReturnキーが押されるとアクション・イベントを生成します。
ユーザーが選択したかまたはアクティブ化したこのリスト内の項目に基づいてアプリケーションが特定のアクションを実行しようとする場合は、ItemListenerまたはActionListenerを必要に応じて実装して、このリストからイベントを受け取る新しいリスナーを登録します。
複数選択のスクロール・リストでは、それは外部のジェスチャ(ボタンのクリックなど)を使ってアクションをトリガーするのに最適なユーザー・インタフェースと見なされます。
導入されたバージョン:

JDK1.0

関連項目:

ItemEvent, ItemListener, ActionEvent, ActionListener, 直列化された形式

ネストされたクラスのサマリー

ネストされたクラス
修飾子と型	クラス	説明
`protected class`	`List.AccessibleAWTList`	このクラスは`List`クラス用のアクセシビリティ・サポートを実装しています。

クラス java.awt.Componentから継承されたネストされたクラス/インタフェース
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

フィールドのサマリー
- クラス java.awt.Componentから継承されたフィールド
  accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
- インタフェース java.awt.image.ImageObserverから継承されたフィールド
  ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

コンストラクタのサマリー

コンストラクタ
コンストラクタ	説明
`List()`	新しいスクロール・リストを作成します。
`List(int rows)`	指定された表示行の数により初期化された新しいスクロール・リストを作成します。
`List(int rows, boolean multipleMode)`	指定された行数を表示するように初期化された新しいスクロール・リストを作成します。

メソッドのサマリー

すべてのメソッドインスタンス・メソッド具象メソッド非推奨のメソッド
修飾子と型	メソッド	説明
`void`	`add(String item)`	指定された項目をスクロール・リストの末尾に追加します。
`void`	`add(String item, int index)`	指定された項目を、インデックスで指定された位置でスクロール・リストに追加します。
`void`	`addActionListener(ActionListener l)`	このリストからアクション・イベントを受け取るために、指定されたアクション・リスナーを追加します。
`void`	`addItem(String item)`	非推奨。 `add(String)`に置き換えられています。
`void`	`addItem(String item, int index)`	非推奨。 `add(String, int)`に置き換えられています。
`void`	`addItemListener(ItemListener l)`	指定された項目リスナーを追加して、リストから項目イベントを受け取ります。
`void`	`addNotify()`	リストのピアを作成します。
`boolean`	`allowsMultipleSelections()`	非推奨。 JDK version 1.1以降は、`isMultipleMode()`に置き換えられています。
`void`	`clear()`	非推奨。 JDK version 1.1以降は、`removeAll()`に置き換えられています。
`int`	`countItems()`	非推奨。 JDK version 1.1以降は、`getItemCount()`に置き換えられています。
`void`	`delItem(int position)`	非推奨。 `remove(String)`および`remove(int)`に置き換えられています。
`void`	`delItems(int start, int end)`	非推奨。 JDK Version 1.1の時点では、将来的に一般利用される予定はありません。このメソッドは、パッケージprivateメソッドとしてのみ保持されるように想定されています。
`void`	`deselect(int index)`	指定されたインデックスにある項目を選択解除します。
`AccessibleContext`	`getAccessibleContext()`	この`List`に関連付けられた`AccessibleContext`を取得します。
`ActionListener[]`	`getActionListeners()`	このリストに登録されたすべてのアクション・リスナーの配列を返します。
`String`	`getItem(int index)`	指定するインデックスに対応する項目を返します。
`int`	`getItemCount()`	リスト内の項目の数を返します。
`ItemListener[]`	`getItemListeners()`	このリストに登録されたすべての項目リスナーの配列を返します。
`String[]`	`getItems()`	リスト内の項目を返します。
`<T extends EventListener> T[]`	`getListeners(Class<T> listenerType)`	この`List`に`FooListener`として現在登録されているすべてのオブジェクトの配列を返します。
`Dimension`	`getMinimumSize()`	このスクロール・リストの最小サイズを指定します。
`Dimension`	`getMinimumSize(int rows)`	指定された行数を持つリストの最小サイズを取得します。
`Dimension`	`getPreferredSize()`	このスクロール・リストの推奨サイズを返します。
`Dimension`	`getPreferredSize(int rows)`	指定された行数を持つリストの推奨寸法を返します。
`int`	`getRows()`	リストの表示行の数を返します。
`int`	`getSelectedIndex()`	リストで選択されている項目のインデックスを返します。
`int[]`	`getSelectedIndexes()`	リストで選択されているインデックスを返します。
`String`	`getSelectedItem()`	このスクロール・リストで選択されている項目を返します。
`String[]`	`getSelectedItems()`	このスクロール・リストで選択されている項目を返します。
`Object[]`	`getSelectedObjects()`	このスクロール・リストの選択されている項目をObjectの配列で取得します。
`int`	`getVisibleIndex()`	メソッド`makeVisible`によって最後に表示された項目のインデックスを取得します。
`boolean`	`isIndexSelected(int index)`	このスクロール・リストで指定された項目が選択されているかどうかを判定します。
`boolean`	`isMultipleMode()`	このリストが複数選択を許すかどうかを判定します。
`boolean`	`isSelected(int index)`	非推奨。 JDK version 1.1以降は、`isIndexSelected(int)`に置き換えられています。
`void`	`makeVisible(int index)`	指定されたインデックスにある項目を表示させます。
`Dimension`	`minimumSize()`	非推奨。 JDK version 1.1以降は、`getMinimumSize()`に置き換えられています。
`Dimension`	`minimumSize(int rows)`	非推奨。 JDK version 1.1以降は、`getMinimumSize(int)`に置き換えられています。
`protected String`	`paramString()`	このスクロール・リストの状態を表現しているパラメータ文字列を返します。
`Dimension`	`preferredSize()`	非推奨。 JDK version 1.1以降は、`getPreferredSize()`に置き換えられています。
`Dimension`	`preferredSize(int rows)`	非推奨。 JDK version 1.1以降は、`getPreferredSize(int)`に置き換えられています。
`protected void`	`processActionEvent(ActionEvent e)`	このコンポーネントで発生するアクション・イベントを、登録されているすべての`ActionListener`オブジェクトにディスパッチすることによって処理します。
`protected void`	`processEvent(AWTEvent e)`	このスクロール・リストのイベントを処理します。
`protected void`	`processItemEvent(ItemEvent e)`	このリストで発生する項目イベントを、登録されているすべての`ItemListener`オブジェクトにディスパッチすることによって処理します。
`void`	`remove(int position)`	指定された位置にある項目をこのスクロール・リストから削除します。
`void`	`remove(String item)`	リスト中の同じ項目のうち最初に出現したものを削除します。
`void`	`removeActionListener(ActionListener l)`	指定されたアクション・リスナーを削除し、それがこのリストからアクション・イベントを受け取らないようにします。
`void`	`removeAll()`	このリストからすべての項目を削除します。
`void`	`removeItemListener(ItemListener l)`	指定された項目リスナーを削除して、それがこのリストから項目イベントを受け取らないようにします。
`void`	`removeNotify()`	このリストのピアを削除します。
`void`	`replaceItem(String newValue, int index)`	スクロール・リスト内の指定されたインデックスにある項目を新しい文字列で置き換えます。
`void`	`select(int index)`	スクロール・リストの指定されたインデックスにある項目を選択します。
`void`	`setMultipleMode(boolean b)`	このリストが複数選択を許すかどうかを判定するフラグを設定します。
`void`	`setMultipleSelections(boolean b)`	非推奨。 JDK version 1.1以降は、`setMultipleMode(boolean)`に置き換えられています。

クラス java.awt.Componentから継承されたメソッド
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, deliverEvent, disable, disableEvents, dispatchEvent, doLayout, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getAlignmentX, getAlignmentY, getBackground, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentAt, getComponentAt, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeys, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMaximumSize, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, invalidate, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusCycleRoot, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, layout, list, list, list, list, list, locate, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paint, paintAll, postEvent, prepareImage, prepareImage, print, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, revalidate, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeys, setFocusTraversalKeysEnabled, setFont, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle, update, validate

クラス java.lang.Objectから継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- コンストラクタの詳細
  - List
```
public List()
     throws HeadlessException
```
    新しいスクロール・リストを作成します。デフォルトでは、4行が表示されており、複数の選択はできません。これはList(0, false)の簡易メソッドです。また、リストに表示される行数は、作成後に変更できません。
    
    例外:
    
    HeadlessException - GraphicsEnvironment.isHeadless()がtrueを返した場合。
    
    関連項目:
    
    GraphicsEnvironment.isHeadless()
  - List
```
public List(int rows)
     throws HeadlessException
```
    指定された表示行の数により初期化された新しいスクロール・リストを作成します。デフォルトでは、複数の選択はできません。これはList(rows, false)の簡易メソッドです。また、リストに表示される行数は作成後に変更できません。
    
    パラメータ:
    
    rows - 表示する項目の数。
    
    例外:
    
    HeadlessException - GraphicsEnvironment.isHeadless()がtrueを返した場合。
    
    導入されたバージョン:
    
    JDK1.1
    
    関連項目:
    
    GraphicsEnvironment.isHeadless()
  - List
```
public List(int rows,
            boolean multipleMode)
     throws HeadlessException
```
    指定された行数を表示するように初期化された新しいスクロール・リストを作成します。行数0が指定された場合、リストはデフォルトの4行で作成されます。また、リストに表示される行数は作成後に変更できません。 multipleModeの値がtrueの場合、ユーザーはリストから複数の項目を選択できます。 falseの場合、一度に1項目のみ選択できます。
    
    パラメータ:
    
    rows - 表示する項目の数。
    
    multipleMode - trueの場合、複数選択が許可される。そうでない場合、リストから同時に選択できる項目は1つだけ。
    
    例外:
    
    HeadlessException - GraphicsEnvironment.isHeadless()がtrueを返した場合。
    
    関連項目:
    
    GraphicsEnvironment.isHeadless()
- メソッドの詳細
  - addNotify
```
public void addNotify()
```
    リストのピアを作成します。ピアを使用すると、その機能性を変更せずに外観を変更することができます。
    
    オーバーライド:
    
    addNotify、クラスComponent
    
    関連項目:
    
    Component.isDisplayable(), Component.removeNotify(), Component.invalidate()
  - removeNotify
```
public void removeNotify()
```
    このリストのピアを削除します。ピアを使用すると、その機能性を変更せずに外観を変更することができます。
    
    オーバーライド:
    
    removeNotify、クラスComponent
    
    関連項目:
    
    Component.isDisplayable(), Component.addNotify()
  - getItemCount
```
public int getItemCount()
```
    リスト内の項目の数を返します。
    
    戻り値:
    
    リスト内の項目の数
    
    導入されたバージョン:
    
    JDK1.1
    
    関連項目:
    
    getItem(int)
  - countItems
```
@Deprecated
public int countItems()
```
    非推奨。 JDK version 1.1以降は、getItemCount()に置き換えられています。
  - getItem
```
public String getItem(int index)
```
    指定するインデックスに対応する項目を返します。
    
    パラメータ:
    
    index - 項目の位置
    
    戻り値:
    
    指定されたインデックスに関連付けられた項目
    
    関連項目:
    
    getItemCount()
  - getItems
```
public String[] getItems()
```
    リスト内の項目を返します。
    
    戻り値:
    
    リストの項目を格納する文字列の配列
    
    導入されたバージョン:
    
    JDK1.1
    
    関連項目:
    
    select(int), deselect(int), isIndexSelected(int)
  - add
```
public void add(String item)
```
    指定された項目をスクロール・リストの末尾に追加します。
    
    パラメータ:
    
    item - 追加される項目
    
    導入されたバージョン:
    
    JDK1.1
  - addItem
```
@Deprecated
public void addItem(String item)
```
    非推奨。 add(String)に置き換えられています。
  - add
```
public void add(String item,
                int index)
```
    指定された項目を、インデックスで指定された位置でスクロール・リストに追加します。インデックスはゼロから始まります。インデックスの値がゼロより小さい場合、またはリスト内の項目数以上の場合は、その項目はリストの末尾に追加されます。
    
    パラメータ:
    
    item - 追加される項目。このパラメータがnullの場合、項目は空の文字列""として扱われる
    
    index - 項目を追加する位置
    
    導入されたバージョン:
    
    JDK1.1
  - addItem
```
@Deprecated
public void addItem(String item,
                                int index)
```
    非推奨。 add(String, int)に置き換えられています。
  - replaceItem
```
public void replaceItem(String newValue,
                        int index)
```
    スクロール・リスト内の指定されたインデックスにある項目を新しい文字列で置き換えます。
    
    パラメータ:
    
    newValue - 既存の項目を置き換える新しい文字列
    
    index - 置き換える項目の位置
    
    例外:
    
    ArrayIndexOutOfBoundsException - indexが範囲外の場合
  - removeAll
```
public void removeAll()
```
    このリストからすべての項目を削除します。
    
    導入されたバージョン:
    
    JDK1.1
    
    関連項目:
    
    remove(java.lang.String), delItems(int, int)
  - clear
```
@Deprecated
public void clear()
```
    非推奨。 JDK version 1.1以降は、removeAll()に置き換えられています。
  - remove
```
public void remove(String item)
```
    リスト中の同じ項目のうち最初に出現したものを削除します。指定された項目が選択されており、それがリスト内で唯一選択された項目である場合、リストの選択はなくなります。
    
    パラメータ:
    
    item - リストから削除される項目
    
    例外:
    
    IllegalArgumentException - その項目がリストに存在しない場合
    
    導入されたバージョン:
    
    JDK1.1
  - remove
```
public void remove(int position)
```
    指定された位置にある項目をこのスクロール・リストから削除します。指定された位置の項目が選択されており、それがリスト内で唯一選択された項目である場合、リストの選択はなくなります。
    
    パラメータ:
    
    position - 削除される項目のインデックス
    
    例外:
    
    ArrayIndexOutOfBoundsException - positionが0より小さいか、getItemCount()-1より大きい場合
    
    導入されたバージョン:
    
    JDK1.1
    
    関連項目:
    
    add(String, int)
  - delItem
```
@Deprecated
public void delItem(int position)
```
    非推奨。 remove(String)およびremove(int)に置き換えられています。
  - getSelectedIndex
```
public int getSelectedIndex()
```
    リストで選択されている項目のインデックスを返します。
    
    戻り値:
    
    選択された項目のインデックス。項目が選択されていない場合、または複数の項目が選択された場合は、-1が返される。
    
    関連項目:
    
    select(int), deselect(int), isIndexSelected(int)
  - getSelectedIndexes
```
public int[] getSelectedIndexes()
```
    リストで選択されているインデックスを返します。
    
    戻り値:
    
    このスクロール・リストで選択されているインデックスの配列。項目が選択されていない場合は、長さゼロの配列が返される
    
    関連項目:
    
    select(int), deselect(int), isIndexSelected(int)
  - getSelectedItem
```
public String getSelectedItem()
```
    このスクロール・リストで選択されている項目を返します。
    
    戻り値:
    
    リストで選択されている項目。項目が選択されていない場合、または複数の項目が選択された場合は、nullが返される。
    
    関連項目:
    
    select(int), deselect(int), isIndexSelected(int)
  - getSelectedItems
```
public String[] getSelectedItems()
```
    このスクロール・リストで選択されている項目を返します。
    
    戻り値:
    
    このスクロール・リストで選択されている項目の配列。項目が選択されていない場合は、長さゼロの配列が返される
    
    関連項目:
    
    select(int), deselect(int), isIndexSelected(int)
  - getSelectedObjects
```
public Object[] getSelectedObjects()
```
    このスクロール・リストの選択されている項目をObjectの配列で取得します。
    
    定義:
    
    getSelectedObjects、インタフェースItemSelectable
    
    戻り値:
    
    このスクロール・リストで選択されている項目を表すObjectの配列。項目が選択されていない場合は、長さゼロの配列が返される。
    
    関連項目:
    
    getSelectedItems(), ItemSelectable
  - select
```
public void select(int index)
```
    スクロール・リストの指定されたインデックスにある項目を選択します。
    範囲外のパラメータを渡すことは無効であり、特定できない動作が発生します。
    このメソッドは、主にこのコンポーネント内の項目を初期状態で選択するために使用されます。このメソッドをプログラムによって呼び出した場合、ItemEventはトリガーされません。 ItemEventをトリガーするための唯一の方法は、ユーザーの操作です。
    
    パラメータ:
    
    index - 選択する項目の位置
    
    関連項目:
    
    getSelectedItem(), deselect(int), isIndexSelected(int)
  - deselect
```
public void deselect(int index)
```
    指定されたインデックスにある項目を選択解除します。
    範囲外のパラメータを渡すことは無効であり、特定できない動作が発生します。
    指定されたインデックスの項目が選択されていない場合、操作は無視されます。
    
    パラメータ:
    
    index - 選択を解除する項目の位置
    
    関連項目:
    
    select(int), getSelectedItem(), isIndexSelected(int)
  - isIndexSelected
```
public boolean isIndexSelected(int index)
```
    このスクロール・リストで指定された項目が選択されているかどうかを判定します。
    
    パラメータ:
    
    index - チェック対象の項目
    
    戻り値:
    
    指定された項目が選択されている場合はtrue、そうでない場合はfalse
    
    導入されたバージョン:
    
    JDK1.1
    
    関連項目:
    
    select(int), deselect(int)
  - isSelected
```
@Deprecated
public boolean isSelected(int index)
```
    非推奨。 JDK version 1.1以降は、isIndexSelected(int)に置き換えられています。
  - getRows
```
public int getRows()
```
    リストの表示行の数を返します。 Listが作成されると、この数は変更できません。
    
    戻り値:
    
    このスクロール・リストの表示行の数
  - isMultipleMode
```
public boolean isMultipleMode()
```
    このリストが複数選択を許すかどうかを判定します。
    
    戻り値:
    
    このリストで複数選択が許可されている場合はtrue、そうでない場合はfalse
    
    導入されたバージョン:
    
    JDK1.1
    
    関連項目:
    
    setMultipleMode(boolean)
  - allowsMultipleSelections
```
@Deprecated
public boolean allowsMultipleSelections()
```
    非推奨。 JDK version 1.1以降は、isMultipleMode()に置き換えられています。
  - setMultipleMode
```
public void setMultipleMode(boolean b)
```
    このリストが複数選択を許すかどうかを判定するフラグを設定します。選択モードが複数選択から単一選択に変更されると、選択された項目は次のように変更されます。選択された項目に位置カーソルがある場合、その項目のみが選択されたままになります。選択された項目に位置カーソルがない場合、すべての項目が選択解除されます。
    
    パラメータ:
    
    b - trueの場合は複数選択が許可される。そうでない場合はリストから同時に選択できる項目は1つだけ
    
    導入されたバージョン:
    
    JDK1.1
    
    関連項目:
    
    isMultipleMode()
  - setMultipleSelections
```
@Deprecated
public void setMultipleSelections(boolean b)
```
    非推奨。 JDK version 1.1以降は、setMultipleMode(boolean)に置き換えられています。
  - getVisibleIndex
```
public int getVisibleIndex()
```
    メソッドmakeVisibleによって最後に表示された項目のインデックスを取得します。
    
    戻り値:
    
    最後に表示された項目のインデックス
    
    関連項目:
    
    makeVisible(int)
  - makeVisible
```
public void makeVisible(int index)
```
    指定されたインデックスにある項目を表示させます。
    
    パラメータ:
    
    index - 項目の位置
    
    関連項目:
    
    getVisibleIndex()
  - getPreferredSize
```
public Dimension getPreferredSize(int rows)
```
    指定された行数を持つリストの推奨寸法を返します。
    
    パラメータ:
    
    rows - リスト内の行の数
    
    戻り値:
    
    指定された行数を表示しなければならないという条件のもとで、このスクロール・リストを表示するための推奨寸法
    
    導入されたバージョン:
    
    JDK1.1
    
    関連項目:
    
    Component.getPreferredSize()
  - preferredSize
```
@Deprecated
public Dimension preferredSize(int rows)
```
    非推奨。 JDK version 1.1以降は、getPreferredSize(int)に置き換えられています。
  - getPreferredSize
```
public Dimension getPreferredSize()
```
    このスクロール・リストの推奨サイズを返します。
    
    オーバーライド:
    
    getPreferredSize、クラスComponent
    
    戻り値:
    
    このスクロール・リストを表示するための推奨寸法
    
    導入されたバージョン:
    
    JDK1.1
    
    関連項目:
    
    Component.getPreferredSize()
  - preferredSize
```
@Deprecated
public Dimension preferredSize()
```
    非推奨。 JDK version 1.1以降は、getPreferredSize()に置き換えられています。
    
    オーバーライド:
    
    preferredSize、クラスComponent
  - getMinimumSize
```
public Dimension getMinimumSize(int rows)
```
    指定された行数を持つリストの最小サイズを取得します。
    
    パラメータ:
    
    rows - リスト内の行の数
    
    戻り値:
    
    指定された行数を表示しなければならないという条件のもとで、このスクロール・リストを表示するための最小寸法
    
    導入されたバージョン:
    
    JDK1.1
    
    関連項目:
    
    Component.getMinimumSize()
  - minimumSize
```
@Deprecated
public Dimension minimumSize(int rows)
```
    非推奨。 JDK version 1.1以降は、getMinimumSize(int)に置き換えられています。
  - getMinimumSize
```
public Dimension getMinimumSize()
```
    このスクロール・リストの最小サイズを指定します。
    
    オーバーライド:
    
    getMinimumSize、クラスComponent
    
    戻り値:
    
    このスクロール・リストを表示するために必要な最小寸法
    
    導入されたバージョン:
    
    JDK1.1
    
    関連項目:
    
    Component.getMinimumSize()
  - minimumSize
```
@Deprecated
public Dimension minimumSize()
```
    非推奨。 JDK version 1.1以降は、getMinimumSize()に置き換えられています。
    
    オーバーライド:
    
    minimumSize、クラスComponent
  - addItemListener
```
public void addItemListener(ItemListener l)
```
    指定された項目リスナーを追加して、リストから項目イベントを受け取ります。項目イベントはselectまたはdeselectの呼出しではなく、ユーザーの入力に反応してリスナーに送信されます。リスナーlがnullである場合、例外はスローされず、何も処理は行われません。
    AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。
    
    定義:
    
    addItemListener、インタフェースItemSelectable
    
    パラメータ:
    
    l - 項目リスナー
    
    導入されたバージョン:
    
    JDK1.1
    
    関連項目:
    
    removeItemListener(java.awt.event.ItemListener), getItemListeners(), select(int), deselect(int), ItemEvent, ItemListener
  - removeItemListener
```
public void removeItemListener(ItemListener l)
```
    指定された項目リスナーを削除して、それがこのリストから項目イベントを受け取らないようにします。リスナーlがnullである場合、例外はスローされず、何も処理は行われません。
    AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。
    
    定義:
    
    removeItemListener、インタフェースItemSelectable
    
    パラメータ:
    
    l - 項目リスナー
    
    導入されたバージョン:
    
    JDK1.1
    
    関連項目:
    
    addItemListener(java.awt.event.ItemListener), getItemListeners(), ItemEvent, ItemListener
  - getItemListeners
```
public ItemListener[] getItemListeners()
```
    このリストに登録されたすべての項目リスナーの配列を返します。
    
    戻り値:
    
    このリストのすべてのItemListener。項目リスナーが現在登録されていない場合は空の配列
    
    導入されたバージョン:
    
    1.4
    
    関連項目:
    
    addItemListener(java.awt.event.ItemListener), removeItemListener(java.awt.event.ItemListener), ItemEvent, ItemListener
  - addActionListener
```
public void addActionListener(ActionListener l)
```
    このリストからアクション・イベントを受け取るために、指定されたアクション・リスナーを追加します。ユーザーがリスト項目をダブルクリックするか、またはリストにキーボード・フォーカスがある場合にEnterキーを押すと、アクション・イベントが発生します。
    リスナーlがnullである場合、例外はスローされず、何も処理は行われません。
    AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。
    
    パラメータ:
    
    l - アクション・リスナー
    
    導入されたバージョン:
    
    JDK1.1
    
    関連項目:
    
    removeActionListener(java.awt.event.ActionListener), getActionListeners(), ActionEvent, ActionListener
  - removeActionListener
```
public void removeActionListener(ActionListener l)
```
    指定されたアクション・リスナーを削除し、それがこのリストからアクション・イベントを受け取らないようにします。ユーザーがリスト項目をダブルクリックすると、アクション・イベントが発生します。リスナーlがnullである場合、例外はスローされず、何も処理は行われません。
    AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。
    
    パラメータ:
    
    l - アクション・リスナー
    
    導入されたバージョン:
    
    JDK1.1
    
    関連項目:
    
    addActionListener(java.awt.event.ActionListener), getActionListeners(), ActionEvent, ActionListener
  - getActionListeners
```
public ActionListener[] getActionListeners()
```
    このリストに登録されたすべてのアクション・リスナーの配列を返します。
    
    戻り値:
    
    このリストのすべてのActionListener。アクション・リスナーが現在登録されていない場合は空の配列
    
    導入されたバージョン:
    
    1.4
    
    関連項目:
    
    addActionListener(java.awt.event.ActionListener), removeActionListener(java.awt.event.ActionListener), ActionEvent, ActionListener
  - getListeners
```
public <T extends EventListener> T[] getListeners(Class<T> listenerType)
```
    このListにFooListenerとして現在登録されているすべてのオブジェクトの配列を返します。 FooListenerは、addFooListenerメソッドを使用して登録されます。
    FooListener.classなどのクラス・リテラルを使用してlistenerType引数を指定できます。たとえば、次のコードを使用して、その項目リスナーのList lを照会できます。
```
ItemListener[] ils = (ItemListener[])(l.getListeners(ItemListener.class));
```
    このようなリスナーがない場合は空の配列を返します。
    オーバーライド:
    
    getListeners、クラスComponent
    
    パラメータ:
    
    listenerType - 要求されるリスナーの型。java.util.EventListenerの子孫のインタフェースを指定してください
    
    戻り値:
    
    このリスト上でFooListenerとして登録されたすべてのオブジェクトの配列、またはこのようなリスナーが追加されていない場合は空の配列
    
    例外:
    
    ClassCastException - listenerTypeで、java.util.EventListenerを実装するクラスまたはインタフェースが指定されなかった場合
    
    導入されたバージョン:
    
    1.3
    
    関連項目:
    
    getItemListeners()
  - processEvent
```
protected void processEvent(AWTEvent e)
```
    このスクロール・リストのイベントを処理します。イベントがItemEventのインスタンスである場合は、processItemEventメソッドを呼び出します。イベントがActionEventのインスタンスの場合は、processActionEventを呼び出します。イベントが項目イベントやアクション・イベントでない場合は、スーパー・クラスでprocessEventを呼び出します。
    イベント・パラメータがnullである場合は、動作が未指定のため、例外が発生する可能性があります。
    
    オーバーライド:
    
    processEvent、クラスComponent
    
    パラメータ:
    
    e - イベント
    
    導入されたバージョン:
    
    JDK1.1
    
    関連項目:
    
    ActionEvent, ItemEvent, processActionEvent(java.awt.event.ActionEvent), processItemEvent(java.awt.event.ItemEvent)
  - processItemEvent
```
protected void processItemEvent(ItemEvent e)
```
    このリストで発生する項目イベントを、登録されているすべてのItemListenerオブジェクトにディスパッチすることによって処理します。
    項目イベントがこのコンポーネント用に使用可能になっていないかぎり、このメソッドは呼び出されません。項目イベントは、次の項目の1つが発生したときに使用可能になります。
    - ItemListenerオブジェクトがaddItemListenerによって登録されている。
    - enableEventsによって項目イベントが使用可能になっている。
    イベント・パラメータがnullである場合は、動作が未指定のため、例外が発生する可能性があります。
    パラメータ:
    
    e - 項目イベント
    
    導入されたバージョン:
    
    JDK1.1
    
    関連項目:
    
    ItemEvent, ItemListener, addItemListener(java.awt.event.ItemListener), Component.enableEvents(long)
  - processActionEvent
```
protected void processActionEvent(ActionEvent e)
```
    このコンポーネントで発生するアクション・イベントを、登録されているすべてのActionListenerオブジェクトにディスパッチすることによって処理します。
    このコンポーネントに対してアクション・イベントが使用可能でないかぎり、このメソッドは呼び出されません。アクション・イベントは、次のどちらかの場合に使用可能になります。
    - ActionListenerオブジェクトがaddActionListenerによって登録されている。
    - enableEventsによってアクション・イベントが使用可能になっている。
    イベント・パラメータがnullである場合は、動作が未指定のため、例外が発生する可能性があります。
    パラメータ:
    
    e - アクション・イベント
    
    導入されたバージョン:
    
    JDK1.1
    
    関連項目:
    
    ActionEvent, ActionListener, addActionListener(java.awt.event.ActionListener), Component.enableEvents(long)
  - paramString
```
protected String paramString()
```
    このスクロール・リストの状態を表現しているパラメータ文字列を返します。この文字列はデバッグの際に便利です。
    
    オーバーライド:
    
    paramString、クラスComponent
    
    戻り値:
    
    このスクロール・リストのパラメータの文字列
  - delItems
```
@Deprecated
public void delItems(int start,
                                 int end)
```
    非推奨。 JDK Version 1.1の時点では、将来的に一般利用される予定はありません。このメソッドは、パッケージprivateメソッドとしてのみ保持されるように想定されています。
  - getAccessibleContext
```
public AccessibleContext getAccessibleContext()
```
    このListに関連付けられたAccessibleContextを取得します。リストの場合、AccessibleContextはAccessibleAWTListの形式を取ります。必要に応じて、新しいAccessibleAWTListインスタンスが作成されます。
    
    定義:
    
    getAccessibleContext、インタフェースAccessible
    
    オーバーライド:
    
    getAccessibleContext、クラスComponent
    
    戻り値:
    
    このListのAccessibleContextとして機能するAccessibleAWTList
    
    導入されたバージョン:
    
    1.3

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。

クラスList

ネストされたクラスのサマリー

クラス java.awt.Componentから継承されたネストされたクラス/インタフェース

フィールドのサマリー

クラス java.awt.Componentから継承されたフィールド

インタフェース java.awt.image.ImageObserverから継承されたフィールド

コンストラクタのサマリー

メソッドのサマリー

クラス java.awt.Componentから継承されたメソッド

クラス java.lang.Objectから継承されたメソッド

コンストラクタの詳細

List

List

List

メソッドの詳細

addNotify

removeNotify

getItemCount

countItems

getItem

getItems

add

addItem

add

addItem

replaceItem

removeAll

clear

remove

remove

delItem

getSelectedIndex

getSelectedIndexes

getSelectedItem

getSelectedItems

getSelectedObjects

select

deselect

isIndexSelected

isSelected

getRows

isMultipleMode

allowsMultipleSelections

setMultipleMode

setMultipleSelections

getVisibleIndex

makeVisible

getPreferredSize

preferredSize

getPreferredSize

preferredSize

getMinimumSize

minimumSize

getMinimumSize

minimumSize

addItemListener

removeItemListener

getItemListeners

addActionListener

removeActionListener

getActionListeners

getListeners

processEvent

processItemEvent

processActionEvent

paramString

delItems

getAccessibleContext