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

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.BaselineResizeBehavior, 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 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 バージョン 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, 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 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 の配列で取得します。

定義:

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

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

オーバーライド:

クラス Component 内の getPreferredSize

戻り値:

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

導入されたバージョン:

JDK1.1

関連項目:

Component.getPreferredSize()

preferredSize

@Deprecated
public Dimension preferredSize()

推奨されていません。 JDK Version 1.1 以降は、getPreferredSize() に置き換えられました。

オーバーライド:

クラス Component 内の preferredSize

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

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

オーバーライド:

クラス Component 内の getMinimumSize

戻り値:

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

導入されたバージョン:

JDK1.1

関連項目:

Component.getMinimumSize()

minimumSize

@Deprecated
public Dimension minimumSize()

推奨されていません。 JDK Version 1.1 以降は、getMinimumSize() に置き換えられました。

オーバーライド:

クラス Component 内の minimumSize

addItemListener

public void addItemListener(ItemListener l)

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

AWT スレッドモデルの詳細については、「AWT Threading Issues」を参照してください。

定義:

インタフェース 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 の場合、例外はスローされず、処理も実行されません。

AWT スレッドモデルの詳細については、「AWT Threading Issues」を参照してください。

定義:

インタフェース 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 キーを押すと、アクションイベントが発生します。

リスナー l が null の場合、例外はスローされず、処理も実行されません。

AWT スレッドモデルの詳細については、「AWT Threading Issues」を参照してください。

パラメータ:

l - アクションリスナー

導入されたバージョン:

JDK1.1

関連項目:

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

removeActionListener

public void removeActionListener(ActionListener l)

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

AWT スレッドモデルの詳細については、「AWT Threading Issues」を参照してください。

パラメータ:

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));

このようなリスナーがない場合は空の配列を返します。

オーバーライド:

クラス 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

@Deprecated
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

導入されたバージョン:

1.3