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
を必要に応じて実装して、このリストからイベントを受け取る新しいリスナーを登録します。
複数選択のスクロールリストでは、それは外部のジェスチャー (ボタンのクリックなど) を使ってアクションをトリガーするのに最適なユーザーインタフェースと見なされます。
ItemEvent
, ItemListener
, ActionEvent
, ActionListener
, 直列化された形式修飾子と型 | クラスと説明 |
---|---|
protected class |
List.AccessibleAWTList
このクラスは
List クラス用のアクセシビリティーサポートを実装しています。 |
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
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> |
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) に置き換えられています。 |
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
public List() throws HeadlessException
List(0, false)
の簡易メソッドです。また、リストに表示される行数は、作成後に変更できません。HeadlessException
- GraphicsEnvironment.isHeadless() が true を返した場合。GraphicsEnvironment.isHeadless()
public List(int rows) throws HeadlessException
List(rows, false)
の簡易メソッドです。また、リストに表示される行数は作成後に変更できません。rows
- 表示する項目の数。HeadlessException
- GraphicsEnvironment.isHeadless() が true を返した場合。GraphicsEnvironment.isHeadless()
public List(int rows, boolean multipleMode) throws HeadlessException
multipleMode
の値が true
の場合、ユーザーはリストから複数の項目を選択できます。 false
の場合、一度に 1 項目のみ選択できます。rows
- 表示する項目の数。multipleMode
- true
の場合、複数選択が許可される。そうでない場合、リストから同時に選択できる項目は 1 つだけ。HeadlessException
- GraphicsEnvironment.isHeadless() が true を返した場合。GraphicsEnvironment.isHeadless()
public void addNotify()
addNotify
、クラス: Component
Component.isDisplayable()
, Component.removeNotify()
, Component.invalidate()
public void removeNotify()
removeNotify
、クラス: Component
Component.isDisplayable()
, Component.addNotify()
public int getItemCount()
getItem(int)
@Deprecated public int countItems()
getItemCount()
に置き換えられています。public String getItem(int index)
index
- 項目の位置getItemCount()
public String[] getItems()
select(int)
, deselect(int)
, isIndexSelected(int)
public void add(String item)
item
- 追加される項目@Deprecated public void addItem(String item)
add(String)
に置き換えられています。public void add(String item, int index)
item
- 追加される項目。このパラメータが null
の場合、項目は空の文字列 ""
として扱われるindex
- 項目を追加する位置@Deprecated public void addItem(String item, int index)
add(String, int)
に置き換えられています。public void replaceItem(String newValue, int index)
newValue
- 既存の項目を置き換える新しい文字列index
- 置き換える項目の位置ArrayIndexOutOfBoundsException
- index
が範囲外の場合public void removeAll()
remove(java.lang.String)
, delItems(int, int)
@Deprecated public void clear()
removeAll()
に置き換えられています。public void remove(String item)
item
- リストから削除される項目IllegalArgumentException
- その項目がリストに存在しない場合public void remove(int position)
position
- 削除される項目のインデックスArrayIndexOutOfBoundsException
- position
が 0 より小さいか、getItemCount()-1
より大きい場合add(String, int)
@Deprecated public void delItem(int position)
remove(String)
および remove(int)
に置き換えられています。public int getSelectedIndex()
-1
が返される。select(int)
, deselect(int)
, isIndexSelected(int)
public int[] getSelectedIndexes()
select(int)
, deselect(int)
, isIndexSelected(int)
public String getSelectedItem()
null
が返される。select(int)
, deselect(int)
, isIndexSelected(int)
public String[] getSelectedItems()
select(int)
, deselect(int)
, isIndexSelected(int)
public Object[] getSelectedObjects()
getSelectedObjects
、インタフェース: ItemSelectable
Object
の配列。項目が選択されていない場合は、長さゼロの配列が返される。getSelectedItems()
, ItemSelectable
public void select(int index)
範囲外のパラメータを渡すことは無効であり、特定できない動作が発生します。
このメソッドは、主にこのコンポーネント内の項目を初期状態で選択するために使用されます。このメソッドをプログラムによって呼び出した場合、ItemEvent
はトリガーされません。ItemEvent
をトリガーするための唯一の方法は、ユーザーの操作です。
index
- 選択する項目の位置getSelectedItem()
, deselect(int)
, isIndexSelected(int)
public void deselect(int index)
範囲外のパラメータを渡すことは無効であり、特定できない動作が発生します。
指定されたインデックスの項目が選択されていない場合、操作は無視されます。
index
- 選択を解除する項目の位置select(int)
, getSelectedItem()
, isIndexSelected(int)
public boolean isIndexSelected(int index)
index
- チェック対象の項目true
、そうでない場合は false
select(int)
, deselect(int)
@Deprecated public boolean isSelected(int index)
isIndexSelected(int)
に置き換えられています。public int getRows()
List
が作成されると、この数は変更できません。public boolean isMultipleMode()
true
、そうでない場合は false
setMultipleMode(boolean)
@Deprecated public boolean allowsMultipleSelections()
isMultipleMode()
に置き換えられています。public void setMultipleMode(boolean b)
b
- true
の場合は複数選択が許可される。そうでない場合はリストから同時に選択できる項目は 1 つだけisMultipleMode()
@Deprecated public void setMultipleSelections(boolean b)
setMultipleMode(boolean)
に置き換えられています。public int getVisibleIndex()
makeVisible
によって最後に表示された項目のインデックスを取得します。makeVisible(int)
public void makeVisible(int index)
index
- 項目の位置getVisibleIndex()
public Dimension getPreferredSize(int rows)
rows
- リスト内の行の数Component.getPreferredSize()
@Deprecated public Dimension preferredSize(int rows)
getPreferredSize(int)
に置き換えられています。public Dimension getPreferredSize()
getPreferredSize
、クラス: Component
Component.getPreferredSize()
@Deprecated public Dimension preferredSize()
getPreferredSize()
に置き換えられています。preferredSize
、クラス: Component
public Dimension getMinimumSize(int rows)
rows
- リスト内の行の数Component.getMinimumSize()
@Deprecated public Dimension minimumSize(int rows)
getMinimumSize(int)
に置き換えられています。public Dimension getMinimumSize()
getMinimumSize
、クラス: Component
Component.getMinimumSize()
@Deprecated public Dimension minimumSize()
getMinimumSize()
に置き換えられています。minimumSize
、クラス: Component
public void addItemListener(ItemListener l)
select
または deselect
の呼び出しではなく、ユーザーの入力に反応してリスナーに送信されます。リスナー l
が null
である場合、例外はスローされず、何も処理は行われません。
AWT スレッドモデルの詳細は、「AWT スレッドの問題」を参照してください。
addItemListener
、インタフェース: ItemSelectable
l
- 項目リスナーremoveItemListener(java.awt.event.ItemListener)
, getItemListeners()
, select(int)
, deselect(int)
, ItemEvent
, ItemListener
public void removeItemListener(ItemListener l)
l
が null
である場合、例外はスローされず、何も処理は行われません。
AWT スレッドモデルの詳細は、「AWT スレッドの問題」を参照してください。
removeItemListener
、インタフェース: ItemSelectable
l
- 項目リスナーaddItemListener(java.awt.event.ItemListener)
, getItemListeners()
, ItemEvent
, ItemListener
public ItemListener[] getItemListeners()
ItemListener
。項目リスナーが現在登録されていない場合は空の配列addItemListener(java.awt.event.ItemListener)
, removeItemListener(java.awt.event.ItemListener)
, ItemEvent
, ItemListener
public void addActionListener(ActionListener l)
リスナー l
が null
である場合、例外はスローされず、何も処理は行われません。
AWT スレッドモデルの詳細は、「AWT スレッドの問題」を参照してください。
l
- アクションリスナーremoveActionListener(java.awt.event.ActionListener)
, getActionListeners()
, ActionEvent
, ActionListener
public void removeActionListener(ActionListener l)
l
が null
である場合、例外はスローされず、何も処理は行われません。
AWT スレッドモデルの詳細は、「AWT スレッドの問題」を参照してください。
l
- アクションリスナーaddActionListener(java.awt.event.ActionListener)
, getActionListeners()
, ActionEvent
, ActionListener
public ActionListener[] getActionListeners()
ActionListener
。アクションリスナーが現在登録されていない場合は空の配列addActionListener(java.awt.event.ActionListener)
, removeActionListener(java.awt.event.ActionListener)
, ActionEvent
, ActionListener
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
を実装するクラスまたはインタフェースが指定されなかった場合getItemListeners()
protected void processEvent(AWTEvent e)
ItemEvent
のインスタンスである場合は、processItemEvent
メソッドを呼び出します。 イベントが ActionEvent
のインスタンスの場合は、processActionEvent
を呼び出します。 イベントが項目イベントやアクションイベントでない場合は、スーパークラスで processEvent
を呼び出します。
イベントパラメータが null
である場合は、動作が未指定のため、例外が発生する可能性があります。
processEvent
、クラス: Component
e
- イベントActionEvent
, ItemEvent
, processActionEvent(java.awt.event.ActionEvent)
, processItemEvent(java.awt.event.ItemEvent)
protected void processItemEvent(ItemEvent e)
ItemListener
オブジェクトにディスパッチすることによって処理します。
項目イベントがこのコンポーネント用に使用可能になっていないかぎり、このメソッドは呼び出されません。項目イベントは、次の項目の 1 つが発生したときに使用可能になります。
ItemListener
オブジェクトが addItemListener
によって登録されている。
enableEvents
によって項目イベントが使用可能になっている。
イベントパラメータが null
である場合は、動作が未指定のため、例外が発生する可能性があります。
e
- 項目イベントItemEvent
, ItemListener
, addItemListener(java.awt.event.ItemListener)
, Component.enableEvents(long)
protected void processActionEvent(ActionEvent e)
ActionListener
オブジェクトにディスパッチすることによって処理します。
このコンポーネントに対してアクションイベントが使用可能でないかぎり、このメソッドは呼び出されません。アクションイベントは、次のどちらかの場合に使用可能になります。
ActionListener
オブジェクトが addActionListener
によって登録されている。
enableEvents
によってアクションイベントが使用可能になっている。
イベントパラメータが null
である場合は、動作が未指定のため、例外が発生する可能性があります。
e
- アクションイベントActionEvent
, ActionListener
, addActionListener(java.awt.event.ActionListener)
, Component.enableEvents(long)
protected String paramString()
paramString
、クラス: Component
@Deprecated public void delItems(int start, int end)
public AccessibleContext getAccessibleContext()
List
に関連付けられた AccessibleContext
を取得します。 リストの場合、AccessibleContext
は AccessibleAWTList
の形式を取ります。 必要に応じて、新しい AccessibleAWTList
インスタンスが作成されます。getAccessibleContext
、インタフェース: Accessible
getAccessibleContext
、クラス: Component
List
の AccessibleContext
として機能する AccessibleAWTList
バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.