BasicListUI (Платформа Java SE 7)

java.lang. Объект
- javax.swing.plaf. ComponentUI
- - javax.swing.plaf. ListUI
  - - javax.swing.plaf.basic. BasicListUI

Прямые Известные Подклассы:

SynthListUI
```
public class BasicListUI
extends ListUI
```
Расширяемая реализация ListUI.
BasicListUI экземпляры не могут быть совместно использованы многократными списками.

Вложенная Сводка Класса

Вложенные Классы
Модификатор и Тип	Класс и Описание
`class`	`BasicListUI.FocusHandler` Этот класс должен быть обработан как "защищенный" внутренний класс.
`class`	`BasicListUI.ListDataHandler` ListDataListener это добавляется к модели JLists в installUI время, и всякий раз, когда свойство JList.model изменяется.
`class`	`BasicListUI.ListSelectionHandler` ListSelectionListener это добавляется к модели выбора JLists в installUI время, и всякий раз, когда свойство JList.selectionModel изменяется.
`class`	`BasicListUI.MouseInputHandler` Ввод мыши, и обработка фокуса для JList.
`class`	`BasicListUI.PropertyChangeHandler` PropertyChangeListener это добавляется к JList в installUI время.

Полевая Сводка

Поля
Модификатор и Тип	Поле и Описание
`protected int`	`cellHeight`
`protected int[]`	`cellHeights`
`protected static int`	`cellRendererChanged`
`protected int`	`cellWidth`
`protected static int`	`fixedCellHeightChanged`
`protected static int`	`fixedCellWidthChanged`
`protected FocusListener`	`focusListener`
`protected static int`	`fontChanged`
`protected JList`	`список`
`protected ListDataListener`	`listDataListener`
`protected ListSelectionListener`	`listSelectionListener`
`protected static int`	`modelChanged`
`protected MouseInputListener`	`mouseInputListener`
`protected PropertyChangeListener`	`propertyChangeListener`
`protected static int`	`prototypeCellValueChanged`
`protected CellRendererPane`	`rendererPane`
`protected static int`	`selectionModelChanged`
`protected int`	`updateLayoutStateNeeded`

Сводка конструктора

Конструкторы
Конструктор и Описание

BasicListUI()

Конструкторы
Конструктор и Описание
`BasicListUI()`

Сводка метода

Методы
Модификатор и Тип	Метод и Описание
`protected int`	`convertRowToY(int row)` Возвратите координату родственника JList И источника указанной строки или-1, если строка не допустима.
`protected int`	`convertYToRow(int y0)` Преобразуйте относительную координату JList в строку, которая содержит ее, основанный на текущем расположении.
`protected FocusListener`	`createFocusListener()`
`protected ListDataListener`	`createListDataListener()` Создает экземпляр ListDataListener, это добавляется к JLists моделью как необходимый.
`protected ListSelectionListener`	`createListSelectionListener()` Создает экземпляр ListSelectionHandler, это добавляется к JLists selectionModel как необходимый.
`protected MouseInputListener`	`createMouseInputListener()` Создает делегата, который реализует MouseInputListener.
`protected PropertyChangeListener`	`createPropertyChangeListener()` Создает экземпляр PropertyChangeHandler, это добавляется к JList installUI ().
`static ComponentUI`	`createUI(JComponent list)` Возвращает новый экземпляр BasicListUI.
`int`	`getBaseline(JComponent c, int width, int height)` Возвращает базовую линию.
`Компонент. BaselineResizeBehavior`	`getBaselineResizeBehavior(JComponent c)` Возвращает перечисление, указывающее, как базовая линия компонентных изменений как размер изменяется.
`Прямоугольник`	`getCellBounds(JList list, int index1, int index2)` Возвращает ограничительный прямоугольник, в системе координат данного списка, для диапазона ячеек, определенных этими двумя индексами.
`Размерность`	`getPreferredSize(JComponent c)` preferredSize списка зависит от ориентации расположения.
`protected int`	`getRowHeight(int row)` Возвращает высоту указанной строки, основанной на текущем расположении.
`Точка`	`indexToLocation(JList list, int index)` Возвращает источник в данном `JList`, из указанного элемента, в системе координат списка.
`protected void`	`installDefaults()` Инициализирует свойства списка, такие как шрифт, передний план, и фон, и добавляет CellRendererPane.
`protected void`	`installKeyboardActions()` Регистрирует привязку клавиатуры на `JList` то, что `BasicListUI` связывается с.
`protected void`	`installListeners()` Создает и устанавливает слушателей для JList, его модели, и его selectionModel.
`void`	`installUI(JComponent c)` Инициализирует `this.list` вызывая `installDefaults()`, `installListeners()`, и `installKeyboardActions()` в порядке.
`int`	`locationToIndex(JList list, Point location)` Возвращает индекс ячейки в указанном `JList` самый близкий к данному расположению в системе координат списка.
`protected void`	`maybeUpdateLayoutState()` Если updateLayoutStateNeeded не является нулем, вызовите updateLayoutState () и сбросьте updateLayoutStateNeeded.
`void`	`paint(Graphics g, JComponent c)` Нарисуйте строки, которые пересекают Графические объекты clipRect.
`protected void`	`paintCell(Graphics g, int row, Rectangle rowBounds, ListCellRenderer cellRenderer, ListModel dataModel, ListSelectionModel selModel, int leadIndex)` Нарисуйте одну ячейку Списка: вычислите соответствующее состояние, получите компонент средства рендеринга ячейки "штемпеля", и затем используйте CellRendererPane, чтобы нарисовать это.
`protected void`	`selectNextIndex()` Выбранный предыдущая строка и сила это, чтобы быть видимым.
`protected void`	`selectPreviousIndex()` Выбранный предыдущая строка и сила это, чтобы быть видимым.
`protected void`	`uninstallDefaults()` Устанавливает свойства списка, которые не были явно переопределены к `null`.
`protected void`	`uninstallKeyboardActions()` Действия клавиатуры нерегистров, установленные от `installKeyboardActions`.
`protected void`	`uninstallListeners()` Удаляет слушателей из JList, его модели, и его selectionModel.
`void`	`uninstallUI(JComponent c)` Деинициализирует `this.list` вызывая `uninstallListeners()`, `uninstallKeyboardActions()`, и `uninstallDefaults()` в порядке.
`protected void`	`updateLayoutState()` Повторно вычислите значение cellHeight или базируемого cellHeights и cellWidth, основанный на текущем шрифте и текущей стоимости fixedCellWidth, fixedCellHeight, и prototypeCellValue.

Методы javax.swing.plaf унаследованный от класса. ComponentUI
contains, getAccessibleChild, getAccessibleChildrenCount, getMaximumSize, getMinimumSize, update

Методы java.lang унаследованный от класса. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Полевая Деталь
- список
```
protected JList list
```
- rendererPane
```
protected CellRendererPane rendererPane
```
- focusListener
```
protected FocusListener focusListener
```
- mouseInputListener
```
protected MouseInputListener mouseInputListener
```
- listSelectionListener
```
protected ListSelectionListener listSelectionListener
```
- listDataListener
```
protected ListDataListener listDataListener
```
- propertyChangeListener
```
protected PropertyChangeListener propertyChangeListener
```
- cellHeights
```
protected int[] cellHeights
```
- cellHeight
```
protected int cellHeight
```
- cellWidth
```
protected int cellWidth
```
- updateLayoutStateNeeded
```
protected int updateLayoutStateNeeded
```
- modelChanged
```
protected static final int modelChanged
```
  См. Также:
  Постоянные Значения полей
- selectionModelChanged
```
protected static final int selectionModelChanged
```
  См. Также:
  Постоянные Значения полей
- fontChanged
```
protected static final int fontChanged
```
  См. Также:
  Постоянные Значения полей
- fixedCellWidthChanged
```
protected static final int fixedCellWidthChanged
```
  См. Также:
  Постоянные Значения полей
- fixedCellHeightChanged
```
protected static final int fixedCellHeightChanged
```
  См. Также:
  Постоянные Значения полей
- prototypeCellValueChanged
```
protected static final int prototypeCellValueChanged
```
  См. Также:
  Постоянные Значения полей
- cellRendererChanged
```
protected static final int cellRendererChanged
```
  См. Также:
  Постоянные Значения полей

Деталь конструктора
- BasicListUI
```
public BasicListUI()
```

Деталь метода

paintCell
```
protected void paintCell(Graphics g,
             int row,
             Rectangle rowBounds,
             ListCellRenderer cellRenderer,
             ListModel dataModel,
             ListSelectionModel selModel,
             int leadIndex)
```
Нарисуйте одну ячейку Списка: вычислите соответствующее состояние, получите компонент средства рендеринга ячейки "штемпеля", и затем используйте CellRendererPane, чтобы нарисовать это. Подклассы могут хотеть переопределить этот метод, а не краску ().

См. Также:
paint(java.awt.Graphics, javax.swing.JComponent)

краска
```
public void paint(Graphics g,
         JComponent c)
```
Нарисуйте строки, которые пересекают Графические объекты clipRect. Это вызовы метода paintCell по мере необходимости. Подклассы могут хотеть переопределить эти методы.

Переопределения:

paint в классе ComponentUI

Параметры:
g - Graphics контекст, в котором можно нарисовать
c - нарисованный компонент; этот параметр часто игнорируется, но мог бы использоваться, если объект UI не сохраняющий состояние и совместно используемым многократными компонентами
См. Также:
paintCell(java.awt.Graphics, int, java.awt.Rectangle, javax.swing.ListCellRenderer, javax.swing.ListModel, javax.swing.ListSelectionModel, int)

getBaseline
```
public int getBaseline(JComponent c,
              int width,
              int height)
```
Возвращает базовую линию.

Переопределения:

getBaseline в классе ComponentUI

Параметры:
c - JComponent на базовую линию требуют
width - ширина, чтобы получить базовую линию для
height - высота, чтобы получить базовую линию для

Возвраты:
базовая линия или значение <0 указаний там не являются никакой разумной базовой линией

Броски:

NullPointerException - если c null

IllegalArgumentException - если ширина или высота <0
С тех пор:

1.6

См. Также:
JComponent.getBaseline(int, int)

getBaselineResizeBehavior
```
public Component.BaselineResizeBehavior getBaselineResizeBehavior(JComponent c)
```
Возвращает перечисление, указывающее, как базовая линия компонентных изменений как размер изменяется.

Переопределения:

getBaselineResizeBehavior в классе ComponentUI

Параметры:
c - JComponent чтобы возвратить базовую линию изменяют размеры поведения для

Возвраты:
перечисление, указывающее, как базовая линия изменяется как компонентный размер, изменяется

Броски:

NullPointerException - если c null
С тех пор:

1.6

См. Также:
JComponent.getBaseline(int, int)

getPreferredSize

public Dimension getPreferredSize(JComponent c)

preferredSize списка зависит от ориентации расположения.

Ориентация расположения	Привилегированный Размер
JList. ВЕРТИКАЛЬ	preferredSize списка является полной высотой строк и максимальной шириной ячеек. Если JList.fixedCellHeight определяется тогда, полная высота строк только (cellVerticalMargins + fixedCellHeight) * model.getSize (), где rowVerticalMargins является пространством, мы выделяем для рисования желтой схемы фокуса. Так же, если fixedCellWidth определяется тогда, мы только используем это.
JList. VERTICAL_WRAP	Если видимое количество строки больше чем нуль, preferredHeight является максимальной высотой ячейки * visibleRowCount. Если видимое количество строки <= 0, the preferred height is either the current height of the list, or the maximum cell height, whichever is bigger. The preferred width is than the maximum cell width * number of columns needed. Where the number of columns needs is list.height / max cell height. Max cell height is either the fixed cell height, or is determined by iterating through all the cells to find the maximum height from the ListCellRenderer.
JList. HORIZONTAL_WRAP	Если видимое количество строки больше чем нуль, preferredHeight является максимальной высотой ячейки * adjustedRowCount. Где visibleRowCount используется, чтобы определить число столбцов. Поскольку это размечает горизонтально число строк, тогда определяется от количества столбца. Например, позволяет, говорят, что у Вас есть модель с 10 элементами, и видимое количество строки 8. Число столбцов должно было вывести на экран, это 2, но Вы больше не нуждаетесь в 8 строках, чтобы вывести на экран это, Вы только нуждаетесь 5, таким образом adjustedRowCount 5. Если видимое количество строки является <= 0, the preferred height is dictated by the number of columns, which will be as many as can fit in the width of the `JList` (ширина / максимальная ширина ячейки), по крайней мере с одним столбцом. Привилегированная высота тогда становится размером модели / число столбцов * максимальная высота ячейки. Максимальная высота ячейки является или фиксированной высотой ячейки, или решается, выполняя итерации через все ячейки найти максимальную высоту от ListCellRenderer.

Вышеупомянутое определяет сырые данные предпочтенная ширина и высота. Получающаяся привилегированная ширина является вышеупомянутой шириной + insets.left + insets.right, и получающаяся привилегированная высота является вышеупомянутой высотой + insets.top + insets.bottom. Где Insets определяются от list.getInsets().

Переопределения:: getPreferredSize в классе ComponentUI
Параметры:: c - Компонент JList.
Возвраты:: Полный размер списка.
См. Также:: JComponent.getPreferredSize(), LayoutManager.preferredLayoutSize(java.awt.Container)

selectPreviousIndex
```
protected void selectPreviousIndex()
```
Выбранный предыдущая строка и сила это, чтобы быть видимым.

См. Также:
JList.ensureIndexIsVisible(int)

selectNextIndex
```
protected void selectNextIndex()
```
Выбранный предыдущая строка и сила это, чтобы быть видимым.

См. Также:
JList.ensureIndexIsVisible(int)

installKeyboardActions
```
protected void installKeyboardActions()
```
Регистрирует привязку клавиатуры на JList то, что BasicListUI связывается с. В этот метод заходят installUI () время.

См. Также:
installUI(javax.swing.JComponent)

uninstallKeyboardActions
```
protected void uninstallKeyboardActions()
```
Действия клавиатуры нерегистров, установленные от installKeyboardActions. В этот метод заходят uninstallUI (), время - subclassess должно гарантировать, что все действия клавиатуры, зарегистрированные в installUI время, удаляются сюда.

См. Также:
installUI(javax.swing.JComponent)

installListeners
```
protected void installListeners()
```
Создает и устанавливает слушателей для JList, его модели, и его selectionModel. В этот метод заходят installUI () время.

См. Также:
installUI(javax.swing.JComponent), uninstallListeners()

uninstallListeners
```
protected void uninstallListeners()
```
Удаляет слушателей из JList, его модели, и его selectionModel. Все поля слушателя, сбрасываются к нулю здесь. В этот метод заходят uninstallUI () время, это должно быть сохранено в синхронизации с installListeners.

См. Также:
uninstallUI(javax.swing.JComponent), installListeners()

installDefaults
```
protected void installDefaults()
```
Инициализирует свойства списка, такие как шрифт, передний план, и фон, и добавляет CellRendererPane. Шрифт, передний план, и фоновые свойства только устанавливаются, если их текущая стоимость является или нулем или UIResource, другие свойства устанавливаются, если текущая стоимость является нулем.

См. Также:
uninstallDefaults(), installUI(javax.swing.JComponent), CellRendererPane

uninstallDefaults
```
protected void uninstallDefaults()
```
Устанавливает свойства списка, которые не были явно переопределены к null. Свойство считают переопределенным, если его текущая стоимость не является a UIResource.

См. Также:
installDefaults(), uninstallUI(javax.swing.JComponent), CellRendererPane

installUI
```
public void installUI(JComponent c)
```
Инициализирует this.list вызывая installDefaults(), installListeners(), и installKeyboardActions() в порядке.

Переопределения:

installUI в классе ComponentUI

Параметры:
c - компонент, где этот делегат UI устанавливается
См. Также:
installDefaults(), installListeners(), installKeyboardActions()

uninstallUI
```
public void uninstallUI(JComponent c)
```
Деинициализирует this.list вызывая uninstallListeners(), uninstallKeyboardActions(), и uninstallDefaults() в порядке. Устанавливает this.list в NULL.

Переопределения:

uninstallUI в классе ComponentUI

Параметры:
c - компонент, из которого удаляется этот делегат UI; этот параметр часто игнорируется, но мог бы использоваться, если объект UI не сохраняющий состояние и совместно используемым многократными компонентами
См. Также:
uninstallListeners(), uninstallKeyboardActions(), uninstallDefaults()

createUI
```
public static ComponentUI createUI(JComponent list)
```
Возвращает новый экземпляр BasicListUI. Делегаты BasicListUI выделяются один на JList.

Возвраты:
Новая реализация ListUI для стили Windows.

locationToIndex
```
public int locationToIndex(JList list,
                  Point location)
```
Возвращает индекс ячейки в указанном JList самый близкий к данному расположению в системе координат списка. Чтобы определить, содержит ли ячейка фактически указанное расположение, сравните точку с границами ячейки, в соответствии с getCellBounds. Этот метод возвраты -1 если модель списка пуста.

Определенный:

locationToIndex в классе ListUI

Параметры:
list - список
location - координаты точки

Возвраты:
индекс ячейки, самый близкий к данному расположению, или -1

Броски:

NullPointerException - если location нуль

indexToLocation
```
public Point indexToLocation(JList list,
                    int index)
```
Возвращает источник в данном JList, из указанного элемента, в системе координат списка. Возвраты null если индекс не допустим.

Определенный:

indexToLocation в классе ListUI

Параметры:
list - список
index - индекс ячейки

Возвраты:
источник ячейки, или null

getCellBounds
```
public Rectangle getCellBounds(JList list,
                      int index1,
                      int index2)
```
Возвращает ограничительный прямоугольник, в системе координат данного списка, для диапазона ячеек, определенных этими двумя индексами. Индексы могут быть предоставлены в любом порядке.
Если меньший индекс вне диапазона списка ячеек, этот метод возвраты null. Если меньший индекс допустим, но больший индекс вне диапазона списка, границы только первого индекса возвращается. Иначе, границы допустимого диапазона возвращается.

Определенный:

getCellBounds в классе ListUI

Параметры:
list - список
index1 - первый индекс в диапазоне
index2 - второй индекс в диапазоне

Возвраты:
ограничительный прямоугольник для диапазона ячеек, или null

getRowHeight
```
protected int getRowHeight(int row)
```
Возвращает высоту указанной строки, основанной на текущем расположении.

Возвраты:
Указанная высота строки или-1, если строка не допустима.
См. Также:
convertYToRow(int), convertRowToY(int), updateLayoutState()

convertYToRow
```
protected int convertYToRow(int y0)
```
Преобразуйте относительную координату JList в строку, которая содержит ее, основанный на текущем расположении. Если y0 не находится в пределах никакой строки, возвратитесь-1.

Возвраты:
Строка, которая содержит y0, или-1.
См. Также:
getRowHeight(int), updateLayoutState()

convertRowToY
```
protected int convertRowToY(int row)
```
Возвратите координату родственника JList И источника указанной строки или-1, если строка не допустима.

Возвраты:
Координата Y источника строки, или-1.
См. Также:
getRowHeight(int), updateLayoutState()

maybeUpdateLayoutState
```
protected void maybeUpdateLayoutState()
```
Если updateLayoutStateNeeded не является нулем, вызовите updateLayoutState () и сбросьте updateLayoutStateNeeded. Этот метод должны вызвать методы прежде, чем сделать любое вычисление, основанное на геометрии списка. Например это - первый вызов в краске () и getPreferredSize ().

См. Также:
updateLayoutState()

updateLayoutState
```
protected void updateLayoutState()
```
Повторно вычислите значение cellHeight или базируемого cellHeights и cellWidth, основанный на текущем шрифте и текущей стоимости fixedCellWidth, fixedCellHeight, и prototypeCellValue.

См. Также:
maybeUpdateLayoutState()

createMouseInputListener
```
protected MouseInputListener createMouseInputListener()
```
Создает делегата, который реализует MouseInputListener. Делегат добавляется к соответствующему java.awt. Компонентный слушатель перечисляет в installUI () время. Подклассы могут переопределить этот метод, чтобы возвратить пользовательский MouseInputListener, например.
```
 class MyListUI extends BasicListUI {
    protected MouseInputListener createMouseInputListener() {
        return new MyMouseInputHandler();
    }
    public class MyMouseInputHandler extends MouseInputHandler {
        public void mouseMoved(MouseEvent e) {
            // do some extra work when the mouse moves
            super.mouseMoved(e);
        }
    }
 }
 
```
См. Также:
BasicListUI.MouseInputHandler, installUI(javax.swing.JComponent)

createFocusListener

protected FocusListener createFocusListener()

createListSelectionListener

protected ListSelectionListener createListSelectionListener()

Создает экземпляр ListSelectionHandler, это добавляется к JLists selectionModel как необходимый. Подклассы могут переопределить этот метод, чтобы возвратить пользовательский ListSelectionListener, например.

 class MyListUI extends BasicListUI {
    protected ListSelectionListener createListSelectionListener() {
        return new MySelectionListener();
    }
    public class MySelectionListener extends ListSelectionHandler {
        public void valueChanged(ListSelectionEvent e) {
            // do some extra work when the selection changes
            super.valueChange(e);
        }
    }
 }

См. Также:: BasicListUI.ListSelectionHandler, installUI(javax.swing.JComponent)

createListDataListener

protected ListDataListener createListDataListener()

Создает экземпляр ListDataListener, это добавляется к JLists моделью как необходимый. Подклассы могут переопределить этот метод, чтобы возвратить пользовательский ListDataListener, например.

 class MyListUI extends BasicListUI {
    protected ListDataListener createListDataListener() {
        return new MyListDataListener();
    }
    public class MyListDataListener extends ListDataHandler {
        public void contentsChanged(ListDataEvent e) {
            // do some extra work when the models contents change
            super.contentsChange(e);
        }
    }
 }

См. Также:: ListDataListener, JList.getModel(), installUI(javax.swing.JComponent)

createPropertyChangeListener

protected PropertyChangeListener createPropertyChangeListener()

Создает экземпляр PropertyChangeHandler, это добавляется к JList installUI (). Подклассы могут переопределить этот метод, чтобы возвратить пользовательский PropertyChangeListener, например.

 class MyListUI extends BasicListUI {
    protected PropertyChangeListener createPropertyChangeListener() {
        return new MyPropertyChangeListener();
    }
    public class MyPropertyChangeListener extends PropertyChangeHandler {
        public void propertyChange(PropertyChangeEvent e) {
            if (e.getPropertyName().equals("model")) {
                // do some extra work when the model changes
            }
            super.propertyChange(e);
        }
    }
 }

См. Также:: PropertyChangeListener, installUI(javax.swing.JComponent)

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Класс BasicListUI

Вложенная Сводка Класса

Полевая Сводка

Сводка конструктора

Сводка метода

Методы javax.swing.plaf унаследованный от класса. ComponentUI

Методы java.lang унаследованный от класса. Объект

Полевая Деталь

список

rendererPane

focusListener

mouseInputListener

listSelectionListener

listDataListener

propertyChangeListener

cellHeights

cellHeight

cellWidth

updateLayoutStateNeeded

modelChanged

selectionModelChanged

fontChanged

fixedCellWidthChanged

fixedCellHeightChanged

prototypeCellValueChanged

cellRendererChanged

Деталь конструктора

BasicListUI

Деталь метода

paintCell

краска

getBaseline

getBaselineResizeBehavior

getPreferredSize

selectPreviousIndex

selectNextIndex

installKeyboardActions

uninstallKeyboardActions

installListeners

uninstallListeners

installDefaults

uninstallDefaults

installUI

uninstallUI

createUI

locationToIndex

indexToLocation

getCellBounds

getRowHeight

convertYToRow

convertRowToY

maybeUpdateLayoutState

updateLayoutState

createMouseInputListener

createFocusListener

createListSelectionListener

createListDataListener

createPropertyChangeListener