Spec-Zone .ru
спецификации, руководства, описания, API
|
public class List extends Component implements ItemSelectable, Accessible
List
компонент дарит пользователю список прокрутки текстовых элементов. Список может быть установлен так, чтобы пользователь мог выбрать или один элемент или многократные элементы. Например, код .. .
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
контейнер, производит следующий список прокрутки:
Если Список позволяет множественные выборы, то щелчок по элементу, который уже выбирается, отменяет выбор его. В предыдущем примере только один элемент от списка прокрутки может быть выбран за один раз, так как второй параметр, создавая новый список прокрутки false
. Если Список не позволяет множественные выборы, выбирая элемент заставляет любой другой выбранный пункт быть невыбранным.
Отметьте, что список в показанном примере создавался с четырьмя видимыми строками. Как только список был создан, число видимых строк не может быть изменено. Значение по умолчанию List
создается с четырьмя строками, так, чтобы lst = new List()
эквивалентно list = new List(4, false)
.
Начинаясь с Java 1.1, Abstract Window Toolkit передается List
возразите всей мыши, клавиатуре, и событиям фокуса, которые происходят по этому. (Старая модель событий AWT сохраняется только для назад совместимости, и ее использованию обескураживают.)
Когда элемент выбирается или невыбранный пользователем, AWT отправляет экземпляр ItemEvent
к списку. Когда пользовательские двойные щелчки по элементу в списке прокрутки, AWT отправляет экземпляр ActionEvent
к списку после события элемента. AWT также генерирует событие действия, когда пользователь нажимает клавишу Return, в то время как элемент в списке выбирается.
Если приложение хочет выполнить некоторое действие, основанное на элементе в этом списке, выбираемом или активированном пользователем, это должно реализовать ItemListener
или ActionListener
как приспосабливают и регистрируют нового слушателя, чтобы получить события от этого списка.
Для списков прокрутки множественного выбора это считают лучшим пользовательским интерфейсом, чтобы использовать внешний жест (такой как щелчок по кнопке), чтобы инициировать действие.
ItemEvent
, ItemListener
, ActionEvent
, ActionListener
, Сериализированная ФормаМодификатор и Тип | Класс и Описание |
---|---|
protected class |
Список. 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()
Осуждаемый.
С версии 1.1 JDK, замененной
isMultipleMode() . |
void |
clear()
Осуждаемый.
С версии 1.1 JDK, замененной
removeAll() . |
int |
countItems()
Осуждаемый.
С версии 1.1 JDK, замененной
getItemCount() . |
void |
delItem(int position)
Осуждаемый.
замененный
remove(String) и remove(int) . |
void |
delItems(int start, int end)
Осуждаемый.
С версии 1.1 JDK, Не для общедоступного использования в будущем. Этот метод, как ожидают, будет сохранен только как закрытый метод пакета.
|
void |
deselect(int index)
Отменяет выбор элемента по указанному индексу.
|
AccessibleContext |
getAccessibleContext()
Добирается
AccessibleContext связанный с этим List . |
ActionListener[] |
getActionListeners()
Возвращает массив всех слушателей действия, зарегистрированных в этом списке.
|
Строка |
getItem(int index)
Связали элемент с указанным индексом.
|
int |
getItemCount()
Получает число элементов в списке.
|
ItemListener[] |
getItemListeners()
Возвращает массив всех слушателей элемента, зарегистрированных в этом списке.
|
Строка[] |
getItems()
Получает элементы в списке.
|
<T extends EventListener> |
getListeners(Class<T> listenerType)
Возвращает массив всех объектов, в настоящий момент зарегистрированных как
FooListener s на это List . |
Размерность |
getMinimumSize()
Определяет минимальный размер этого списка прокрутки.
|
Размерность |
getMinimumSize(int rows)
Получает minumum размерности для списка с конкретным количеством строк.
|
Размерность |
getPreferredSize()
Получает привилегированный размер этого списка прокрутки.
|
Размерность |
getPreferredSize(int rows)
Получает привилегированные размерности для списка с конкретным количеством строк.
|
int |
getRows()
Получает число видимых строк в этом списке.
|
int |
getSelectedIndex()
Получает индекс выбранного пункта в списке,
|
int[] |
getSelectedIndexes()
Получает выбранные индексы в списке.
|
Строка |
getSelectedItem()
Получает выбранный пункт в этом списке прокрутки.
|
Строка[] |
getSelectedItems()
Получает выбранные пункты в этом списке прокрутки.
|
Объект[] |
getSelectedObjects()
Получает выбранные пункты в этом списке прокрутки в массиве Объектов.
|
int |
getVisibleIndex()
Получает индекс элемента, который был последний сделанный видимым методом
makeVisible . |
boolean |
isIndexSelected(int index)
Определяет, выбирается ли указанный элемент в этом списке прокрутки.
|
boolean |
isMultipleMode()
Определяет, позволяет ли этот список множественные выборы.
|
boolean |
isSelected(int index)
Осуждаемый.
С версии 1.1 JDK, замененной
isIndexSelected(int) . |
void |
makeVisible(int index)
Делает элемент по указанному индексу видимым.
|
Размерность |
minimumSize()
Осуждаемый.
С версии 1.1 JDK, замененной
getMinimumSize() . |
Размерность |
minimumSize(int rows)
Осуждаемый.
С версии 1.1 JDK, замененной
getMinimumSize(int) . |
protected String |
paramString()
Возвращает строку параметра, представляющую состояние этого списка прокрутки.
|
Размерность |
preferredSize()
Осуждаемый.
С версии 1.1 JDK, замененной
getPreferredSize() . |
Размерность |
preferredSize(int rows)
Осуждаемый.
С версии 1.1 JDK, замененной
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)
Осуждаемый.
С версии 1.1 JDK, замененной
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
, только один элемент за один раз может быть выбран.rows
- число элементов, чтобы показать.multipleMode
- если true
, тогда множественные выборы позволяются; иначе, только один элемент может быть выбран за один раз.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
s представление выбранных пунктов в этом списке прокрутки; если никакой элемент не выбирается, массив нулевой длиной возвращается.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
тогда множественные выборы позволяются; иначе, только один элемент от списка может быть выбран сразу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
s или пустой массив, если никакие слушатели элемента в настоящий момент не регистрируются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
s или пустой массив, если никакие слушатели действия в настоящий момент не регистрируютсяaddActionListener(java.awt.event.ActionListener)
, removeActionListener(java.awt.event.ActionListener)
, ActionEvent
, ActionListener
public <T extends EventListener> T[] getListeners(Class<T> listenerType)
FooListener
s на это List
. FooListener
s регистрируются, используя addFooListener
метод. Можно определить listenerType
параметр с литералом класса, такой как FooListener.class
. Например, можно запросить a List
l
для его слушателей элемента со следующим кодом:
ItemListener[] ils = (ItemListener[])(l.getListeners(ItemListener.class));Если никакие такие слушатели не существуют, этот метод возвращает пустой массив.
getListeners
в классе Component
listenerType
- тип слушателей требуют; этот параметр должен определить интерфейс, который убывает от java.util.EventListener
FooListener
s в этом списке, или пустом массиве, если никакие такие слушатели не были добавлены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
объекты. Этот метод не вызывают, если события элемента не включаются для этого компонента. События элемента включаются, когда одно из следующего происходит:
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()
AccessibleContext
связанный с этим List
. Для списков, AccessibleContext
принимает форму AccessibleAWTList
. Новое AccessibleAWTList
экземпляр создается в случае необходимости.getAccessibleContext
в интерфейсе Accessible
getAccessibleContext
в классе Component
AccessibleAWTList
это служит AccessibleContext
из этого List
Для дальнейшей ссылки API и документации разработчика, см.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.