javax.swing.plaf.basic

Class BasicListUI

java.lang.Object

javax.swing.plaf.ComponentUI

javax.swing.plaf.ListUI

javax.swing.plaf.basic.BasicListUI

已知直接子类：

SynthListUI

public class BasicListUI
extends ListUI

一个可扩展的 ListUI实施。

BasicListUI实例之间不能共享多个列表。

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	BasicListUI.FocusHandler 这个类应该被视为一个“受保护的”内部类。
class	BasicListUI.ListDataHandler 的listdatalistener的installui时间添加到jlists模型，当jlist.model性质变化。
class	BasicListUI.ListSelectionHandler 的listselectionlistener的installui时间添加到jlists选择模型，当jlist.selectionmodel性质变化。
class	BasicListUI.MouseInputHandler 鼠标输入，并集中处理JList。
class	BasicListUI.PropertyChangeHandler 的propertychangelistener的installui时间添加到列表框。

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) 返回列表框相对坐标指定行的起源或1如果行无效。
protected int	convertYToRow(int y0) 将JList相对坐标包含它的行，基于当前的布局。
protected FocusListener	createFocusListener()
protected ListDataListener	createListDataListener() 创建一个实例listdatalistener的模型添加到jlists需要。
protected ListSelectionListener	createListSelectionListener() 创建一个实例listselectionhandler的选择模式添加到jlists需要。
protected MouseInputListener	createMouseInputListener() 创建一个委托，实现了MouseInputListener。
protected PropertyChangeListener	createPropertyChangeListener() 创建propertychangehandler的installui()添加到列表框的一个实例。
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，其模型和选择模型。
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，其模型和选择模型。
void	uninstallUI(JComponent c) this.list反初始化调用 uninstallListeners()， uninstallKeyboardActions()，和 uninstallDefaults()为。
protected void	updateLayoutState() 返回当前单元的高度或cellheights重构和基于返回当前单元的宽度值，基于当前字体和fixedcellwidth，fixedcellheight的当前值，并prototypecellvalue。

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

Field Detail

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

Constructor Detail

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)

油漆行，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表示没有合理的基线

异常

如果是 null c NullPointerException

IllegalArgumentException如果宽度或高度小于0

从以下版本开始：

一点六

另请参见：

JComponent.getBaseline(int, int)

getBaselineResizeBehavior

public Component.BaselineResizeBehavior getBaselineResizeBehavior(JComponent c)

返回一个枚举指示组件的尺寸的变化的基线。

重写：

getBaselineResizeBehavior 方法重写，继承类 ComponentUI

参数

c - JComponent返回基线调整行为

结果

一个枚举说明基线作为构件的尺寸变化

异常

如果是 null c NullPointerException

从以下版本开始：

一点六

另请参见：

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()时间称为subclassess应确保所有在installui时间注册的键盘操作被删除。

另请参见：

installUI(javax.swing.JComponent)

installListeners

protected void installListeners()

创建并安装听众对于JList，其模型和选择模型。这种方法是在installui()称。

另请参见：

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

uninstallListeners

protected void uninstallListeners()

消除听众从JList，其模型和选择模型。所有的侦听器字段，都被重置为空。这种方法是在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。

另请参见：

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空。

重写：

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。如果列表是空的模型，此方法返回 -1。

Specified by:

locationToIndex 方法重写，继承类 ListUI

参数

list -列表

location -的点的坐标

结果

细胞指数接近给定的位置，或 -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相对坐标包含它的行，基于当前的布局。如果有不属于任何一行，返回1。

结果

包含y0排，或1。

另请参见：

getRowHeight(int)， updateLayoutState()

convertRowToY

protected int convertRowToY(int row)

返回列表框相对坐标指定行的起源或1如果行无效。

结果

行的原点的Y坐标，或- 1。

另请参见：

getRowHeight(int)， updateLayoutState()

maybeUpdateLayoutState

protected void maybeUpdateLayoutState()

如果updatelayoutstateneeded是非零，叫updatelayoutstate()和复位updatelayoutstateneeded。这种方法应该被调用的方法之前做任何计算的基础上的几何形状的列表。例如，它在paint()和getpreferredsize()第一个电话。

另请参见：

updateLayoutState()

updateLayoutState

protected void updateLayoutState()

返回当前单元的高度或cellheights重构和基于返回当前单元的宽度值，基于当前字体和fixedcellwidth，fixedcellheight的当前值，并prototypecellvalue。

另请参见：

maybeUpdateLayoutState()

createMouseInputListener

protected MouseInputListener createMouseInputListener()

创建一个委托，实现了MouseInputListener。代表在installui()时间添加到相应的java.awt.component监听器列表。子类可以重写此方法以返回自定义MouseInputListener，例如

类mylistui延伸basiclistui {保护mouseinputlistener z-bbfef798-450e-4da2-b727- 2e18978fc5e5() {返回新的mymouseinputhandler()；}公共课mymouseinputhandler延伸MouseInputHandler {公共无效负责处理鼠标移动事件（MouseEvent e）{当鼠标移动时，做一些额外的工作超级负责处理鼠标移动事件（E）；}}}

另请参见：

BasicListUI.MouseInputHandler， installUI(javax.swing.JComponent)

createFocusListener

protected FocusListener createFocusListener()

createListSelectionListener

protected ListSelectionListener createListSelectionListener()

创建一个实例listselectionhandler的选择模式添加到jlists需要。子类可以重写此方法以返回自定义listselectionlistener，例如

类mylistui延伸basiclistui {保护listselectionlistener z-94b86616-1855-4b51-baba- 5868cb6f3716() {返回新的myselectionlistener()；}公共课myselectionlistener延伸listselectionhandler {public void valueChanged（listselectionevent e）{当选择改变时做一些额外的工作超级valuechange（E）；}}}

另请参见：

BasicListUI.ListSelectionHandler， installUI(javax.swing.JComponent)

createListDataListener

protected ListDataListener createListDataListener()

创建一个实例listdatalistener的模型添加到jlists需要。子类可以重写此方法以返回自定义listdatalistener，例如

类mylistui延伸basiclistui {保护listdatalistener z-8479e060-7d3c-438c-979a- 1416ab3715ce() {返回新的mylistdatalistener()；}公共课mylistdatalistener延伸listdatahandler {公共无效contentschanged（listdataevent e）{当模型内容改变时，做一些额外的工作超级contentschange（E）；}}}

另请参见：

ListDataListener， JList.getModel()， installUI(javax.swing.JComponent)

createPropertyChangeListener

protected PropertyChangeListener createPropertyChangeListener()

创建propertychangehandler的installui()添加到列表框的一个实例。子类可以重写此方法以返回自定义propertychangelistener，例如

类mylistui延伸basiclistui {保护propertychangelistener z-03ba4d35-12c0-4a4b-9fb0- 79eb300277ba() {返回新的mypropertychangelistener()；}公共课mypropertychangelistener延伸propertychangehandler {公共无效propertychange（PropertyChangeEvent e）{如果（如getpropertyname()。等于（“模型”））{当模型改变时，做一些额外的工作}超级propertychange（E）；}}}

另请参见：

PropertyChangeListener， installUI(javax.swing.JComponent)