Класс BasicListUI

Расширяемая реализация ListUI.

BasicListUI экземпляры не могут быть совместно использованы между несколькими списками.

Поля

list

protected JList list

объект отображения

protected CellRendererPane rendererPane

слушатель фокуса

protected FocusListener focusListener

слушатель событий мыши

protected MouseInputListener mouseInputListener

слушатель изменения выделения в списке

protected ListSelectionListener listSelectionListener

слушатель изменений данных списка

protected ListDataListener listDataListener

слушатель изменений свойств

protected PropertyChangeListener propertyChangeListener

высоты ячеек

protected int[] cellHeights

высота ячейки

protected int cellHeight

ширина ячейки

protected int cellWidth

необходимость обновления состояния макета

protected int updateLayoutStateNeeded

изменение модели

protected static final int modelChanged

См. также:

Значения константных полей

изменение модели выделения

protected static final int selectionModelChanged

См. также:

Значения константных полей

изменение шрифта

protected static final int fontChanged

См. также:

Значения константных полей

изменение фиксированной ширины ячейки

protected static final int fixedCellWidthChanged

См. также:

Значения константных полей

изменение фиксированной высоты ячейки

protected static final int fixedCellHeightChanged

См. также:

Значения константных полей

изменение значения ячейки-прототипа

protected static final int prototypeCellValueChanged

См. также:

Значения константных полей

изменение отображателя ячеек

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

См. также:

paint(java.awt.Graphics, javax.swing.JComponent)

paint

public void paint(Graphics g,
                  JComponent c)

Отображает строки, пересекающие область обрезки объекта Graphics. Этот метод вызывает paintCell по мере необходимости. Подклассы могут переопределить эти методы.

Переопределяет:

paint в классе ComponentUI

Параметры:

g - контекст отображения

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 - компонент, для которого запрашивается базовая линия

width - высота для получения базовой линии

Возвращает:

базовую линию или значение < 0, если нет разумной базовой линии

Исключения:

NullPointerException - если c является null

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

С момента:

1.6

См. также:

JComponent.getBaseline(int, int)

getBaselineResizeBehavior

public Component.BaselineResizeBehavior getBaselineResizeBehavior(JComponent c)

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

Переопределяет:

getBaselineResizeBehavior в классе ComponentUI

Параметры:

c - компонент, для которого запрашивается поведение изменения базовой линии

Возвращает:

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

Исключения:

NullPointerException - если c является null

С момента:

1.6

См. также:

JComponent.getBaseline(int, int)

getPreferredSize

public Dimension getPreferredSize(JComponent c)

Переопределяет:

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() — подклассы должны гарантировать, что все сочетания клавиш, зарегистрированные во время installUI, удалены здесь.

См. также:

installUI(javax.swing.JComponent)

installListeners

protected void installListeners()

Создаёт и устанавливает слушателей для JList, его модели и модели выделения. Этот метод вызывается во время installUI().

См. также:

installUI(javax.swing.JComponent), uninstallListeners()

uninstallListeners

protected void uninstallListeners()

Удаляет слушателей из JList, его модели и модели выделения. Все поля слушателей сбрасываются в null. Этот метод вызывается во время uninstallUI(), он должен быть синхронизирован с installListeners.

См. также:

uninstallUI(javax.swing.JComponent), installListeners()

installDefaults

protected void installDefaults()

Инициализирует свойства списка, такие как шрифт, передний и задний цвета, и добавляет CellRendererPane. Свойства шрифта, переднего и заднего цвета устанавливаются только в том случае, если их текущее значение равно null или UIResource, другие свойства устанавливаются, если текущее значение равно null.

См. также:

uninstallDefaults(), installUI(javax.swing.JComponent), CellRendererPane

uninstallDefaults

protected void uninstallDefaults()

Устанавливает свойства списка, которые не были явно переопределены, в null. Свойство считается переопределённым, если его текущее значение не является UIResource.

См. также:

installDefaults(), uninstallUI(javax.swing.JComponent), CellRendererPane

installUI

public void installUI(JComponent c)

Инициализирует this.list, вызывая installDefaults(), installListeners(), и installKeyboardActions() в указанном порядке.

Переопределяет:

installUI в классе ComponentUI

Параметры:

c - компонент, в котором устанавливается этот делегат пользовательского интерфейса

См. также:

installDefaults(), installListeners(), installKeyboardActions()

uninstallUI

public void uninstallUI(JComponent c)

Деинициализирует this.list, вызывая uninstallListeners(), uninstallKeyboardActions(), и uninstallDefaults() в указанном порядке. Устанавливает this.list в null.

Переопределяет:

uninstallUI в классе ComponentUI

Параметры:

c - компонент, из которого удаляется этот делегат пользовательского интерфейса; этот аргумент часто игнорируется, но может быть использован, если объект пользовательского интерфейса является бессостоятельным и используется несколькими компонентами

См. также:

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 равно null

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)

Определено в:

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)

Возвращает относительную координату Y JList начала указанной строки или -1, если строка недопустима.

Возвращает:

Координату Y начала строки или -1.

См. также:

getRowHeight(int), updateLayoutState()

maybeUpdateLayoutState

protected void maybeUpdateLayoutState()

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

См. также:

updateLayoutState()

updateLayoutState

protected void updateLayoutState()

Пересчитывает значение cellHeight или cellHeights, а также cellWidth, на основе текущего шрифта и текущих значений fixedCellWidth, fixedCellHeight и prototypeCellValue.

См. также:

maybeUpdateLayoutState()

createMouseInputListener

protected MouseInputListener createMouseInputListener()

Создает делегат, реализующий MouseInputListener. Делегат добавляется в соответствующие списки слушателей java.awt.Component во время 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, который добавляется к JList по мере необходимости в 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, который добавляется к JList по мере необходимости в model. Подклассы могут переопределить этот метод, чтобы вернуть пользовательского 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)