JavaTM 2 Platform
Standard Ed. 5.0

java.awt
クラス List

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 はコンテナで、次のスクロールリストが作成されます。

Venus、Earth、Java ソフトウェア、および Mars を含むリストを示す。Java ソフトウェアが選択されている

List が複数選択を許可する場合に、すでに選択されている項目をクリックすると、選択が解除されます。前の例では、新しいスクロールリストの作成時に 2 番目の引数が false であるため、スクロールリストから一度に選択できる項目は 1 つに限られます。List が複数選択を許可しない場合、項目を選択すると、ほかの選択された項目の選択が解除されます。

この例に示されるリストは、可視の 4 行で作成されていることに注意してください。リストが作成されると、表示行の数は変更できません。デフォルトの List は、lst = new List()list = new List(4, false) と同等になるように 4 行で作成されます。

Java 1.1 から、Abstract Window Toolkit (AWT) は、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.BltBufferStrategy, Component.FlipBufferStrategy
 
フィールドの概要
 
クラス 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
 
コンストラクタの概要
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 バージョン 1.1 以降は、isMultipleMode() を使用します。
 void clear()
          推奨されていません。 JDK バージョン 1.1 以降は、removeAll() を使用します。
 int countItems()
          推奨されていません。 JDK バージョン 1.1 以降は、getItemCount() を使用します。
 void delItem(int position)
          推奨されていません。 remove(String) および remove(int) を使用します。
 void delItems(int start, int end)
          推奨されていません。 JDK バージョン 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)
          この ListFooListener として、現在登録されているすべてのオブジェクトの配列を返します。
 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 バージョン 1.1 以降は、isIndexSelected(int) を使用します。
 void makeVisible(int index)
          指定されたインデックスにある項目を表示させます。
 Dimension minimumSize()
          推奨されていません。 JDK バージョン 1.1 以降は、getMinimumSize() を使用します。
 Dimension minimumSize(int rows)
          推奨されていません。 JDK バージョン 1.1 以降は、getPreferredSize(int) を使用します。
protected  String paramString()
          このスクロールリストの状態を表現しているパラメータ文字列を返します。
 Dimension preferredSize()
          推奨されていません。 JDK バージョン 1.1 以降は、getPreferredSize() を使用します。
 Dimension preferredSize(int rows)
          推奨されていません。 JDK バージョン 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 バージョン 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, 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, 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()
リストのピアを作成します。ピアを使用すると、機能性を変更せずにリストの外観を変更することができます。

オーバーライド:
クラス Component 内の addNotify
関連項目:
Component.isDisplayable(), Component.removeNotify()

removeNotify

public void removeNotify()
このリストのピアを削除します。ピアを使用すると、その機能性を変更せずに外観を変更することができます。

オーバーライド:
クラス Component 内の removeNotify
関連項目:
Component.isDisplayable(), Component.addNotify()

getItemCount

public int getItemCount()
リスト内の項目の数を返します。

戻り値:
リスト内の項目の数
導入されたバージョン:
JDK1.1
関連項目:
getItem(int)

countItems

@Deprecated
public int countItems()
推奨されていません。 JDK バージョン 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 バージョン 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 の配列で取得します。

定義:
インタフェース ItemSelectable 内の getSelectedObjects
戻り値:
このスクロールリストの選択した項目を表す 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 バージョン 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 バージョン 1.1 以降は、isMultipleMode() を使用します。


setMultipleMode

public void setMultipleMode(boolean b)
このリストが複数選択を許すかどうかを判定するフラグを設定します。選択モードが複数選択から単一選択に変更されると、選択された項目は次のように変更されます。選択された項目に位置カーソルがある場合、その項目のみが選択されたままになります。選択された項目に位置カーソルがない場合、すべての項目が選択解除されます。

パラメータ:
b - 複数選択が許される場合は true、そうでない場合はリストから同時に選択できる項目は 1 つだけ
導入されたバージョン:
JDK1.1
関連項目:
isMultipleMode()

setMultipleSelections

@Deprecated
public void setMultipleSelections(boolean b)
推奨されていません。 JDK バージョン 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 バージョン 1.1 以降は、getPreferredSize(int) を使用します。


getPreferredSize

public Dimension getPreferredSize()
このスクロールリストの推奨サイズを返します。

オーバーライド:
クラス Component 内の getPreferredSize
戻り値:
このスクロールリストを表示するための推奨寸法
導入されたバージョン:
JDK1.1
関連項目:
Component.getPreferredSize()

preferredSize

@Deprecated
public Dimension preferredSize()
推奨されていません。 JDK バージョン 1.1 以降は、getPreferredSize() を使用します。

オーバーライド:
クラス Component 内の preferredSize

getMinimumSize

public Dimension getMinimumSize(int rows)
指定された行数を持つリストの最小寸法を返します。

パラメータ:
rows - リストの行数
戻り値:
指定された行数を表示しなければならないという条件のもとで、このスクロールリストを表示するための最小寸法
導入されたバージョン:
JDK1.1
関連項目:
Component.getMinimumSize()

minimumSize

@Deprecated
public Dimension minimumSize(int rows)
推奨されていません。 JDK バージョン 1.1 以降は、getPreferredSize(int) を使用します。


getMinimumSize

public Dimension getMinimumSize()
このスクロールリストの最小サイズを指定します。

オーバーライド:
クラス Component 内の getMinimumSize
戻り値:
このスクロールリストを表示するために必要な最小寸法
導入されたバージョン:
JDK1.1
関連項目:
Component.getMinimumSize()

minimumSize

@Deprecated
public Dimension minimumSize()
推奨されていません。 JDK バージョン 1.1 以降は、getMinimumSize() を使用します。

オーバーライド:
クラス Component 内の minimumSize

addItemListener

public void addItemListener(ItemListener l)
指定された項目リスナーを追加して、リストから項目イベントを受け取ります。項目イベントはユーザ入力に応答して送信されますが、select または deselect の呼び出しには応答しません。リスナー lnull の場合、例外はスローされず、処理も実行されません。

定義:
インタフェース ItemSelectable 内の addItemListener
パラメータ:
l - 項目リスナー
導入されたバージョン:
JDK1.1
関連項目:
removeItemListener(java.awt.event.ItemListener), getItemListeners(), select(int), deselect(int), ItemEvent, ItemListener

removeItemListener

public void removeItemListener(ItemListener l)
指定された項目リスナーを削除して、それがこのリストから項目イベントを受け取らないようにします。lnull の場合、例外はスローされず、処理も実行されません。

定義:
インタフェース ItemSelectable 内の removeItemListener
パラメータ:
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 キーを押すと、アクションイベントが発生します。

リスナー lnull の場合は、例外はスローされず、何も処理は行われません。

パラメータ:
l - アクションリスナー
導入されたバージョン:
JDK1.1
関連項目:
removeActionListener(java.awt.event.ActionListener), getActionListeners(), ActionEvent, ActionListener

removeActionListener

public void removeActionListener(ActionListener l)
指定されたアクションリスナーを削除し、それがこのリストからアクションイベントを受け取らないようにします。ユーザがリスト項目をダブルクリックすると、アクションイベントが発生します。リスナー lnull の場合、例外はスローされず、処理も実行されません。

パラメータ:
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)
この ListFooListener として、現在登録されているすべてのオブジェクトの配列を返します。FooListeneraddFooListener メソッドを使用して登録されます。

FooListener.class などのクラスリテラルを持つ listenerType 引数を指定できます。たとえば、次のコードを使用して、その項目リスナーの List l を照会できます。

ItemListener[] ils = (ItemListener[])(l.getListeners(ItemListener.class));
このようなリスナーがない場合は空の配列を返します。

オーバーライド:
クラス Component 内の getListeners
パラメータ:
listenerType - 要求されるリスナーの型。java.util.EventListener の下位インタフェースを指定
戻り値:
このリストの FooListener として登録されたすべてのオブジェクトの配列、またはこのようなリスナーが追加されなかった場合は空の配列
例外:
ClassCastException - listenerTypejava.util.EventListener を実装するクラスまたはインタフェースを指定しない場合
導入されたバージョン:
1.3
関連項目:
getItemListeners()

processEvent

protected void processEvent(AWTEvent e)
このスクロールリストのイベントを処理します。イベントが ItemEvent のインスタンスの場合は、processItemEvent メソッドを呼び出します。イベントが ActionEvent のインスタンスの場合は、processActionEvent を呼び出します。イベントが項目イベントやアクションイベントでない場合は、スーパークラスで processEvent を呼び出します。

イベントパラメータが null の場合の動作は定義されていないため例外がスローされます。

オーバーライド:
クラス Component 内の processEvent
パラメータ:
e - イベント
導入されたバージョン:
JDK1.1
関連項目:
ActionEvent, ItemEvent, processActionEvent(java.awt.event.ActionEvent), processItemEvent(java.awt.event.ItemEvent)

processItemEvent

protected void processItemEvent(ItemEvent e)
このリストで発生する項目イベントを、登録された ItemListener オブジェクトにディスパッチすることにより、項目イベントを処理します。

項目イベントがこのコンポーネント用に使用可能になっていないかぎり、このメソッドは呼び出されません。項目イベントは、以下の項目の 1 つが発生したときに使用可能になります。

イベントパラメータが null の場合の動作は定義されていないため例外がスローされます。

パラメータ:
e - 項目イベント
導入されたバージョン:
JDK1.1
関連項目:
ItemEvent, ItemListener, addItemListener(java.awt.event.ItemListener), Component.enableEvents(long)

processActionEvent

protected void processActionEvent(ActionEvent e)
このコンポーネントで発生するアクションイベントを、登録された ActionListener オブジェクトにディスパッチすることにより、アクションイベントを処理します。

このコンポーネントに対してアクションイベントが使用可能でない限り、このメソッドは呼び出されません。アクションイベントは、次のどちらかの場合に使用可能になります。

イベントパラメータが null の場合の動作は定義されていないため例外がスローされます。

パラメータ:
e - アクションイベント
導入されたバージョン:
JDK1.1
関連項目:
ActionEvent, ActionListener, addActionListener(java.awt.event.ActionListener), Component.enableEvents(long)

paramString

protected String paramString()
このスクロールリストの状態を表現しているパラメータ文字列を返します。この文字列はデバッグ処理に役立ちます。

オーバーライド:
クラス Component 内の paramString
戻り値:
このスクロールリストのパラメータの文字列

delItems

@Deprecated
public void delItems(int start,
                                int end)
推奨されていません。 JDK バージョン 1.1 の時点では、将来的に一般利用される予定はありません。このメソッドは、パッケージ private メソッドとしてだけ保持される予定です。


getAccessibleContext

public AccessibleContext getAccessibleContext()
この List に関連付けられた AccessibleContext を返します。リストの場合、AccessibleContextAccessibleAWTList の形式を取ります。必要に応じて、新しい AccessibleAWTList インスタンスが作成されます。

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

JavaTM 2 Platform
Standard Ed. 5.0

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

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。