BasicListUI (Java Platform SE 8 )

java.lang.Object
- javax.swing.plaf.ComponentUI
- - javax.swing.plaf.ListUI
  - - javax.swing.plaf.basic.BasicListUI

已知直接子类：

SynthListUI
```
public class BasicListUI
extends ListUI
```
ListUI的可ListUI 。
BasicListUI不能在多个列表之间共享实例。

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`class`	`BasicListUI.FocusHandler` 这个类应该被视为一个“受保护”的内部类。
`class`	`BasicListUI.ListDataHandler` 在installUI时添加到JLists模型的ListDataListener以及JList.model属性更改时。
`class`	`BasicListUI.ListSelectionHandler` 在installUI时添加到JLists选择模型的ListSelectionListener，以及JList.selectionModel属性更改时。
`class`	`BasicListUI.MouseInputHandler` 鼠标输入和JList的焦点处理。
`class`	`BasicListUI.PropertyChangeHandler` 在InstallUI时添加到JList的PropertyChangeListener。

Field Summary

Fields
Modifier and Type	Field and Description
`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`	`list`
`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`

构造方法摘要

构造方法
Constructor and Description
`BasicListUI()`

方法摘要

所有方法静态方法接口方法具体的方法
Modifier and Type	Method and Description
`protected int`	`convertRowToY(int row)` 返回指定行的原点的JList相对Y坐标，如果行无效则返回-1。
`protected int`	`convertYToRow(int y0)` 根据当前布局，将JList相对坐标转换为包含它的行。
`protected FocusListener`	`createFocusListener()`
`protected ListDataListener`	`createListDataListener()` 创建根据需要通过模型添加到JLists的ListDataListener的实例。
`protected ListSelectionListener`	`createListSelectionListener()` 创建根据需要通过selectionModel添加到JLists中的ListSelectionHandler实例。
`protected MouseInputListener`	`createMouseInputListener()` 创建一个实现MouseInputListener的委托。
`protected PropertyChangeListener`	`createPropertyChangeListener()` 创建通过installUI（）添加到JList的PropertyChangeHandler实例。
`static ComponentUI`	`createUI(JComponent list)` 返回一个新的BasicListUI实例。
`int`	`getBaseline(JComponent c, int width, int height)` 返回基线。
`Component.BaselineResizeBehavior`	`getBaselineResizeBehavior(JComponent c)` 返回一个枚举，指示组件的基线如何随着大小的变化而改变。
`Rectangle`	`getCellBounds(JList list, int index1, int index2)` 返回给定列表的坐标系中由两个索引指定的单元格范围的边界矩形。
`Dimension`	`getPreferredSize(JComponent c)` 列表的preferredSize取决于布局方向。
`protected int`	`getRowHeight(int row)` 根据当前布局返回指定行的高度。
`Point`	`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)` 绘制与Graphics对象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()` 根据当前字体和fixedCellWidth，fixedCellHeight和prototypeCellValue的当前值重新计算cellHeight或cellHeights和cellWidth的值。

Methods inherited from class javax.swing.plaf.ComponentUI
contains, getAccessibleChild, getAccessibleChildrenCount, getMaximumSize, getMinimumSize, update

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 字段详细信息
  - list
```
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
```
    另请参见：
    
    Constant Field Values
  - selectionModelChanged
```
protected static final int selectionModelChanged
```
    另请参见：
    
    Constant Field Values
  - fontChanged
```
protected static final int fontChanged
```
    另请参见：
    
    Constant Field Values
  - fixedCellWidthChanged
```
protected static final int fixedCellWidthChanged
```
    另请参见：
    
    Constant Field Values
  - fixedCellHeightChanged
```
protected static final int fixedCellHeightChanged
```
    另请参见：
    
    Constant Field Values
  - prototypeCellValueChanged
```
protected static final int prototypeCellValueChanged
```
    另请参见：
    
    Constant Field Values
  - cellRendererChanged
```
protected static final int cellRendererChanged
```
    另请参见：
    
    Constant Field Values
- 构造方法详细信息
  - 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对象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取决于布局方向。 Layout Orientation Preferred Size JList.VERTICAL The preferredSize of the list is total height of the rows and the maximum width of the cells. If JList.fixedCellHeight is specified then the total height of the rows is just (cellVerticalMargins + fixedCellHeight) * model.getSize() where rowVerticalMargins is the space we allocate for drawing the yellow focus outline. Similarly if fixedCellWidth is specified then we just use that. JList.VERTICAL_WRAP If the visible row count is greater than zero, the preferredHeight is the maximum cell height * visibleRowCount. If the visible row count is <= 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 If the visible row count is greater than zero, the preferredHeight is the maximum cell height * adjustedRowCount. Where visibleRowCount is used to determine the number of columns. Because this lays out horizontally the number of rows is then determined from the column count. For example, lets say you have a model with 10 items and the visible row count is 8. The number of columns needed to display this is 2, but you no longer need 8 rows to display this, you only need 5, thus the adjustedRowCount is 5.
    If the visible row count is <= 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 / max cell width), with at least one column. The preferred height then becomes the model size / number of columns * maximum 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.
    
    以上指定原始首选宽度和高度。所得到的首选宽度是上面的宽度+ 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（）时调用 - 子类应确保在installUI时注册的所有键盘操作在此处被删除。
    
    另请参见：
    
    installUI(javax.swing.JComponent)
  - installListeners
```
protected void installListeners()
```
    创建并安装JList，其模型及其selectionModel的侦听器。这个方法在installUI（）时调用。
    
    另请参见：
    
    installUI(javax.swing.JComponent) ， uninstallListeners()
  - uninstallListeners
```
protected void uninstallListeners()
```
    从JList，其模型及其selectionModel中移除侦听器。所有的监听器字段都将重置为null。这个方法在uninstallUI（）时调用，它应该与installListeners保持同步。
    
    另请参见：
    
    uninstallUI(javax.swing.JComponent) ， installListeners()
  - installDefaults
```
protected void installDefaults()
```
    初始化字体，前景和背景等列表属性，并添加CellRendererPane。只有当当前值为null或UIResource时才会设置字体，前景和后台属性，如果当前值为空，则设置其他属性。
    
    另请参见：
    
    uninstallDefaults() ， installUI(javax.swing.JComponent) ， CellRendererPane
  - uninstallDefaults
```
protected void uninstallDefaults()
```
    将未明确覆盖的列表属性设置为null 。如果某个属性的当前值不是UIResource，则该属性被视为被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分配一个。
    
    结果
    
    用于Windows外观的新的ListUI实现。
  - locationToIndex
```
public int locationToIndex(JList list,
                           Point location)
```
    返回指定的细胞指数JList列表中的坐标系中最接近指定位置。要确定单元格实际是否包含指定的位置，请按照getCellBounds的规定对该单元格的边界进行getCellBounds 。如果列表的模型为空，则此方法返回-1 。
    
    Specified by:
    
    locationToIndex在 ListUI
    
    参数
    
    list - 列表
    
    location - 点的坐标
    
    结果
    
    最靠近给定位置的单元 -1 ，或 -1
    
    异常
    
    NullPointerException - 如果 location为空
  - indexToLocation
```
public Point indexToLocation(JList list,
                             int index)
```
    返回列表坐标系中指定项目的给定JList中的原点。如果索引无效，则返回null 。
    
    Specified by:
    
    indexToLocation在类 ListUI
    
    参数
    
    list - 列表
    
    index - 细胞指数
    
    结果
    
    电池的起源，或 null
  - getCellBounds
```
public Rectangle getCellBounds(JList list,
                               int index1,
                               int index2)
```
    返回给定列表的坐标系中由两个索引指定的单元格范围的边界矩形。指数可以按任何顺序提供。
    如果较小的索引在列表的单元格范围之外，则此方法返回null 。如果较小的索引有效，但较大的索引在列表的范围之外，则仅返回第一个索引的边界。否则返回有效范围的范围。
    
    Specified by:
    
    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相对Y坐标，如果行无效则返回-1。
    
    结果
    
    行的原点的Y坐标，或-1。
    
    另请参见：
    
    getRowHeight(int) ， updateLayoutState()
  - maybeUpdateLayoutState
```
protected void maybeUpdateLayoutState()
```
    如果updateLayoutStateNeeded不为零，请调用updateLayoutState（）并重置updateLayoutStateNeeded。在根据列表的几何进行任何计算之前，应该通过方法调用此方法。例如，它是paint（）和getPreferredSize（）中的第一个调用。
    
    另请参见：
    
    updateLayoutState()
  - updateLayoutState
```
protected void updateLayoutState()
```
    根据当前字体和fixedCellWidth，fixedCellHeight和prototypeCellValue的当前值重新计算cellHeight或cellHeights和cellWidth的值。
    
    另请参见：
    
    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()
```
    创建根据需要通过selectionModel添加到JLists中的ListSelectionHandler实例。子类可以覆盖此方法来返回自定义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()
```
    创建根据需要通过模型添加到JLists的ListDataListener的实例。子类可以覆盖此方法来返回自定义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()
```
    创建通过installUI（）添加到JList的PropertyChangeHandler实例。子类可以覆盖此方法以返回自定义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)

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class BasicListUI

Nested Class Summary

Field Summary

构造方法摘要

方法摘要

Methods inherited from class javax.swing.plaf.ComponentUI

Methods inherited from class java.lang.Object

字段详细信息

list

rendererPane

focusListener

mouseInputListener

listSelectionListener

listDataListener

propertyChangeListener

cellHeights

cellHeight

cellWidth

updateLayoutStateNeeded

modelChanged

selectionModelChanged

fontChanged

fixedCellWidthChanged

fixedCellHeightChanged

prototypeCellValueChanged

cellRendererChanged

构造方法详细信息

BasicListUI

方法详细信息

paintCell

paint

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