java.awt
クラス List

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

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

Accessible, ImageObserver, ItemSelectable, MenuContainer, Serializable

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 の場合は、次のスクロールリストを作成します。

選択されていない項目をクリックすると選択され、選択済みの項目をクリックすると選択解除されます。上記の例では、新しいスクロールリストを作成する際の 2 番目の引数が false なので、同時に選択できる項目は 1 つだけです。ある項目を選択すると、ほかに選択済みの項目があれば自動的に選択解除されます。

この例に示されるリストは、可視の 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.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() リスト内の項目を返します。
EventListener[]	getListeners(Class 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() リスト中の選択されている項目をオブジェクトの配列で返します。
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 以降は、getMinimumSize(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, 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, 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, isOpaque, 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, setName, 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

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

public void addItem(String item)

推奨されていません。 add(String) を使用

add

public void add(String item,
                int index)

指定された項目を、インデックスで指定された位置でスクロールリストに追加します。インデックスはゼロから始まります。インデックスの値がゼロより小さい場合、またはリスト内の項目数以上の場合は、その項目はリストの末尾に追加されます。

パラメータ:

item - 追加される項目。このパラメータが null の場合、項目は空の文字列 "" として処理される

index - 項目を追加する位置

導入されたバージョン:

JDK1.1

addItem

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

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

public void delItem(int position)

推奨されていません。 remove(String) および remove(int) を使用

getSelectedIndex

public int getSelectedIndex()

リストで選択されている項目のインデックスを返します。

戻り値:

選択された項目のインデックス、または項目が選択されていない場合、または 1 項目以上が選択されている場合は -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()

リスト中の選択されている項目をオブジェクトの配列で返します。

定義:

インタフェース ItemSelectable 内の getSelectedObjects

関連項目:

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

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

public boolean allowsMultipleSelections()

推奨されていません。 JDK バージョン 1.1 以降は、isMultipleMode() を使用

setMultipleMode

public void setMultipleMode(boolean b)

このリストが複数選択を許すかどうかを判定するフラグを設定します。

パラメータ:

b - 複数選択が許される場合は true、そうでない場合はリストから同時に選択できる項目は 1 つだけ

導入されたバージョン:

JDK1.1

関連項目:

isMultipleMode()

setMultipleSelections

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

public Dimension preferredSize(int rows)

推奨されていません。 JDK バージョン 1.1 以降は、getPreferredSize(int) を使用

getPreferredSize

public Dimension getPreferredSize()

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

オーバーライド:

クラス Component 内の getPreferredSize

戻り値:

このスクロールリストを表示するための推奨寸法

導入されたバージョン:

JDK1.1

関連項目:

Component.getPreferredSize()

preferredSize

public Dimension preferredSize()

推奨されていません。 JDK バージョン 1.1 以降は、getPreferredSize() を使用

オーバーライド:

クラス Component 内の preferredSize

getMinimumSize

public Dimension getMinimumSize(int rows)

指定された行数を持つリストの最小寸法を返します。

パラメータ:

rows - リストの行数

戻り値:

指定された行数を表示しなければならないという条件のもとで、このスクロールリストを表示するための最小寸法

導入されたバージョン:

JDK1.1

関連項目:

Component.getMinimumSize()

minimumSize

public Dimension minimumSize(int rows)

推奨されていません。 JDK バージョン 1.1 以降は、getMinimumSize(int) を使用

getMinimumSize

public Dimension getMinimumSize()

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

オーバーライド:

クラス Component 内の getMinimumSize

戻り値:

このスクロールリストを表示するために必要な最小寸法

導入されたバージョン:

JDK1.1

関連項目:

Component.getMinimumSize()

minimumSize

public Dimension minimumSize()

推奨されていません。 JDK バージョン 1.1 以降は、getMinimumSize() を使用

オーバーライド:

クラス Component 内の minimumSize

addItemListener

public void addItemListener(ItemListener l)

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

定義:

インタフェース ItemSelectable 内の addItemListener

パラメータ:

l - 項目リスナー

導入されたバージョン:

JDK1.1

関連項目:

removeItemListener(java.awt.event.ItemListener), getItemListeners(), select(int), deselect(int), ItemEvent, ItemListener

removeItemListener

public void removeItemListener(ItemListener l)

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

定義:

インタフェース 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)

このリストからアクションイベントを受け取るために、指定されたアクションリスナーを追加します。ユーザがリスト項目をダブルクリックすると、アクションイベントが発生します。リスナー l が null の場合、例外はスローされず、処理も実行されません。

パラメータ:

l - アクションリスナー

導入されたバージョン:

JDK1.1

関連項目:

removeActionListener(java.awt.event.ActionListener), getActionListeners(), ActionEvent, ActionListener

removeActionListener

public void removeActionListener(ActionListener l)

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

パラメータ:

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 EventListener[] getListeners(Class listenerType)

この List に FooListener として、現在登録されているすべてのオブジェクトの配列を返します。FooListener は addFooListener メソッドを使用して登録されます。

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

ItemListener[] ils = (ItemListener[])(l.getListeners(ItemListener.class));

このようなリスナーが存在しない場合、このメソッドは空の配列を返します。

オーバーライド:

クラス Component 内の getListeners

パラメータ:

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 の場合、動作が指定されず例外が発生することに注意してください。

オーバーライド:

クラス 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 つが発生したときに使用可能になります。

• 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()

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

オーバーライド:

クラス Component 内の paramString

戻り値:

このスクロールリストのパラメータの文字列

delItems

public void delItems(int start,
                     int end)

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

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

定義:

インタフェース Accessible 内の getAccessibleContext

オーバーライド:

クラス Component 内の getAccessibleContext

戻り値:

この List の AccessibleContext として機能する AccessibleAWTList