©
本文档使用 PHP中文网手册 发布
|
JavaTM 2 Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
java.lang.Object java.awt.Component java.awt.Container javax.swing.JComponent javax.swing.JList
public class JList
显示对象列表并且允许用户选择一个或多个项的组件。单独的模型 ListModel
维护列表的内容。
使用能自动构建只读 ListModel
实例的 JList
构造方法,可以方便地显示对象数组或对象 Vector:
// Create a JList that displays strings from an array String[] data = {"one", "two", "three", "four"}; JList myList = new JList(data); // Create a JList that displays the superclasses of JList.class, by // creating it with a Vector populated with this data Vector superClasses = new Vector(); Class rootClass = javax.swing.JList.class; for(Class cls = rootClass; cls != null; cls = cls.getSuperclass()) { superClasses.addElement(cls); } JList myList = new JList(superClasses); // The automatically created model is stored in JList's "model" // property, which you can retrieve ListModel model = myList.getModel(); for(int i = 0; i可通过构造方法或
setModel
方法向JList
直接提供ListModel
。内容不需要是静态的,即项数和项值可以随时间而更改。正确的ListModel
实现在每次发生更改时通知已添加到其中的javax.swing.event.ListDataListener
集合。这些更改的特性由标识已修改、已添加或已移除的列表索引范围的javax.swing.event.ListDataEvent
来描述。通过侦听该模型,JList
的ListUI
负责保持可视化表示形式与更改一致。简单的、动态内容的
JList
应用程序可以使用DefaultListModel
类维护列表元素。此类实现ListModel
接口,它还提供类似于java.util.Vector
的 API。而需要自定义ListModel
实现的应用程序可能希望子类化AbstractListModel
,它提供对管理和通知侦听器的基本支持。例如,AbstractListModel
的一个只读实现:// This list model has about 2^16 elements. Enjoy scrolling. ListModel bigData = new AbstractListModel() { public int getSize() { return Short.MAX_VALUE; } public Object getElementAt(int index) { return "Index " + index; } };
JList
的选择状态由另一个独立模型(ListSelectionModel
的一个实例)进行管理。JList
在构造时使用选择模型初始化,它还包含要查询或设置此选择模型的方法。此外,JList
提供了便捷的方法,可以很容易地管理选择。这些方法(如setSelectedIndex
和getSelectedValue
)是维护与选择模型交互细节的覆盖方法。默认情况下,JList
的选择模型配置为允许一次选择项的任何组合;选择模式为MULTIPLE_INTERVAL_SELECTION
。选择模式可以在选择模型上进行直接更改,或者通过JList
的覆盖方法更改。更新选择模型以响应用户动作的责任取决于列表的ListUI
。正确的
ListSelectionModel
实现在每次选择发生更改时通知向其添加的javax.swing.event.ListSelectionListener
集合。这些更改的特征由标识选择更改范围的javax.swing.event.ListSelectionEvent
来描述。侦听列表选择中更改的首选方法是向
JList
中直接添加ListSelectionListener
。然后,JList
负责侦听选择模型并向侦听器通知更改。侦听选择更改以便使列表可视化表示形式保持最新的责任取决于列表的
ListUI
。绘制
JList
中的单元由称为单元渲染器(以cellRenderer
属性的形式安装在列表上)的委托进行处理。渲染器提供一个其用法类似 "rubber stamp" 的java.awt.Component
来绘制单元。每当需要绘制单元时,列表的ListUI
就请求组件的单元渲染器,将其移动到位,然后通过其paint
方法绘制单元的内容。默认单元渲染器(它使用JLabel
组件呈现)由列表的ListUI
安装。用户还可以使用如下代码替换自己的渲染器:// Display an icon and a string for each object in the list. class MyCellRenderer extends JLabel implements ListCellRenderer { final static ImageIcon longIcon = new ImageIcon("long.gif"); final static ImageIcon shortIcon = new ImageIcon("short.gif"); // This is the only method defined by ListCellRenderer. // We just reconfigure the JLabel each time we're called. public Component getListCellRendererComponent( JList list, // the list Object value, // value to display int index, // cell index boolean isSelected, // is the cell selected boolean cellHasFocus) // does the cell have focus { String s = value.toString(); setText(s); setIcon((s.length() > 10) ? longIcon : shortIcon); if (isSelected) { setBackground(list.getSelectionBackground()); setForeground(list.getSelectionForeground()); } else { setBackground(list.getBackground()); setForeground(list.getForeground()); } setEnabled(list.isEnabled()); setFont(list.getFont()); setOpaque(true); return this; } } myList.setCellRenderer(new MyCellRenderer());
嵌套类摘要 | |
---|---|
protected class |
JList.AccessibleJList
此类实现 JList 类的可访问性支持。 |
static class |
JList.DropLocation
TransferHandler.DropLocation 的一个子类,表示 JList 的放置位置 (drop location)。 |
从类 javax.swing.JComponent 继承的嵌套类/接口 |
---|
JComponent.AccessibleJComponent |
从类 java.awt.Container 继承的嵌套类/接口 |
---|
Container.AccessibleAWTContainer |
从类 java.awt.Component 继承的嵌套类/接口 |
---|
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy |
字段摘要 | |
---|---|
static int |
HORIZONTAL_WRAP
指示“报纸样式”布局,单元按先水平后垂直排列。 |
static int |
VERTICAL
指示单个列中单元的垂直布局;默认布局。 |
static int |
VERTICAL_WRAP
指示“报纸样式”布局,单元按先垂直后水平排列。 |
从类 javax.swing.JComponent 继承的字段 |
---|
accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW |
从类 java.awt.Component 继承的字段 |
---|
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT |
从接口 java.awt.image.ImageObserver 继承的字段 |
---|
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH |
构造方法摘要 | |
---|---|
JList()
构造一个具有空的、只读模型的 JList 。 |
|
JList(ListModel dataModel)
根据指定的 非 null 模型构造一个显示元素的 JList 。 |
|
JList(Object[] listData)
构造一个 JList ,使其显示指定数组中的元素。 |
|
JList(Vector<?> listData)
构造一个 JList ,使其显示指定 Vector 中的元素。 |
方法摘要 | |
---|---|
void |
addListSelectionListener(ListSelectionListener listener)
将侦听器添加到列表,每次选择发生更改时将获得通知;这是侦听选择状态更改的首选方式。 |
void |
addSelectionInterval(int anchor,
int lead)
将选择设置为指定间隔与当前选择的并集。 |
void |
clearSelection()
清除选择;调用此方法后, isSelectionEmpty 将返回 true 。 |
protected ListSelectionModel |
createSelectionModel()
返回一个 DefaultListSelectionModel 实例;在构造期间调用此方法初始化列表的选择模型属性。 |
void |
ensureIndexIsVisible(int index)
滚动封闭视口中的列表,使指定单元完全可见。 |
protected void |
fireSelectionValueChanged(int firstIndex,
int lastIndex,
boolean isAdjusting)
通知直接添加到列表的 ListSelectionListener 对列表模型做出了选择更改。 |
AccessibleContext |
getAccessibleContext()
获取与此 JList 关联的 AccessibleContext 。 |
int |
getAnchorSelectionIndex()
返回定位选择索引。 |
Rectangle |
getCellBounds(int index0,
int index1)
返回列表的坐标系统中两个索引所指定单元范围内的边界矩形。 |
ListCellRenderer |
getCellRenderer()
返回负责绘制列表项的对象。 |
boolean |
getDragEnabled()
返回是否启用自动拖动处理。 |
JList.DropLocation |
getDropLocation()
返回在该组件上执行 DnD 操作期间此组件应该视觉上指示为放置位置的位置;如果当前没有任何显示的位置,则返回 null 。 |
DropMode |
getDropMode()
返回此组件的放置模式。 |
int |
getFirstVisibleIndex()
返回当前可见的最小的列表索引。 |
int |
getFixedCellHeight()
返回 fixedCellHeight 属性的值。 |
int |
getFixedCellWidth()
返回 fixedCellWidth 属性的值。 |
int |
getLastVisibleIndex()
返回当前可见的最大列表索引。 |
int |
getLayoutOrientation()
返回列表的布局方向属性:如果布局是单列单元,则返回 VERTICAL ;如果布局是“报纸样式”并且内容按先垂直后水平排列, 则返回 VERTICAL_WRAP ;如果布局是“报纸样式”并且内容按先水平后垂直排列,则返回 HORIZONTAL_WRAP 。 |
int |
getLeadSelectionIndex()
返回前导选择索引。 |
ListSelectionListener[] |
getListSelectionListeners()
返回通过 addListSelectionListener 添加到此 JList 中的所有 ListSelectionListener 所组成的数组。 |
int |
getMaxSelectionIndex()
返回选择的最大单元索引;如果选择为空,则返回 -1 。 |
int |
getMinSelectionIndex()
返回选择的最小单元索引;如果选择为空,则返回 -1 。 |
ListModel |
getModel()
返回保存由 JList 组件显示的项列表的数据模型。 |
int |
getNextMatch(String prefix,
int startIndex,
Position.Bias bias)
返回其 toString 值以给定前缀开头的下一个列表元素。 |
Dimension |
getPreferredScrollableViewportSize()
计算显示 visibleRowCount 行所需的视口的大小。 |
Object |
getPrototypeCellValue()
返回“原型的”单元值,即用于计算单元的固定宽度和高度的值。 |
int |
getScrollableBlockIncrement(Rectangle visibleRect,
int orientation,
int direction)
返回为显露上一个或下一个块而滚动的距离。 |
boolean |
getScrollableTracksViewportHeight()
如果此 JList 在 JViewport 中显示并且视口的高度大于列表的首选高度,或者布局方向为 VERTICAL_WRAP 或 visibleRowCount <= 0 ,则返回 true ;否则返回 false 。 |
boolean |
getScrollableTracksViewportWidth()
如果此 JList 在 JViewport 中显示并且视口的宽度大于列表的首选宽度,或者布局方向为 HORIZONTAL_WRAP 和 visibleRowCount <= 0 ,则返回 true ;否则返回 false 。 |
int |
getScrollableUnitIncrement(Rectangle visibleRect,
int orientation,
int direction)
返回为显露上一个或下一个行(垂直滚动)或列(水平滚动)而滚动的距离。 |
int |
getSelectedIndex()
返回最小的选择单元索引;只选择了列表中单个项时,返回该选择。 |
int[] |
getSelectedIndices()
返回所选的全部索引的数组(按升序排列)。 |
Object |
getSelectedValue()
返回最小的选择单元索引的值;只选择了列表中单个项时,返回所选值。 |
Object[] |
getSelectedValues()
返回所有选择值的数组,根据其列表中的索引顺序按升序排序。 |
Color |
getSelectionBackground()
返回用于绘制选定项的背景的颜色。 |
Color |
getSelectionForeground()
返回用于绘制选定项的前景的颜色。 |
int |
getSelectionMode()
返回列表的当前选择模式。 |
ListSelectionModel |
getSelectionModel()
返回当前选择模型。 |
String |
getToolTipText(MouseEvent event)
返回用于给定事件的工具提示文本。 |
ListUI |
getUI()
返回呈现此组件的外观对象 ListUI 。 |
String |
getUIClassID()
返回 "ListUI" ,它是用于查找定义此组件外观的 javax.swing.plaf.ListUI 类名称的 UIDefaults 键。 |
boolean |
getValueIsAdjusting()
返回选择模型的 isAdjusting 属性的值。 |
int |
getVisibleRowCount()
返回 visibleRowCount 属性的值。 |
Point |
indexToLocation(int index)
返回列表的坐标系统中指定项的原点。 |
boolean |
isSelectedIndex(int index)
如果选择了指定的索引,则返回 true ;否则返回 false 。 |
boolean |
isSelectionEmpty()
如果什么也没有选择,则返回 true ;否则返回 false 。 |
int |
locationToIndex(Point location)
返回最接近列表的坐标系统中给定位置的单元索引。 |
protected String |
paramString()
返回此 JList 的 String 表示形式。 |
void |
removeListSelectionListener(ListSelectionListener listener)
从列表中移除一个选择侦听器。 |
void |
removeSelectionInterval(int index0,
int index1)
将选择设置为指定间隔和当前选择的差集。 |
void |
setCellRenderer(ListCellRenderer cellRenderer)
设置用于绘制列表中每个单元的委托。 |
void |
setDragEnabled(boolean b)
打开或关闭自动拖动处理。 |
void |
setDropMode(DropMode dropMode)
设置此组件的放置模式。 |
void |
setFixedCellHeight(int height)
设置一个固定值,将用于列表中每个单元的高度。 |
void |
setFixedCellWidth(int width)
设置一个固定值,将用于列表中每个单元的宽度。 |
void |
setLayoutOrientation(int layoutOrientation)
定义布置列表单元的方式。 |
void |
setListData(Object[] listData)
根据一个对象数组构造只读 ListModel ,然后对此模型调用 setModel 。 |
void |
setListData(Vector<?> listData)
根据一个 Vector 构造只读 ListModel ,然后对此模型调用 setModel 。 |
void |
setModel(ListModel model)
设置表示列表内容或列表“值”的模型,通知属性更改侦听器,然后清除列表选择。 |
void |
setPrototypeCellValue(Object prototypeCellValue)
设置 prototypeCellValue 属性,然后(如果新值为非 null )计算 fixedCellWidth 和 fixedCellHeight 属性:请求单元渲染器组件提供单元渲染器的给定值(及索引 0),并使用该组件的首选大小。 |
void |
setSelectedIndex(int index)
选择单个单元。 |
void |
setSelectedIndices(int[] indices)
将选择更改为给定数组所指定的索引的集合。 |
void |
setSelectedValue(Object anObject,
boolean shouldScroll)
从列表中选择指定的对象。 |
void |
setSelectionBackground(Color selectionBackground)
设置用于绘制选定项的背景的颜色,单元渲染器可以使用此颜色填充所选单元。 |
void |
setSelectionForeground(Color selectionForeground)
设置用于绘制选定项的前景的颜色,单元渲染器可以使用此颜色呈现文本和图形。 |
void |
setSelectionInterval(int anchor,
int lead)
选择指定的间隔。 |
void |
setSelectionMode(int selectionMode)
设置列表的选择模式。 |
void |
setSelectionModel(ListSelectionModel selectionModel)
将列表的 selectionModel 设置为非 null 的 ListSelectionModel 实现。 |
void |
setUI(ListUI ui)
设置呈现此组件的外观对象 ListUI 。 |
void |
setValueIsAdjusting(boolean b)
设置选择模型的 valueIsAdjusting 属性。 |
void |
setVisibleRowCount(int visibleRowCount)
设置 visibleRowCount 属性,对于不同的布局方向,此方法有不同的含义:对于 VERTICAL 布局方向,此方法设置要显示的首选行数(不要求滚动);对于其他方向,它影响单元的包装。 |
void |
updateUI()
重置 ListUI 属性,将其设置为当前外观所提供的值。 |
从类 javax.swing.JComponent 继承的方法 |
---|
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update |
从类 java.awt.Container 继承的方法 |
---|
add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusBackward, transferFocusDownCycle, validate, validateTree |
从类 java.awt.Component 继承的方法 |
---|
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusUpCycle |
从类 java.lang.Object 继承的方法 |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
字段详细信息 |
---|
public static final int VERTICAL
setLayoutOrientation(int)
,
常量字段值public static final int VERTICAL_WRAP
setLayoutOrientation(int)
,
常量字段值public static final int HORIZONTAL_WRAP
setLayoutOrientation(int)
,
常量字段值构造方法详细信息 |
---|
public JList(ListModel dataModel)
非 null
模型构造一个显示元素的 JList
。所有 JList
构造方法都委托给此方法。
此构造方法向 ToolTipManager
注册列表,允许工具提示由单元渲染器提供。
dataModel
- 该列表的模型
IllegalArgumentException
- 如果模型为 null
public JList(Object[] listData)
JList
,使其显示指定数组中的元素。此构造方法为给定数组创建一个只读模型,然后委托给带有 ListModel
的构造方法。
如果试图将一个 null
值传递给此方法,则会导致不确定的行为,最有可能导致异常。创建的模型直接引用给定的数组。如果试图在构造列表之后修改该数组,则会导致不确定的行为。
listData
- 要加载到数据模型中的 Object 的数组(为非 null
)public JList(Vector<?> listData)
JList
,使其显示指定 Vector
中的元素。此构造方法为给定 Vector
创建一个只读模型,然后委托给带有 ListModel
的构造方法。
如果试图将一个 null
值传递给此方法,则会导致不确定的行为,最有可能导致异常。创建的模型直接引用给定的 Vector
。如果试图在构造列表之后修改该 Vector
,则会导致不确定的行为。
listData
- 要加载到数据模型中的 Vector
(为非 null
)public JList()
JList
。
方法详细信息 |
---|
public ListUI getUI()
ListUI
。
ListUI
对象public void setUI(ListUI ui)
ListUI
。
ui
- ListUI
对象UIDefaults.getUI(javax.swing.JComponent)
public void updateUI()
ListUI
属性,将其设置为当前外观所提供的值。如果当前单元渲染器由开发人员(而不是外观本身)安装,则这还会导致单元渲染器及其子单元渲染器被更新(通过在其上调用 SwingUtilities.updateComponentTreeUI
)。
JComponent
中的 updateUI
UIManager.getUI(javax.swing.JComponent)
,
SwingUtilities.updateComponentTreeUI(java.awt.Component)
public String getUIClassID()
"ListUI"
,它是用于查找定义此组件外观的 javax.swing.plaf.ListUI
类名称的 UIDefaults
键。
JComponent
中的 getUIClassID
JComponent.getUIClassID()
,
UIDefaults.getUI(javax.swing.JComponent)
public Object getPrototypeCellValue()
null
。
prototypeCellValue
属性的值setPrototypeCellValue(java.lang.Object)
public void setPrototypeCellValue(Object prototypeCellValue)
prototypeCellValue
属性,然后(如果新值为非 null
)计算 fixedCellWidth
和 fixedCellHeight
属性:请求单元渲染器组件提供单元渲染器的给定值(及索引 0),并使用该组件的首选大小。
当由于列表过长而不允许 ListUI
计算每个单元的宽度/高度,并且已知某个单元值(所谓的原型)所占用的空间与任何其他单元一样多时,此方法很有用。
尽管 prototypeCellValue
、fixedCellHeight
和 fixedCellWidth
三个属性都可以由此方法进行修改时,但只有 prototypeCellValue
属性更改时才发送 PropertyChangeEvent
通知。
要查看设置此属性的示例,请参见上述类描述。
此属性的默认值为 null
。
这是一个 JavaBeans 绑定属性。
prototypeCellValue
- 作为 fixedCellWidth
和 fixedCellHeight
的基础的值getPrototypeCellValue()
,
setFixedCellWidth(int)
,
setFixedCellHeight(int)
,
Container.addPropertyChangeListener(java.beans.PropertyChangeListener)
public int getFixedCellWidth()
fixedCellWidth
属性的值。
setFixedCellWidth(int)
public void setFixedCellWidth(int width)
width
为 -1,则可以通过将 getPreferredSize
应用到每个列表元素的单元渲染器组件来计算 ListUI
的单元宽度。
此属性的默认值为 -1
。
这是一个 JavaBeans 绑定属性。
width
- 将用于该列表中所有单元的宽度setPrototypeCellValue(java.lang.Object)
,
setFixedCellWidth(int)
,
Container.addPropertyChangeListener(java.beans.PropertyChangeListener)
public int getFixedCellHeight()
fixedCellHeight
属性的值。
setFixedCellHeight(int)
public void setFixedCellHeight(int height)
height
为 -1,则可以通过将 getPreferredSize
应用到每个列表元素的单元渲染器组件来计算 ListUI
的单元高度。
此属性的默认值为 -1
。
这是一个 JavaBeans 绑定属性。
height
- 将用于该列表中所有单元的高度setPrototypeCellValue(java.lang.Object)
,
setFixedCellWidth(int)
,
Container.addPropertyChangeListener(java.beans.PropertyChangeListener)
public ListCellRenderer getCellRenderer()
cellRenderer
属性的值setCellRenderer(javax.swing.ListCellRenderer)
public void setCellRenderer(ListCellRenderer cellRenderer)
如果 prototypeCellValue
属性为非 null
,则设置单元渲染器还导致重新计算 fixedCellWidth
和 fixedCellHeight
属性。但是只对 cellRenderer
属性生成一个 PropertyChangeEvent
。
此属性的默认值由 ListUI
委托(即外观实现)提供。
这是一个 JavaBeans 绑定属性。
cellRenderer
- 绘制列表单元的 ListCellRenderer
getCellRenderer()
public Color getSelectionForeground()
DefaultListCellRenderer
使用此颜色来绘制选定状态中的项的前景,就像大多数 ListUI
实现安装的渲染器所做的一样。
setSelectionForeground(java.awt.Color)
,
DefaultListCellRenderer
public void setSelectionForeground(Color selectionForeground)
DefaultListCellRenderer
使用此颜色来绘制选定状态中的项的前景,就像大多数 ListUI
实现安装的渲染器所做的一样。
此属性的默认值由外观实现定义。
这是一个 JavaBeans 绑定属性。
selectionForeground
- 在所选列表项的前景中使用的 Color
getSelectionForeground()
,
setSelectionBackground(java.awt.Color)
,
JComponent.setForeground(java.awt.Color)
,
JComponent.setBackground(java.awt.Color)
,
JComponent.setFont(java.awt.Font)
,
DefaultListCellRenderer
public Color getSelectionBackground()
DefaultListCellRenderer
使用此颜色来绘制选定状态中的项的背景,就像大多数 ListUI
实现安装的渲染器所做的一样。
setSelectionBackground(java.awt.Color)
,
DefaultListCellRenderer
public void setSelectionBackground(Color selectionBackground)
DefaultListCellRenderer
使用此颜色来填充选定状态中的项的背景,就像大多数 ListUI
实现安装的渲染器所做的一样。
此属性的默认值由外观实现定义。
这是一个 JavaBeans 绑定属性。
selectionBackground
- 用于所选单元的背景的 Color
getSelectionBackground()
,
setSelectionForeground(java.awt.Color)
,
JComponent.setForeground(java.awt.Color)
,
JComponent.setBackground(java.awt.Color)
,
JComponent.setFont(java.awt.Font)
,
DefaultListCellRenderer
public int getVisibleRowCount()
visibleRowCount
属性的值。有关如何解释此值的详细信息,请参阅 setVisibleRowCount(int)
的文档。
visibleRowCount
属性的值。setVisibleRowCount(int)
public void setVisibleRowCount(int visibleRowCount)
visibleRowCount
属性,对于不同的布局方向,此方法有不同的含义:对于 VERTICAL
布局方向,此方法设置要显示的首选行数(不要求滚动);对于其他方向,它影响单元的包装。
在 VERTICAL
方向上:
设置此属性将影响 getPreferredScrollableViewportSize()
方法(它用于计算封闭视口的首选大小)的返回值。有关更多信息,请参阅该方法的文档。
在 HORIZONTAL_WRAP
和 VERTICAL_WRAP
方向上:
这将影响如何包装单元。有关更多信息,请参阅 setLayoutOrientation(int)
的文档。
此属性的默认值为 8
。
使用负值调用此方法将导致该属性被设置为 0
。
这是一个 JavaBeans 绑定属性。
visibleRowCount
- 一个整数值,指示要显示的首选行数(不要求滚动)getVisibleRowCount()
,
getPreferredScrollableViewportSize()
,
setLayoutOrientation(int)
,
JComponent.getVisibleRect()
,
JViewport
public int getLayoutOrientation()
VERTICAL
;如果布局是“报纸样式”并且内容按先垂直后水平排列, 则返回 VERTICAL_WRAP
;如果布局是“报纸样式”并且内容按先水平后垂直排列,则返回 HORIZONTAL_WRAP
。
layoutOrientation
属性的值setLayoutOrientation(int)
public void setLayoutOrientation(int layoutOrientation)
JList
。单元的布局可以采用以下方式之一:
VERTICAL: 0 1 2 3 4 HORIZONTAL_WRAP: 0 1 2 3 4 VERTICAL_WRAP: 0 3 1 4 2
这些布局的描述遵循如下内容:
值 |
描述 |
---|---|
VERTICAL
|
在单个列中垂直布置单元。 |
HORIZONTAL_WRAP
|
水平布置单元,根据需要将单元包装到新行中。如果 visibleRowCount 属性小于等于 0,则包装由该列表的宽度确定;否则,以确保列表中 visibleRowCount 行的方式进行包装。
|
VERTICAL_WRAP
|
垂直布置单元,根据需要将单元包装到新列中。如果 visibleRowCount 属性小于等于 0,则包装由该列表的宽度确定;否则,在 visibleRowCount 行进行包装。
|
此属性的默认值为 VERTICAL
。
layoutOrientation
- 新的布局方向,VERTICAL
、HORIZONTAL_WRAP
或 VERTICAL_WRAP
之一
IllegalArgumentException
- 如果 layoutOrientation
不是所允许的值之一getLayoutOrientation()
,
setVisibleRowCount(int)
,
getScrollableTracksViewportHeight()
,
getScrollableTracksViewportWidth()
public int getFirstVisibleIndex()
componentOrientation
中,第一个可见单元最接近列表的左上角。在从右到左方向上,它最接近右上角。如果任何单元都不可见或者列表为空,则返回 -1
。注意,返回的单元可能只有部分可见。
getLastVisibleIndex()
,
JComponent.getVisibleRect()
public int getLastVisibleIndex()
-1
。注意,返回的单元可能只有部分可见。
getFirstVisibleIndex()
,
JComponent.getVisibleRect()
public void ensureIndexIsVisible(int index)
scrollRectToVisible
。要让此方法生效,JList
必须在 JViewport
中。
如果给定索引超出列表中单元的范围,则此方法不起任何作用。
index
- 要变得可见的单元的索引JComponent.scrollRectToVisible(java.awt.Rectangle)
,
JComponent.getVisibleRect()
public void setDragEnabled(boolean b)
true
,列表的 TransferHandler
需要为非 null
。dragEnabled
属性的默认值为 false
。
遵守此属性的作业以及识别用户拖动动作取决于外观实现,尤其是列表的 ListUI
。启用自动拖动处理时,只要用户在项上按下鼠标按键,然后将鼠标移动几个像素,大多数外观(包括子类化 BasicLookAndFeel
的外观)就开始拖放操作了。因此,将此属性设置为 true
可以对选择的行为方式产生微妙的影响。
如果使用忽略此属性的外观,则仍然可以通过在列表的 TransferHandler
上调用 exportAsDrag
开始一个拖动操作。
b
- 是否启用自动拖动处理
HeadlessException
- 如果 b
为 true
并且 GraphicsEnvironment.isHeadless()
返回 true
GraphicsEnvironment.isHeadless()
,
getDragEnabled()
,
JComponent.setTransferHandler(javax.swing.TransferHandler)
,
TransferHandler
public boolean getDragEnabled()
dragEnabled
属性的值setDragEnabled(boolean)
public final void setDropMode(DropMode dropMode)
DropMode.USE_SELECTION
。但是,为了方便用户使用,建议使用其他模式。例如,DropMode.ON
提供与选择相似的显示项的行为,但执行此操作不会影响列表中的实际选择。
JList
支持下列放置模式:
DropMode.USE_SELECTION
DropMode.ON
DropMode.INSERT
DropMode.ON_OR_INSERT
TransferHandler
时,放置模式才有意义。
dropMode
- 要使用的放置模式
IllegalArgumentException
- 如果放置模式不受支持或为 null
getDropMode()
,
getDropLocation()
,
JComponent.setTransferHandler(javax.swing.TransferHandler)
,
TransferHandler
public final DropMode getDropMode()
setDropMode(javax.swing.DropMode)
public final JList.DropLocation getDropLocation()
null
。
此方法不用于查询 TransferHandler
的放置位置,因为只有在 TransferHandler
的 canImport
已返回并允许显示放置位置之后才设置了放置位置。
此属性更改时,带有 "dropLocation" 名称的属性更改事件由该组件触发。
默认情况下,负责侦听对此属性的更改以及视觉上指示放置位置的是列表的 ListUI
,它可以直接绘制该位置和/或安装一个用来执行此操作的渲染器。希望实现自定义放置操作绘制和/或替换默认单元渲染器的开发人员可能需要遵守此属性。
setDropMode(javax.swing.DropMode)
,
TransferHandler.canImport(TransferHandler.TransferSupport)
public int getNextMatch(String prefix, int startIndex, Position.Bias bias)
toString
值以给定前缀开头的下一个列表元素。
prefix
- 要测试是否匹配的字符串startIndex
- 开始搜索的索引bias
- 搜索方向,Position.Bias.Forward 或 Position.Bias.Backward。
-1
IllegalArgumentException
- 如果 prefix 为 null
或者 startIndex 超出范围public String getToolTipText(MouseEvent event)
JComponent
的 getToolTipText
,首先检查其上发生事件的单元的单元渲染器组件,并返回其工具提示文本(如果有)。此实现允许使用单元渲染器组件上的 setToolTipText
在单元层上指定工具提示文本。
JList
以此方式正确地显示其渲染器的工具提示,JList
必须是已向 ToolTipManager
注册的组件。此注册可以在构造方法中自动完成。但是,如果之后通过调用 setToolTipText(null)
注销了 JList
,则渲染器的提示将不再显示。
JComponent
中的 getToolTipText
event
- 用于获取工具提示文本的 MouseEvent
JComponent.setToolTipText(java.lang.String)
,
JComponent.getToolTipText()
public int locationToIndex(Point location)
getCellBounds
提供。如果模型为空,则此方法返回 -1
此方法是委托给列表的 ListUI
中同名方法的覆盖方法。如果列表没有 ListUI
,则它返回 -1
。
location
- 点的坐标
-1
public Point indexToLocation(int index)
null
。
此方法是委托给列表的 ListUI
中同名方法的覆盖方法。如果列表没有 ListUI
,则它返回 null
。
index
- 单元索引
null
public Rectangle getCellBounds(int index0, int index1)
如果较小索引超出单元的列表范围,则此方法返回 null
。如果较小索引有效,但较大索引超出列表范围,则只返回第一个索引的边界。否则,返回有效范围的边界。
此方法是委托给列表的 ListUI
中同名方法的覆盖方法。如果列表没有 ListUI
,则它返回 null
。
index0
- 范围中的第一个索引index1
- 范围中的第二个索引
null
public ListModel getModel()
JList
组件显示的项列表的数据模型。
ListModel
setModel(javax.swing.ListModel)
public void setModel(ListModel model)
这是一个 JavaBeans 绑定属性。
model
- 提供要显示的项列表的 ListModel
IllegalArgumentException
- 如果 model
为 null
getModel()
,
clearSelection()
public void setListData(Object[] listData)
ListModel
,然后对此模型调用 setModel
。
试图将 null
值传递给此方法将导致不确定的行为,很有可能是异常。创建的模型直接引用给定数组。试图在调用此方法之后修改该数组将导致不确定的行为。
listData
- 包含要在列表中显示的项的 Object
数组setModel(javax.swing.ListModel)
public void setListData(Vector<?> listData)
Vector
构造只读 ListModel
,然后对此模型调用 setModel
。
试图将 null
值传递给此方法将导致不确定的行为,很有可能是异常。创建的模型直接引用给定 Vector
。试图在调用此方法之后修改该 Vector
将导致不确定的行为。
listData
- 包含要在列表中显示的项的 Vector
setModel(javax.swing.ListModel)
protected ListSelectionModel createSelectionModel()
DefaultListSelectionModel
实例;在构造期间调用此方法初始化列表的选择模型属性。
DefaultListSelecitonModel
,用于在构造期间初始化列表的选择模型属性setSelectionModel(javax.swing.ListSelectionModel)
,
DefaultListSelectionModel
public ListSelectionModel getSelectionModel()
ListSelectionModel
setSelectionModel(javax.swing.ListSelectionModel)
,
ListSelectionModel
protected void fireSelectionValueChanged(int firstIndex, int lastIndex, boolean isAdjusting)
ListSelectionListener
对列表模型做出了选择更改。JList
侦听选择模型中对选择所做的更改,并通过调用此方法将通知转发到直接添加到列表的侦听器。
此方法以此列表作为源,使用指定的参数构造 ListSelectionEvent
,并将其发送到已注册的 ListSelectionListener
。
firstIndex
- 范围内的第一个索引(<= lastIndex
)lastIndex
- 范围内的最后一个索引(>= firstIndex
)isAdjusting
- 此事件是否是多个连续事件之一,其中更改仍然在进行addListSelectionListener(javax.swing.event.ListSelectionListener)
,
removeListSelectionListener(javax.swing.event.ListSelectionListener)
,
ListSelectionEvent
,
EventListenerList
public void addListSelectionListener(ListSelectionListener listener)
JList
负责侦听选择模型中选择状态更改,并通知每个更改的给定侦听器。发送到侦听器的 ListSelectionEvent
具有设置为此列表的 source
属性。
listener
- 要添加的 ListSelectionListener
getSelectionModel()
,
getListSelectionListeners()
public void removeListSelectionListener(ListSelectionListener listener)
listener
- 要移除的 ListSelectionListener
getSelectionModel()
,
getListSelectionListeners()
public ListSelectionListener[] getListSelectionListeners()
addListSelectionListener
添加到此 JList
中的所有 ListSelectionListener
所组成的数组。
ListSelectionListener
;如果没有添加任何侦听器,则返回空数组addListSelectionListener(javax.swing.event.ListSelectionListener)
public void setSelectionModel(ListSelectionModel selectionModel)
selectionModel
设置为非 null
的 ListSelectionModel
实现。选择模型可以完成单个选择、连续范围选择和非连续范围选择等任务。
这是一个 JavaBeans 绑定属性。
selectionModel
- 实现选择的 ListSelectionModel
IllegalArgumentException
- 如果 selectionModel
为 null
getSelectionModel()
public void setSelectionMode(int selectionMode)
以下列表描述了可接受的选择模式:
ListSelectionModel.SINGLE_SELECTION
- 一次只能选择一个列表索引。在此模式中,setSelectionInterval
和 addSelectionInterval
是等效的,两者都使用第二个参数(“lead”)所表示的索引来替换当前选择。
ListSelectionModel.SINGLE_INTERVAL_SELECTION
- 一次只能选择一个连续间隔。在此模式中,如果给定间隔没有紧邻着现有选择或与现有选择重叠,则 addSelectionInterval
与 setSelectionInterval
完全相同(替换当前选择),并可用于生成选择。
ListSelectionModel.MULTIPLE_INTERVAL_SELECTION
- 在此模式中,不存在对选择的限制。此模式是默认设置。
selectionMode
- 选择模式
IllegalArgumentException
- 如果选择模式不是那些允许的模式之一getSelectionMode()
public int getSelectionMode()
setSelectionMode(int)
public int getAnchorSelectionIndex()
ListSelectionModel.getAnchorSelectionIndex()
public int getLeadSelectionIndex()
ListSelectionModel.getLeadSelectionIndex()
public int getMinSelectionIndex()
-1
。此方法是委托给列表的选择模型上同名方法的覆盖方法。
-1
ListSelectionModel.getMinSelectionIndex()
public int getMaxSelectionIndex()
-1
。此方法是委托给列表的选择模型上同名方法的覆盖方法。
ListSelectionModel.getMaxSelectionIndex()
public boolean isSelectedIndex(int index)
true
;否则返回 false
。此方法是委托给列表的选择模型上同名方法的覆盖方法。
index
- 要查询其选择状态的索引
true
;否则返回 false
ListSelectionModel.isSelectedIndex(int)
,
setSelectedIndex(int)
public boolean isSelectionEmpty()
true
;否则返回 false
。此方法是委托给列表的选择模型上同名方法的覆盖方法。
true
;否则返回 false
ListSelectionModel.isSelectionEmpty()
,
clearSelection()
public void clearSelection()
isSelectionEmpty
将返回 true
。此方法是委托给列表的选择模型上同名方法的覆盖方法。
ListSelectionModel.clearSelection()
,
isSelectionEmpty()
public void setSelectionInterval(int anchor, int lead)
anchor
和 lead
两个索引。anchor
不必小于等于 lead
。此方法是委托给列表的选择模型上同名方法的覆盖方法。
有关如何处理小于 0
的值的详细信息,请参阅所用选择模型类的文档。
anchor
- 要选择的第一个索引lead
- 要选择的最后一个索引ListSelectionModel.setSelectionInterval(int, int)
,
DefaultListSelectionModel.setSelectionInterval(int, int)
,
createSelectionModel()
,
addSelectionInterval(int, int)
,
removeSelectionInterval(int, int)
public void addSelectionInterval(int anchor, int lead)
anchor
和 lead
两个索引。anchor
不必小于等于 lead
。此方法是委托给列表的选择模型上同名方法的覆盖方法。
有关如何处理小于 0
的值的详细信息,请参阅所用选择模型类的文档。
anchor
- 要添加到选择的第一个索引lead
- 要添加到选择的最后一个索引ListSelectionModel.addSelectionInterval(int, int)
,
DefaultListSelectionModel.addSelectionInterval(int, int)
,
createSelectionModel()
,
setSelectionInterval(int, int)
,
removeSelectionInterval(int, int)
public void removeSelectionInterval(int index0, int index1)
index0
和 index1
都要移除。index0
不必小于等于 index1
。此方法是委托给列表的选择模型上同名方法的覆盖方法。
有关如何处理小于 0
的值的详细信息,请参阅所用选择模型类的文档。
index0
- 要从选择移除的第一个索引index1
- 要从选择移除的最后一个索引ListSelectionModel.removeSelectionInterval(int, int)
,
DefaultListSelectionModel.removeSelectionInterval(int, int)
,
createSelectionModel()
,
setSelectionInterval(int, int)
,
addSelectionInterval(int, int)
public void setValueIsAdjusting(boolean b)
valueIsAdjusting
属性。当为 true
时,即将进行的选择更改应该被视为单个更改的一部分。此属性供内部使用,开发人员通常不要调用此方法。例如,模型正被更新以响应用户拖动时,如果拖动已经开始,那么该属性值被设置为 true
;如果拖动已经结束,则被设置为 false
。此属性允许侦听器只在更改结束时进行更新,而不是处理所有的中间值。
如果所做的一系列更改都应该被视为单个更改的一部分,则可能需要直接使用此方法。
此方法是委托给列表的选择模型上同名方法的覆盖方法。有关更多信息,请参阅 ListSelectionModel.setValueIsAdjusting(boolean)
的文档。
b
- 属性的新值ListSelectionModel.setValueIsAdjusting(boolean)
,
ListSelectionEvent.getValueIsAdjusting()
,
getValueIsAdjusting()
public boolean getValueIsAdjusting()
isAdjusting
属性的值。
此方法是委托给列表的选择模型上同名方法的覆盖方法。
isAdjusting
属性的值。setValueIsAdjusting(boolean)
,
ListSelectionModel.getValueIsAdjusting()
public int[] getSelectedIndices()
removeSelectionInterval(int, int)
,
addListSelectionListener(javax.swing.event.ListSelectionListener)
public void setSelectedIndex(int index)
setSelectionInterval
的便捷方法。有关如何处理小于 0
的值的详细信息,请参阅所用选择模型类的文档。
index
- 要选择的单元的索引ListSelectionModel.setSelectionInterval(int, int)
,
isSelectedIndex(int)
,
addListSelectionListener(javax.swing.event.ListSelectionListener)
public void setSelectedIndices(int[] indices)
addSelectionInterval
添加索引的便捷方法。有关如何处理小于 0
的值的详细信息,请参阅所用选择模型类的文档。
indices
- 要选择的单元的索引数组(为非 null
)
NullPointerException
- 如果给定数组为 null
ListSelectionModel.addSelectionInterval(int, int)
,
isSelectedIndex(int)
,
addListSelectionListener(javax.swing.event.ListSelectionListener)
public Object[] getSelectedValues()
isSelectedIndex(int)
,
getModel()
,
addListSelectionListener(javax.swing.event.ListSelectionListener)
public int getSelectedIndex()
-1
。
此方法是委托给 getMinSelectionIndex
的覆盖方法。
getMinSelectionIndex()
,
addListSelectionListener(javax.swing.event.ListSelectionListener)
public Object getSelectedValue()
null
。
此方法是返回 getMinSelectionIndex
的模型值的便捷方法。
getMinSelectionIndex()
,
getModel()
,
addListSelectionListener(javax.swing.event.ListSelectionListener)
public void setSelectedValue(Object anObject, boolean shouldScroll)
anObject
- 要选择的对象shouldScroll
- 如果所选对象存在,但列表需要滚动才能显示,则为 true
;否则为 false
public Dimension getPreferredScrollableViewportSize()
visibleRowCount
行所需的视口的大小。此方法所返回的值取决于布局方向:
VERTICAL
:
如果已(显式地或通过指定一个原型单元值)设置了 fixedCellWidth
和 fixedCellHeight
,则此操作无足轻重。宽度是 fixedCellWidth
加上列表的水平 insets。高度是 fixedCellHeight
乘以 visibleRowCount
再加上列表的垂直 insets。
如果尚未指定 fixedCellWidth
或 fixedCellHeight
,则使用直观推断。模型为空时,如果 fixedCellWidth
大于 0
,则宽度为 fixedCellWidth
,否则为 256
的固定编码 (hard coded) 值。如果 fixedCellHeight
大于 0
,则高度为 fixedCellHeight
乘以 visibleRowCount
;否则它是固定编码 (hard coded) 值 16
乘以 visibleRowCount
。
如果模型不为空,则宽度为首选大小的宽度,通常是最宽的列表元素的宽度。高度是 fixedCellHeight
乘以 visibleRowCount
再加上列表的垂直 insets。
VERTICAL_WRAP
或 HORIZONTAL_WRAP
:
此方法只返回 getPreferredSize
的返回值。期望列表的 ListUI
重写 getPreferredSize
以返回适当的值。
Scrollable
中的 getPreferredScrollableViewportSize
visibleRowCount
行所需视口大小的 dimensiongetPreferredScrollableViewportSize()
,
setPrototypeCellValue(java.lang.Object)
public int getScrollableUnitIncrement(Rectangle visibleRect, int orientation, int direction)
对于水平滚动,如果布局方向为 VERTICAL
,则返回列表的字体大小(如果字体为 null
,则返回 1
)。
Scrollable
中的 getScrollableUnitIncrement
visibleRect
- 视口中可见的视图区域orientation
- SwingConstants.HORIZONTAL
或 SwingConstants.VERTICAL
direction
- 小于等于 0 表示向上滚动/后退,大于 0 表示向下滚动/前进
IllegalArgumentException
- 如果 visibleRect
为 null
,或者 orientation
不为 SwingConstants.VERTICAL
或 SwingConstants.HORIZONTAL
getScrollableBlockIncrement(java.awt.Rectangle, int, int)
,
Scrollable.getScrollableUnitIncrement(java.awt.Rectangle, int, int)
public int getScrollableBlockIncrement(Rectangle visibleRect, int orientation, int direction)
对于垂直滚动,使用以下规则:
visibleRect.height
对于水平滚动,当布局方向为 VERTICAL_WRAP
或 HORIZONTAL_WRAP
时:
visibleRect.width
对于水平滚动和 VERTICAL
方向,则返回 visibleRect.width
。
注意,visibleRect
的值必须等于 this.getVisibleRect()
。
Scrollable
中的 getScrollableBlockIncrement
visibleRect
- 视口中可见的视图区域orientation
- SwingConstants.HORIZONTAL
或 SwingConstants.VERTICAL
direction
- 小于等于 0 表示向上滚动/后退,大于 0 表示向下滚动/前进
IllegalArgumentException
- 如果 visibleRect
为 null
,或者 orientation
不为 SwingConstants.VERTICAL
或 SwingConstants.HORIZONTAL
getScrollableUnitIncrement(java.awt.Rectangle, int, int)
,
Scrollable.getScrollableBlockIncrement(java.awt.Rectangle, int, int)
public boolean getScrollableTracksViewportWidth()
JList
在 JViewport
中显示并且视口的宽度大于列表的首选宽度,或者布局方向为 HORIZONTAL_WRAP
和 visibleRowCount <= 0
,则返回 true
;否则返回 false
。
如果返回 false
,则不跟踪视口宽度。如果 JViewport
本身嵌入在 JScrollPane
中,则此操作允许水平滚动。
Scrollable
中的 getScrollableTracksViewportWidth
Scrollable.getScrollableTracksViewportWidth()
public boolean getScrollableTracksViewportHeight()
JList
在 JViewport
中显示并且视口的高度大于列表的首选高度,或者布局方向为 VERTICAL_WRAP
或 visibleRowCount <= 0
,则返回 true
;否则返回 false
。
如果返回 false
,则不跟踪视口高度。如果 JViewport
本身嵌入在 JScrollPane
中,则此操作允许垂直滚动。
Scrollable
中的 getScrollableTracksViewportHeight
Scrollable.getScrollableTracksViewportHeight()
protected String paramString()
JList
的 String
表示形式。此方法仅在进行调试的时候使用,对于各个实现,所返回 String
的内容和格式可能有所不同。返回的 String
可以为空,但不可以为 null
。
JComponent
中的 paramString
JList
的 String
表示形式。public AccessibleContext getAccessibleContext()
JList
关联的 AccessibleContext
。对于 JList
,AccessibleContext
采取 AccessibleJList
的形式。
如有必要,可以创建一个新的 AccessibleJList
实例。
Accessible
中的 getAccessibleContext
JComponent
中的 getAccessibleContext
AccessibleJList
,它充当此 JList
的 AccessibleContext
|
JavaTM 2 Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。