|
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
Этот class реализует поддержку доступности
List class. |
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategyaccessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENTABORT, 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)
Возвращает массив всех объектов, в настоящий момент зарегистрированных как
FooListeners на это 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, validatepublic 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 в class ComponentComponent.isDisplayable(), Component.removeNotify(), Component.invalidate()public void removeNotify()
removeNotify в class ComponentComponent.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()-1add(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 в интерфейсе ItemSelectableObjects представление выбранных пунктов в этом списке прокрутки; если никакой элемент не выбирается, массив нулевой длиной возвращается.getSelectedItems(), ItemSelectablepublic 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 если этот список позволяет множественные выборы; иначе, falsesetMultipleMode(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 в class ComponentComponent.getPreferredSize()@Deprecated public Dimension preferredSize()
getPreferredSize().preferredSize в class Componentpublic Dimension getMinimumSize(int rows)
rows - число строк в спискеComponent.getMinimumSize()@Deprecated public Dimension minimumSize(int rows)
getMinimumSize(int).public Dimension getMinimumSize()
getMinimumSize в class ComponentComponent.getMinimumSize()@Deprecated public Dimension minimumSize()
getMinimumSize().minimumSize в class Componentpublic void addItemListener(ItemListener l)
select или deselect. Если слушатель l null, никакое исключение не выдается, и никакое действие не выполняется. Отошлите к AWT Распараллеливающие Проблемы для деталей о модели потоков AWT.
addItemListener в интерфейсе ItemSelectablel - слушатель элементаremoveItemListener(java.awt.event.ItemListener), getItemListeners(), select(int), deselect(int), ItemEvent, ItemListenerpublic void removeItemListener(ItemListener l)
l null, никакое исключение не выдается, и никакое действие не выполняется. Отошлите к AWT Распараллеливающие Проблемы для деталей о модели потоков AWT.
removeItemListener в интерфейсе ItemSelectablel - слушатель элементаaddItemListener(java.awt.event.ItemListener), getItemListeners(), ItemEvent, ItemListenerpublic ItemListener[] getItemListeners()
ItemListeners или пустой массив, если никакие слушатели элемента в настоящий момент не регистрируютсяaddItemListener(java.awt.event.ItemListener), removeItemListener(java.awt.event.ItemListener), ItemEvent, ItemListenerpublic void addActionListener(ActionListener l)
Если слушатель l null, никакое исключение не выдается, и никакое действие не выполняется.
Отошлите к AWT Распараллеливающие Проблемы для деталей о модели потоков AWT.
l - слушатель действияremoveActionListener(java.awt.event.ActionListener), getActionListeners(), ActionEvent, ActionListenerpublic void removeActionListener(ActionListener l)
l null, никакое исключение не выдается, и никакое действие не выполняется. Отошлите к AWT Распараллеливающие Проблемы для деталей о модели потоков AWT.
l - слушатель действияaddActionListener(java.awt.event.ActionListener), getActionListeners(), ActionEvent, ActionListenerpublic ActionListener[] getActionListeners()
ActionListeners или пустой массив, если никакие слушатели действия в настоящий момент не регистрируютсяaddActionListener(java.awt.event.ActionListener), removeActionListener(java.awt.event.ActionListener), ActionEvent, ActionListenerpublic <T extends EventListener> T[] getListeners(Class<T> listenerType)
FooListeners на это List. FooListeners регистрируются, используя addFooListener метод. Можно определить listenerType параметр с литералом class, такой как FooListener.class. Например, можно запросить a List l для его слушателей элемента со следующим кодом:
ItemListener[] ils = (ItemListener[])(l.getListeners(ItemListener.class));Если никакие такие слушатели не существуют, этот метод возвращает пустой массив.
getListeners в class ComponentlistenerType - тип слушателей требуют; этот параметр должен определить интерфейс, который убывает от java.util.EventListenerFooListeners в этом списке, или пустом массиве, если никакие такие слушатели не были добавленыClassCastException - если listenerType не определяет class или интерфейс, который реализует java.util.EventListenergetItemListeners()protected void processEvent(AWTEvent e)
ItemEvent, это вызывает processItemEvent метод. Еще, если событие является экземпляром ActionEvent, это вызывает processActionEvent. Если событие не является событием элемента или событием действия, оно вызывает processEvent на суперклассе. Отметьте это, если параметр события null поведение является неуказанным и может привести к исключению.
processEvent в class Componente - событие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 в class Component@Deprecated public void delItems(int start, int end)
public AccessibleContext getAccessibleContext()
AccessibleContext связанный с этим List. Для списков, AccessibleContext принимает форму AccessibleAWTList. Новое AccessibleAWTList экземпляр создается в случае необходимости.getAccessibleContext в интерфейсе AccessiblegetAccessibleContext в class ComponentAccessibleAWTList это служит AccessibleContext из этого List
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92