javax.swing.plaf.basic

Класс BasicListUI

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 должен быть обработан как "защищенный" внутренний class.
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()

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

Модификатор и Тип	Метод и Описание
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) Возвращает height указанной строки, основанной на текущем расположении.
Точка	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.

Методы, наследованные от class javax.swing.plaf. ComponentUI

contains, getAccessibleChild, getAccessibleChildrenCount, getMaximumSize, getMinimumSize, update

Методы, наследованные от class 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 в class 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 в class ComponentUI

Параметры:

c - JComponent на базовую линию требуют

width - width, чтобы получить базовую линию для

height - height, чтобы получить базовую линию для

Возвраты:

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

Броски:

NullPointerException - если c null

IllegalArgumentException - если width или height <0

С тех пор:

1.6

См. Также:

JComponent.getBaseline(int, int)

getBaselineResizeBehavior

public Component.BaselineResizeBehavior getBaselineResizeBehavior(JComponent c)

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

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

getBaselineResizeBehavior в class ComponentUI

Параметры:

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

Возвраты:

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

Броски:

NullPointerException - если c null

С тех пор:

1.6

См. Также:

JComponent.getBaseline(int, int)

getPreferredSize

public Dimension getPreferredSize(JComponent c)

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

Ориентация расположения	Привилегированный Размер
JList. ВЕРТИКАЛЬ	preferredSize списка является полный height строк и максимальный width ячеек. Если JList.fixedCellHeight определяется тогда, полный height строк только (cellVerticalMargins + fixedCellHeight) * model.getSize (), где rowVerticalMargins является пространством, мы выделяем для рисования желтой схемы фокуса. Так же, если fixedCellWidth определяется тогда, мы только используем это.
JList. VERTICAL_WRAP	Если видимое количество строки больше чем нуль, preferredHeight является максимальной ячейкой height * 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 является максимальной ячейкой height * 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 (width / максимальная ячейка width), по крайней мере с одним столбцом. Привилегированный height тогда становится размером модели / число столбцов * максимальная ячейка height. Максимальная ячейка height является или фиксированной ячейкой height, или решается, выполняя итерации через все ячейки найти максимальный height от ListCellRenderer.

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

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

getPreferredSize в class 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 в class ComponentUI

Параметры:

c - компонент, где этот делегат UI устанавливается

См. Также:

installDefaults(), installListeners(), installKeyboardActions()

uninstallUI

public void uninstallUI(JComponent c)

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

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

uninstallUI в class 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 в class ListUI

Параметры:

list - список

location - координаты точки

Возвраты:

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

Броски:

NullPointerException - если location нуль

indexToLocation

public Point indexToLocation(JList list,
                             int index)

Возвращает источник в данном JList, из указанного элемента, в системе координат списка. Возвраты null если индексирование не допустимо.

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

indexToLocation в class ListUI

Параметры:

list - список

index - ячейка индексирует

Возвраты:

источник ячейки, или null

getCellBounds

public Rectangle getCellBounds(JList list,
                               int index1,
                               int index2)

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

Если меньшие индексируют, вне диапазона списка ячеек, этот метод возвраты null. Если меньшие индексируют, допустимо, но большие индексируют, вне диапазона списка, границы только первого индексируют, возвращается. Иначе, границы допустимого диапазона возвращается.

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

getCellBounds в class ListUI

Параметры:

list - список

index1 - первые индексируют в диапазоне

index2 - вторые индексируют в диапазоне

Возвраты:

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

getRowHeight

protected int getRowHeight(int row)

Возвращает height указанной строки, основанной на текущем расположении.

Возвраты:

Указанный height строки или-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)