JList的相关函数

Module java.desktop

Package javax.swing

Class JList<E>

• java.lang.Object
• • java.awt.Component
  • • java.awt.Container
    • • javax.swing.JComponent
      • • javax.swing.JList<E>

• Type Parameters:

  E - the type of the elements of this list

  All Implemented Interfaces:

  ImageObserver, MenuContainer, Serializable, Accessible, Scrollable

显示对象列表并允许用户选择一个或多个项的组件。一个单独的模型ListModel维护列表的内容

@BeanProperty(visualUpdate=true, enumerationValues={"JList.VERTICAL","JList.HORIZONTAL_WRAP","JList.VERTICAL_WRAP"}, description="Defines the way list cells are layed out.") public void setLayoutOrientation​(int layoutOrientation)

定义列表单元格的布局方式。

@BeanProperty(bound=false, enumerationValues={"ListSelectionModel.SINGLE_SELECTION","ListSelectionModel.SINGLE_INTERVAL_SELECTION","ListSelectionModel.MULTIPLE_INTERVAL_SELECTION"}, description="The selection mode.") public void setSelectionMode​(int selectionMode)

设置列表的选择模式。这是一个覆盖方法，它直接在选择模型上设置选择模式。

ListSelectionModel.SINGLE_SELECTION ——一次只能选择一个列表索引。在这种模式下，setSelectionInterval和addSelectionInterval是等价的，它们都用第二个参数(“lead”)表示的索引替换当前选择。

ListSelectionModel.SINGLE_INTERVAL_SELECTION——一次只能选择一个连续的间隔。在这种模式下，addSelectionInterval的行为类似于setSelectionInterval(替换当前选择}，除非给定的间隔与现有选择相邻或重叠，并且可以用于扩展选择。

ListSelectionModel.MULTIPLE_INTERVAL_SELECTION ——在这种模式下，对可以选择什么没有限制。此模式为默认模式。

@BeanProperty(visualUpdate=true, description="The cell prototype value, used to compute cell width and height.") public void setPrototypeCellValue​(E prototypeCellValue)

设置prototypeCellValue属性，然后(如果新值是非空的)，通过向单元格呈现器请求给定值的单元格呈现器组件(索引0)，并使用该组件的首选大小，计算fixedCellWidth和fixedCellHeight属性。

当列表太长，无法让ListUI计算每个单元格的宽度/高度，并且有一个单元格值与其他单元格值占用相同的空间时，这种方法非常有用，这就是所谓的原型。

public Color getSelectionBackground()

返回用于绘制选定项的背景的颜色。DefaultListCellRenderer和大多数ListUI实现安装的渲染器一样，使用这种颜色来绘制所选状态下项目的背景。

public Color getSelectionForeground()

这个函数与上一个函数的功能相同。