Java swing系列之JList类(4)

JList方法集锦：

public ListUI getUI()

返回呈现此组件的外观对象 ListUI。

public void setUI(ListUI ui)

设置呈现此组件的外观对象 ListUI。

public void updateUI()

重置 ListUI 属性，将其设置为当前外观所提供的值。如果当前单元渲染器由开发人员（而不是外观本身）安装，则这还会导致单元渲染器及其子单元渲染器被更新。

public String getUIClassID()

返回 "ListUI"，它是用于查找定义此组件外观的 javax.swing.plaf.ListUI 类名称的 UIDefaults 键。

public Object getPrototypeCellValue()

返回“原型的”单元值，即用于计算单元的固定宽度和高度的值。如果没有这样的值，则可以返回 null。

public void setPrototypeCellValue(Object prototypeCellValue)

设置 prototypeCellValue 属性，然后（如果新值为非 null）计算 fixedCellWidth 和 fixedCellHeight 属性：请求单元渲染器组件提供单元渲染器的给定值（及索引 0），并使用该组件的首选大小。

当由于列表过长而不允许 ListUI 计算每个单元的宽度/高度，并且已知某个单元值（所谓的原型）所占用的空间与任何其他单元一样多时，此方法很有用。

尽管 prototypeCellValue、fixedCellHeight 和 fixedCellWidth 三个属性都可以由此方法进行修改时，但只有 prototypeCellValue 属性更改时才发送 PropertyChangeEvent 通知。

此属性的默认值为 null。

这是一个 JavaBeans 绑定属性。

public int getFixedCellWidth()

返回 fixedCellWidth 属性的值。

public void setFixedCellWidth(int width)

设置一个固定值，将用于列表中每个单元的宽度。如果 width 为 -1，则可以通过将 getPreferredSize 应用到每个列表元素的单元渲染器组件来计算 ListUI 的单元宽度。

此属性的默认值为 -1。

这是一个 JavaBeans 绑定属性。

public int getFixedCellHeight() 

返回固定单元高度 。

public void setFixedCellHeight(int height)

设置一个固定值，将用于列表中每个单元的高度。

public ListCellRenderer getCellRenderer()

返回负责绘制列表项的对象。

public void setCellRenderer( ListCellRenderer cellRenderer)

设置用于绘制列表中每个单元的委托。类级别文档中更加详细地讨论了单元渲染器的工作。

如果 prototypeCellValue 属性为非 null，则设置单元渲染器还导致重新计算 fixedCellWidth 和fixedCellHeight 属性。但是只对 cellRenderer 属性生成一个 PropertyChangeEvent。

此属性的默认值由 ListUI 委托（即外观实现）提供。

这是一个 JavaBeans 绑定属性。

public Color getSelectionForeground()

返回用于绘制选定项的前景的颜色。

public void setSelectionForeground(Color selectionForeground)

设置用于绘制选定项的前景的颜色。

public int getVisibleRowCount()

返回 visibleRowCount 属性的值。

public int getLayoutOrientation()

返回列表的布局方向属性：如果布局是单列单元，则返回 VERTICAL；如果布局是“报纸样式”并且内容按先垂直后水平排列， 则返回 VERTICAL_WRAP；如果布局是“报纸样式”并且内容按先水平后垂直排列，则返回HORIZONTAL_WRAP。

public void setLayoutOrientation(int layoutOrientation)

定义布置列表单元的方式。

public int getFirstVisibleIndex()

返回当前可见的最小的列表索引。

public int getLastVisibleIndex()

返回当前可见的最大列表索引。

public void ensureIndexIsVisible(int index)

滚动封闭视口中的列表，使指定单元完全可见。

public void setDragEnabled(boolean b)

打开或关闭自动拖动处理。

public boolean getDragEnabled()

返回是否启用自动拖动处理。

public final void setDropMode(DropMode dropMode)

设置此组件的放置模式。

 

public final DropMode getDropMode()

返回此组件的放置模式。

public final JList.DropLocation getDropLocation()

返回在该组件上执行 DnD 操作期间此组件应该视觉上指示为放置位置的位置；如果当前没有任何显示的位置，则返回 null。

public int locationToIndex(Point location)

返回最接近列表的坐标系统中给定位置的单元索引。

public Point indexToLocation(int index)

返回列表的坐标系统中指定项的原点。

public Rectangle getCellBounds(int index0, int index1)

返回列表的坐标系统中两个索引所指定单元范围内的边界矩形。

public ListModel getModel()

返回保存由 JList 组件显示的项列表的数据模型。

public void setModel(ListModel model)

设置表示列表内容或列表“值”的模型，通知属性更改侦听器，然后清除列表选择。

public void setListData(Object[] listData)

根据一个对象数组构造只读 ListModel，然后对此模型调用 setModel。

public void setListData(Vector<?> listData)

根据一个 Vector 构造只读 ListModel，然后对此模型调用 setModel。

protected ListSelectionModel createSelectionModel()

返回一个 DefaultListSelectionMode l 实例；在构造期间调用此方法初始化列表的选择模型属性。

public ListSelectionModel getSelectionModel()

返回当前选择模型。选择模型维护列表的选择状态。

protected void fireSelectionValueChanged(int firstIndex,
                                         int lastIndex,
                                         boolean isAdjusting)

通知直接添加到列表的 ListSelectionListener 对列表模型做出了选择更改。JList 侦听选择模型中对选择所做的更改，并通过调用此方法将通知转发到直接添加到列表的侦听器。

public void addListSelectionListener(ListSelectionListener listener)

将侦听器添加到列表，每次选择发生更改时将获得通知；这是侦听选择状态更改的首选方式。

public void removeListSelectionListener(ListSelectionListener listener)

从列表中移除一个选择侦听器。

public ListSelectionListener[] getListSelectionListeners()

返回通过 addListSelectionListener  添加到此 JList 中的所有 ListSelectionListener 所组成的数组。

public void setSelectionModel(ListSelectionModel selectionModel)

将列表的 selectionModel 设置为非 null 的 ListSelectionModel 实现。

public void setSelectionMode(int selectionMode)

设置列表的选择模式。此方法是在选择模型上直接设置选择模式的覆盖方法。

 

public int getLeadSelectionIndex()

返回前导选择索引。此方法是委托给列表的选择模型上同名方法的覆盖方法。

 

public int getMinSelectionIndex()

返回选择的最小单元索引；如果选择为空，则返回 -1。此方法是委托给列表的选择模型上同名方法的覆盖方法。

public int getMaxSelectionIndex()

返回选择的最大单元索引；如果选择为空，则返回 -1。

public boolean isSelectedIndex(int index)

如果选择了指定的索引，则返回 true；否则返回 false。

public boolean isSelectionEmpty()

如果什么也没有选择，则返回 true；否则返回 false。

public void clearSelection()

清除选择；调用此方法后，isSelectionEmpty 将返回 true。

public void setSelectionInterval(int anchor, int lead)

选择指定的间隔。包括 anchor 和 lead 两个索引。

public void addSelectionInterval(int anchor, int lead)

将选择设置为指定间隔与当前选择的并集。包括 anchor 和 lead 两个索引。

public void removeSelectionInterval(int index0, int index1)

将选择设置为指定间隔和当前选择的差集。两个索引 index0 和 index1 都要移除

public void setValueIsAdjusting(boolean b)

设置选择模型的 valueIsAdjusting 属性。当为 true 时，即将进行的选择更改应该被视为单个更改的一部分。

public boolean getValueIsAdjusting()

返回选择模型的 isAdjusting 属性的值。

public int[] getSelectedIndices()

返回所选的全部索引的数组（按升序排列）。

public void setSelectedIndex(int index)

选择单个单元。如果给定索引大于等于模型大小，则不执行任何操作。

public void setSelectedIndices(int[] indices)

将选择更改为给定数组所指定的索引的集合。

public Object[] getSelectedValues()

返回所有选择值的数组，根据其列表中的索引顺序按升序排序。

public int getSelectedIndex()

返回最小的选择单元索引；只选择了列表中单个项时，返回该选择。选择了多项时，则只返回最小的选择索引。如果什么也没有选择，则返回 -1。

public Object getSelectedValue()

返回最小的选择单元索引的值；只选择了列表中单个项时，返回所选值。选择了多项时，返回最小的选择索引的值。如果什么也没有选择，则返回 null。

public void setSelectedValue(Object anObject, boolean shouldScroll)

从列表中选择指定的对象。

public Dimension getPreferredScrollableViewportSize()

计算显示 visibleRowCount 行所需的视口的大小。此方法所返回的值取决于布局方向：

public int getScrollableUnitIncrement(Rectangle visibleRect, int orientation, int direction)

返回为显露上一个或下一个行（垂直滚动）或列（水平滚动）而滚动的距离。

public int getScrollableBlockIncrement(Rectangle visibleRect, int orientation, int direction)

返回为显露上一个或下一个块而滚动的距离。

对于垂直滚动，使用以下规则：

• 如果向下滚动，则返回使最后一个可见元素就成为第一个完全可见元素的滚动距离
• 如果向上滚动，则返回使第一个可见元素就成为最后一个完全可见元素的滚动距离
• 如果列表为空，则返回 visibleRect.height

对于水平滚动，当布局方向为 VERTICAL_WRAP 或 HORIZONTAL_WRAP 时：

• 如果向右滚动，则返回使最后一个可见元素就成为第一个完全可见元素的滚动距离
• 如果向左滚动，则返回使第一个可见元素就成为最后一个完全可见元素的滚动距离
• 如果列表为空，则返回 visibleRect.width

public boolean getScrollableTracksViewportWidth()

如果此 JList 在 JViewport 中显示并且视口的宽度大于列表的首选宽度，或者布局方向为 HORIZONTAL_WRAP和 visibleRowCount <= 0，则返回 true；否则返回 false。

public boolean getScrollableTracksViewportHeight()

如果此 JList 在 JViewport 中显示并且视口的高度大于列表的首选高度，或者布局方向为 VERTICAL_WRAP 或visibleRowCount <= 0，则返回 true；否则返回 false。

protected String paramString()

返回此 JList 的 String 表示形式。

public AccessibleContext getAccessibleContext()

获取与此  JList 关联的 AccessibleContext。