java.lang.Objectjavax.swing.plaf.ComponentUI
javax.swing.plaf.ListUI
javax.swing.plaf.basic.BasicListUI
public class BasicListUI
A Windows L&F implementation of ListUI.
Nested Class Summary | |
---|---|
class |
BasicListUI.FocusHandler
This inner class is marked "public" due to a compiler bug. |
class |
BasicListUI.ListDataHandler
The ListDataListener that's added to the JLists model at installUI time, and whenever the JList.model property changes. |
class |
BasicListUI.ListSelectionHandler
The ListSelectionListener that's added to the JLists selection model at installUI time, and whenever the JList.selectionModel property changes. |
class |
BasicListUI.MouseInputHandler
Mouse input, and focus handling for JList. |
class |
BasicListUI.PropertyChangeHandler
The PropertyChangeListener that's added to the JList at installUI time. |
Field Summary | |
---|---|
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 Summary | |
---|---|
BasicListUI
() |
Method Summary | |
---|---|
protected int |
convertRowToY
(int row) Return the JList relative Y coordinate of the origin of the specified row or -1 if row isn't valid. |
protected int |
convertYToRow
(int y0) Convert the JList relative coordinate to the row that contains it, based on the current layout. |
protected FocusListener |
createFocusListener
() |
protected ListDataListener |
createListDataListener
() Creates an instance of ListDataListener that's added to the JLists by model as needed. |
protected ListSelectionListener |
createListSelectionListener
() Creates an instance of ListSelectionHandler that's added to the JLists by selectionModel as needed. |
protected MouseInputListener |
createMouseInputListener
() Creates a delegate that implements MouseInputListener. |
protected PropertyChangeListener |
createPropertyChangeListener
() Creates an instance of PropertyChangeHandler that's added to the JList by installUI(). |
static ComponentUI |
createUI
(
JComponent
list) Returns a new instance of BasicListUI. |
![]() |
![]() ![]() ![]() ![]() |
![]() ![]() |
![]() ![]() ![]() ![]() |
Rectangle |
getCellBounds
(
JList
list, int index1, int index2) Returns the bounds of the specified item in JList coordinates, null if index isn't valid. |
Dimension |
getPreferredSize
(
JComponent
c) The preferredSize of the list depends upon the layout orientation. |
protected int |
getRowHeight
(int row) Returns the height of the specified row based on the current layout. |
Point |
indexToLocation
(
JList
list, int index) Returns the origin of the specified item in JList coordinates, null if index isn't valid. |
protected void |
installDefaults
() Initialize JList properties, e.g. |
protected void |
installKeyboardActions
() Registers the keyboard bindings on the JList that the BasicListUI is associated with. |
protected void |
installListeners
() Create and install the listeners for the JList, its model, and its selectionModel. |
void |
installUI
(
JComponent
c) Initializes this.list by calling installDefaults(), installListeners(), and installKeyboardActions() in order. |
int |
locationToIndex
(
JList
list,
Point
location) Convert a point in JList coordinates to the closest index of the cell at that location. |
protected void |
maybeUpdateLayoutState
() If updateLayoutStateNeeded is non zero, call updateLayoutState() and reset updateLayoutStateNeeded. |
void |
paint
(
Graphics
g,
JComponent
c) Paint the rows that intersect the Graphics objects clipRect. |
protected void |
paintCell
(
Graphics
g, int row,
Rectangle
rowBounds,
ListCellRenderer
cellRenderer,
ListModel
dataModel,
ListSelectionModel
selModel, int leadIndex) Paint one List cell: compute the relevant state, get the "rubber stamp" cell renderer component, and then use the CellRendererPane to paint it. |
protected void |
selectNextIndex
() Selected the previous row and force it to be visible. |
protected void |
selectPreviousIndex
() Selected the previous row and force it to be visible. |
protected void |
uninstallDefaults
() Set the JList properties that haven't been explicitly overridden to null. |
protected void |
uninstallKeyboardActions
() Unregisters keyboard actions installed from installKeyboardActions. |
protected void |
uninstallListeners
() Remove the listeners for the JList, its model, and its selectionModel. |
void |
uninstallUI
(
JComponent
c) Uninitializes this.list by calling uninstallListeners(), uninstallKeyboardActions(), and uninstallDefaults() in order. |
protected void |
updateLayoutState
() Recompute the value of cellHeight or cellHeights based and cellWidth, based on the current font and the current values of fixedCellWidth, fixedCellHeight, and 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 |
---|
protected JList list
protected CellRendererPane rendererPane
protected FocusListener focusListener
protected MouseInputListener mouseInputListener
protected ListSelectionListener listSelectionListener
protected ListDataListener listDataListener
protected PropertyChangeListener propertyChangeListener
protected int[] cellHeights
protected int cellHeight
protected int cellWidth
protected int updateLayoutStateNeeded
protected static final int modelChanged
protected static final int selectionModelChanged
protected static final int fontChanged
protected static final int fixedCellWidthChanged
protected static final int fixedCellHeightChanged
protected static final int prototypeCellValueChanged
protected static final int cellRendererChanged
Constructor Detail |
---|
public BasicListUI()
Method Detail |
---|
protected void paintCell(Graphics g, int row, Rectangle rowBounds, ListCellRenderer cellRenderer, ListModel dataModel, ListSelectionModel selModel, int leadIndex)
public void paint(Graphics g, JComponent c)
public int
getBaseline
(
JComponent
c, int width, int height)
public
Component.BaselineResizeBehavior
getBaselineResizeBehavior
(
JComponent
c)
public Dimension getPreferredSize(JComponent c)
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. |
protected void selectPreviousIndex()
protected void selectNextIndex()
protected void installKeyboardActions()
protected void uninstallKeyboardActions()
protected void installListeners()
protected void uninstallListeners()
protected void installDefaults()
protected void uninstallDefaults()
public void installUI(JComponent c)
public void uninstallUI(JComponent c)
public static ComponentUI createUI(JComponent list)
public int locationToIndex(JList list, Point location)
public Point indexToLocation(JList list, int index)
public Rectangle getCellBounds(JList list, int index1, int index2)
protected int getRowHeight(int row)
protected int convertYToRow(int y0)
protected int convertRowToY(int row)
protected void maybeUpdateLayoutState()
protected void updateLayoutState()
protected MouseInputListener createMouseInputListener()
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); } } }
protected FocusListener createFocusListener()
protected ListSelectionListener createListSelectionListener()
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); } } }
protected ListDataListener createListDataListener()
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); } } }
protected PropertyChangeListener createPropertyChangeListener()
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); } } }