Class BasicXListUI
- java.lang.Object
-
- javax.swing.plaf.ComponentUI
-
- javax.swing.plaf.ListUI
-
- javax.swing.plaf.basic.BasicListUI
-
- org.jdesktop.swingx.plaf.basic.core.BasicXListUI
-
- Direct Known Subclasses:
SynthXListUI
public class BasicXListUI extends javax.swing.plaf.basic.BasicListUI
An extensible implementation ofListUI
for JXList.BasicXListUI
instances cannot be shared between multiple lists.The heart of added functionality is to support sorting/filtering, that is keep model-selection and RowSorter state synchronized. The details are delegated to a ListSortUI, but this class is responsible to manage the sortUI on changes of list properties, model and view selection (same strategy as in JXTable).
Note: this delegate is mostly a 1:1 copy of BasicListUI. The difference is that it accesses the list elements and list elementCount exclusively through the JXList api. This allows a clean implementation of sorting/filtering.
The differences (goal was to touch as little code as possible as this needs to be updated on every change to core until that is changed to not access the list's model directly, sigh) for core functionality:
- extracted method for list.getModel().getSize (for the delegate class and all contained static classes) and use that method exclusively
- similar for remaining list.getModel(): implemented wrapping listModel which messages the list
- rename key for shared actionMap to keep core list actions separate (just in case somebody wants both) - they point to the wrong delegate
- replaced references to SwingUtilities2 in sun packages by references to c&p'ed methods in SwingXUtilities
- replaced storage of shared Input/ActionMap in defaultLookup by direct storage in UIManager.
- added methods to un/-installSortUI and call in un/installUI(component)
- changed PropertyChangeHandler to call a) hasHandledPropertyChange to allow this class to replace super handler functinality and b) updateSortUI after handling all not-sorter related properties.
- changed createPropertyChangeListener to return a PropertyChangeHandler
- changed ListDataHandler to check if event handled by SortUI and delegate to handler only if not
- changed createListDataListener to return a ListDataHandler
- changed ListSelectionHandler to check if event handled by SortUI and delegate to handler only if not
- Issue #1495-swingx: getBaseline throughs NPE
- Version:
- 1.127 12/02/08
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description private static class
BasicXListUI.Actions
class
BasicXListUI.FocusHandler
This inner class is marked "public" due to a compiler bug.private class
BasicXListUI.Handler
class
BasicXListUI.ListDataHandler
The ListDataListener that's added to the JLists model at installUI time, and whenever the JList.model property changes.class
BasicXListUI.ListSelectionHandler
The ListSelectionListener that's added to the JLists selection model at installUI time, and whenever the JList.selectionModel property changes.(package private) static class
BasicXListUI.ListTransferHandler
class
BasicXListUI.MouseInputHandler
Mouse input, and focus handling for JList.class
BasicXListUI.PropertyChangeHandler
The PropertyChangeListener that's added to the JList at installUI time.
-
Field Summary
Fields Modifier and Type Field Description private static java.lang.StringBuilder
BASELINE_COMPONENT_KEY
protected int
cellHeight
protected int[]
cellHeights
protected static int
cellRendererChanged
protected int
cellWidth
private static int
CHANGE_LEAD
Used by IncrementLeadSelectionAction.private static int
CHANGE_SELECTION
Used by IncrementLeadSelectionAction.private int
columnCount
Number of columns to create.private static int
componentOrientationChanged
private static javax.swing.TransferHandler
defaultTransferHandler
private static int
DROP_LINE_THICKNESS
private static int
EXTEND_SELECTION
Used by IncrementLeadSelectionAction.protected static int
fixedCellHeightChanged
protected static int
fixedCellWidthChanged
protected java.awt.event.FocusListener
focusListener
protected static int
fontChanged
private BasicXListUI.Handler
handler
private static int
heightChanged
private boolean
isFileList
Local cache of JList's client property "List.isFileList"private boolean
isLeftToRight
Local cache of JList's component orientation propertyprivate int
layoutOrientation
The layout orientation of the list.private static int
layoutOrientationChanged
protected JXList
list
protected javax.swing.event.ListDataListener
listDataListener
private int
listHeight
Height of the list.protected javax.swing.event.ListSelectionListener
listSelectionListener
private int
listWidth
Width of the list.protected static int
modelChanged
private javax.swing.ListModel
modelX
protected javax.swing.event.MouseInputListener
mouseInputListener
private int
preferredHeight
Preferred height to make the list, this is only used if the the list is layed out horizontally.protected java.beans.PropertyChangeListener
propertyChangeListener
protected static int
prototypeCellValueChanged
protected javax.swing.CellRendererPane
rendererPane
private int
rowsPerColumn
Number of rows per column.protected static int
selectionModelChanged
private ListSortUI
sortUI
private long
timeFactor
The time factor to treate the series of typed alphanumeric key as prefix for first letter navigation.protected int
updateLayoutStateNeeded
private static int
widthChanged
-
Constructor Summary
Constructors Constructor Description BasicXListUI()
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description private static int
adjustIndex(int index, javax.swing.JList list)
protected void
checkBaselinePrecondition(javax.swing.JComponent c, int width, int height)
Fix for Issue #1495: NPE on getBaseline.private int
convertLocationToColumn(int x, int y)
Returns the closest column to the passed in location.private int
convertLocationToModel(int x, int y)
Returns the closest location to the model index of the passed in location.private int
convertLocationToRow(int x, int y0, boolean closest)
Returns the row at location x/y.private int
convertLocationToRowInColumn(int y, int column)
Returns the closest row that starts at the specified y-location in the passed in column.private int
convertModelToColumn(int index)
Returns the column that the model indexindex
will be displayed in.private int
convertModelToRow(int index)
Returns the row that the model indexindex
will be displayed in..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 java.awt.event.FocusListener
createFocusListener()
protected javax.swing.event.ListDataListener
createListDataListener()
Creates an instance of ListDataListener that's added to the JLists by model as needed.protected javax.swing.event.ListSelectionListener
createListSelectionListener()
Creates an instance of ListSelectionHandler that's added to the JLists by selectionModel as needed.protected javax.swing.event.MouseInputListener
createMouseInputListener()
Creates a delegate that implements MouseInputListener.protected java.beans.PropertyChangeListener
createPropertyChangeListener()
Creates an instance of PropertyChangeHandler that's added to the JList by installUI().static javax.swing.plaf.ComponentUI
createUI(javax.swing.JComponent list)
Returns a new instance of BasicXListUI.int
getBaseline(javax.swing.JComponent c, int width, int height)
Returns the baseline.java.awt.Component.BaselineResizeBehavior
getBaselineResizeBehavior(javax.swing.JComponent c)
Returns an enum indicating how the baseline of the component changes as the size changes.private java.awt.Rectangle
getCellBounds(javax.swing.JList list, int index)
Gets the bounds of the specified model index, returning the resulting bounds, or null ifindex
is not valid.java.awt.Rectangle
getCellBounds(javax.swing.JList list, int index1, int index2)
private java.awt.Rectangle
getDropLineRect(javax.swing.JList.DropLocation loc)
protected java.lang.Object
getElementAt(int viewIndex)
protected int
getElementCount()
private BasicXListUI.Handler
getHandler()
private int
getHeight(int column, int row)
Returns the height of the cell at the passed in location.(package private) javax.swing.InputMap
getInputMap(int condition)
private int
getModelIndex(int column, int row)
Returns the model index for the specified display location.java.awt.Dimension
getPreferredSize(javax.swing.JComponent c)
The preferredSize of the list depends upon the layout orientation.private int
getRowCount(int column)
Returns the number of rows in the given column.protected int
getRowHeight(int row)
Returns the height of the specified row based on the current layout.protected ListSortUI
getSortUI()
protected javax.swing.ListModel
getViewModel()
Compatibility Wrapper: a synthetic model which delegates to list api and throwsjava.awt.Point
indexToLocation(javax.swing.JList list, int index)
protected void
installDefaults()
Initialize JList properties, e.g.protected void
installKeyboardActions()
Registers the keyboard bindings on theJList
that theBasicXListUI
is associated with.protected void
installListeners()
Create and install the listeners for the JList, its model, and its selectionModel.protected void
installSortUI()
Installs SortUI if the list has a rowSorter.void
installUI(javax.swing.JComponent c)
Initializesthis.list
by callinginstallDefaults()
,installListeners()
, andinstallKeyboardActions()
in order.void
invalidateCellSizeCache()
Invalidates the cell size cache and revalidates/-paints the list.static void
loadActionMap(LazyActionMap map)
int
locationToIndex(javax.swing.JList list, java.awt.Point location)
protected void
maybeUpdateLayoutState()
If updateLayoutStateNeeded is non zero, call updateLayoutState() and reset updateLayoutStateNeeded.void
paint(java.awt.Graphics g, javax.swing.JComponent c)
Paint the rows that intersect the Graphics objects clipRect.protected void
paintCell(java.awt.Graphics g, int row, java.awt.Rectangle rowBounds, javax.swing.ListCellRenderer cellRenderer, javax.swing.ListModel dataModel, javax.swing.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.private void
paintDropLine(java.awt.Graphics g)
private void
paintImpl(java.awt.Graphics g, javax.swing.JComponent c)
protected boolean
processedBySortUI(javax.swing.event.ListDataEvent e)
Returns a boolean indicating whether or not the event has been processed by the sortUI.protected boolean
processedBySortUI(javax.swing.event.ListSelectionEvent e)
Returns a boolean indicating whether or not the event has been processed by the sortUI.private void
redrawList()
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 frominstallKeyboardActions
.protected void
uninstallListeners()
Remove the listeners for the JList, its model, and its selectionModel.protected void
uninstallSortUI()
Dispose and null's the sortUI if installed.void
uninstallUI(javax.swing.JComponent c)
Uninitializesthis.list
by callinguninstallListeners()
,uninstallKeyboardActions()
, anduninstallDefaults()
in order.private void
updateHorizontalLayoutState(int fixedCellWidth, int fixedCellHeight)
Invoked when the list is layed out horizontally to determine how many columns to create.private void
updateIsFileList()
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.protected void
updateSortUI(java.lang.String property)
Called from the PropertyChangeHandler.private void
updateSortUIToRowSorterProperty()
-
-
-
Field Detail
-
BASELINE_COMPONENT_KEY
private static final java.lang.StringBuilder BASELINE_COMPONENT_KEY
-
list
protected JXList list
-
rendererPane
protected javax.swing.CellRendererPane rendererPane
-
focusListener
protected java.awt.event.FocusListener focusListener
-
mouseInputListener
protected javax.swing.event.MouseInputListener mouseInputListener
-
listSelectionListener
protected javax.swing.event.ListSelectionListener listSelectionListener
-
listDataListener
protected javax.swing.event.ListDataListener listDataListener
-
propertyChangeListener
protected java.beans.PropertyChangeListener propertyChangeListener
-
handler
private BasicXListUI.Handler handler
-
cellHeights
protected int[] cellHeights
-
cellHeight
protected int cellHeight
-
cellWidth
protected int cellWidth
-
updateLayoutStateNeeded
protected int updateLayoutStateNeeded
-
listHeight
private int listHeight
Height of the list. When asked to paint, if the current size of the list differs, this will update the layout state.
-
listWidth
private int listWidth
Width of the list. When asked to paint, if the current size of the list differs, this will update the layout state.
-
layoutOrientation
private int layoutOrientation
The layout orientation of the list.
-
columnCount
private int columnCount
Number of columns to create.
-
preferredHeight
private int preferredHeight
Preferred height to make the list, this is only used if the the list is layed out horizontally.
-
rowsPerColumn
private int rowsPerColumn
Number of rows per column. This is only used if the row height is fixed.
-
timeFactor
private long timeFactor
The time factor to treate the series of typed alphanumeric key as prefix for first letter navigation.
-
isFileList
private boolean isFileList
Local cache of JList's client property "List.isFileList"
-
isLeftToRight
private boolean isLeftToRight
Local cache of JList's component orientation property
-
modelChanged
protected static final int modelChanged
- See Also:
- Constant Field Values
-
selectionModelChanged
protected static final int selectionModelChanged
- See Also:
- Constant Field Values
-
fontChanged
protected static final int fontChanged
- See Also:
- Constant Field Values
-
fixedCellWidthChanged
protected static final int fixedCellWidthChanged
- See Also:
- Constant Field Values
-
fixedCellHeightChanged
protected static final int fixedCellHeightChanged
- See Also:
- Constant Field Values
-
prototypeCellValueChanged
protected static final int prototypeCellValueChanged
- See Also:
- Constant Field Values
-
cellRendererChanged
protected static final int cellRendererChanged
- See Also:
- Constant Field Values
-
layoutOrientationChanged
private static final int layoutOrientationChanged
- See Also:
- Constant Field Values
-
heightChanged
private static final int heightChanged
- See Also:
- Constant Field Values
-
widthChanged
private static final int widthChanged
- See Also:
- Constant Field Values
-
componentOrientationChanged
private static final int componentOrientationChanged
- See Also:
- Constant Field Values
-
DROP_LINE_THICKNESS
private static final int DROP_LINE_THICKNESS
- See Also:
- Constant Field Values
-
modelX
private javax.swing.ListModel modelX
-
sortUI
private ListSortUI sortUI
-
CHANGE_LEAD
private static final int CHANGE_LEAD
Used by IncrementLeadSelectionAction. Indicates the action should change the lead, and not select it.- See Also:
- Constant Field Values
-
CHANGE_SELECTION
private static final int CHANGE_SELECTION
Used by IncrementLeadSelectionAction. Indicates the action should change the selection and lead.- See Also:
- Constant Field Values
-
EXTEND_SELECTION
private static final int EXTEND_SELECTION
Used by IncrementLeadSelectionAction. Indicates the action should extend the selection from the anchor to the next index.- See Also:
- Constant Field Values
-
defaultTransferHandler
private static final javax.swing.TransferHandler defaultTransferHandler
-
-
Method Detail
-
loadActionMap
public static void loadActionMap(LazyActionMap map)
-
getViewModel
protected javax.swing.ListModel getViewModel()
Compatibility Wrapper: a synthetic model which delegates to list api and throws- Returns:
-
getElementCount
protected int getElementCount()
- Returns:
-
getElementAt
protected java.lang.Object getElementAt(int viewIndex)
-
checkBaselinePrecondition
protected void checkBaselinePrecondition(javax.swing.JComponent c, int width, int height)
Fix for Issue #1495: NPE on getBaseline. As per contract, that methods needs to throw Exceptions on illegal parameters. As we by-pass super, need to do the check and throw ouerselves.- Parameters:
c
-width
-height
-- Throws:
java.lang.IllegalArgumentException
- if width or height < 0NPE
- if c == null
-
getSortUI
protected ListSortUI getSortUI()
-
installSortUI
protected void installSortUI()
Installs SortUI if the list has a rowSorter. Does nothing if not.
-
uninstallSortUI
protected void uninstallSortUI()
Dispose and null's the sortUI if installed. Does nothing if not.
-
updateSortUI
protected void updateSortUI(java.lang.String property)
Called from the PropertyChangeHandler.- Parameters:
property
- the name of the changed property.
-
updateSortUIToRowSorterProperty
private void updateSortUIToRowSorterProperty()
-
processedBySortUI
protected boolean processedBySortUI(javax.swing.event.ListDataEvent e)
Returns a boolean indicating whether or not the event has been processed by the sortUI.- Parameters:
e
-- Returns:
-
processedBySortUI
protected boolean processedBySortUI(javax.swing.event.ListSelectionEvent e)
Returns a boolean indicating whether or not the event has been processed by the sortUI.- Parameters:
e
-- Returns:
-
invalidateCellSizeCache
public void invalidateCellSizeCache()
Invalidates the cell size cache and revalidates/-paints the list.
-
paintCell
protected void paintCell(java.awt.Graphics g, int row, java.awt.Rectangle rowBounds, javax.swing.ListCellRenderer cellRenderer, javax.swing.ListModel dataModel, javax.swing.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. Subclasses may want to override this method rather than paint().- Overrides:
paintCell
in classjavax.swing.plaf.basic.BasicListUI
- See Also:
paint(java.awt.Graphics, javax.swing.JComponent)
-
paint
public void paint(java.awt.Graphics g, javax.swing.JComponent c)
Paint the rows that intersect the Graphics objects clipRect. This method calls paintCell as necessary. Subclasses may want to override these methods.- Overrides:
paint
in classjavax.swing.plaf.basic.BasicListUI
- See Also:
paintCell(java.awt.Graphics, int, java.awt.Rectangle, javax.swing.ListCellRenderer, javax.swing.ListModel, javax.swing.ListSelectionModel, int)
-
paintImpl
private void paintImpl(java.awt.Graphics g, javax.swing.JComponent c)
-
paintDropLine
private void paintDropLine(java.awt.Graphics g)
-
getDropLineRect
private java.awt.Rectangle getDropLineRect(javax.swing.JList.DropLocation loc)
-
getBaseline
public int getBaseline(javax.swing.JComponent c, int width, int height)
Returns the baseline.- Overrides:
getBaseline
in classjavax.swing.plaf.basic.BasicListUI
- Throws:
java.lang.NullPointerException
java.lang.IllegalArgumentException
- Since:
- 1.6
- See Also:
JComponent.getBaseline(int, int)
-
getBaselineResizeBehavior
public java.awt.Component.BaselineResizeBehavior getBaselineResizeBehavior(javax.swing.JComponent c)
Returns an enum indicating how the baseline of the component changes as the size changes.- Overrides:
getBaselineResizeBehavior
in classjavax.swing.plaf.basic.BasicListUI
- Throws:
java.lang.NullPointerException
- Since:
- 1.6
- See Also:
JComponent.getBaseline(int, int)
-
getPreferredSize
public java.awt.Dimension getPreferredSize(javax.swing.JComponent c)
The preferredSize of the list depends upon the layout orientation.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
are determined fromlist.getInsets()
.- Overrides:
getPreferredSize
in classjavax.swing.plaf.basic.BasicListUI
- Parameters:
c
- The JList component.- Returns:
- The total size of the list.
-
selectPreviousIndex
protected void selectPreviousIndex()
Selected the previous row and force it to be visible.- Overrides:
selectPreviousIndex
in classjavax.swing.plaf.basic.BasicListUI
- See Also:
JList.ensureIndexIsVisible(int)
-
selectNextIndex
protected void selectNextIndex()
Selected the previous row and force it to be visible.- Overrides:
selectNextIndex
in classjavax.swing.plaf.basic.BasicListUI
- See Also:
JList.ensureIndexIsVisible(int)
-
installKeyboardActions
protected void installKeyboardActions()
Registers the keyboard bindings on theJList
that theBasicXListUI
is associated with. This method is called at installUI() time.- Overrides:
installKeyboardActions
in classjavax.swing.plaf.basic.BasicListUI
- See Also:
installUI(javax.swing.JComponent)
-
getInputMap
javax.swing.InputMap getInputMap(int condition)
-
uninstallKeyboardActions
protected void uninstallKeyboardActions()
Unregisters keyboard actions installed frominstallKeyboardActions
. This method is called at uninstallUI() time - subclassess should ensure that all of the keyboard actions registered at installUI time are removed here.- Overrides:
uninstallKeyboardActions
in classjavax.swing.plaf.basic.BasicListUI
- See Also:
installUI(javax.swing.JComponent)
-
installListeners
protected void installListeners()
Create and install the listeners for the JList, its model, and its selectionModel. This method is called at installUI() time.- Overrides:
installListeners
in classjavax.swing.plaf.basic.BasicListUI
- See Also:
installUI(javax.swing.JComponent)
,uninstallListeners()
-
uninstallListeners
protected void uninstallListeners()
Remove the listeners for the JList, its model, and its selectionModel. All of the listener fields, are reset to null here. This method is called at uninstallUI() time, it should be kept in sync with installListeners.- Overrides:
uninstallListeners
in classjavax.swing.plaf.basic.BasicListUI
- See Also:
uninstallUI(javax.swing.JComponent)
,installListeners()
-
installDefaults
protected void installDefaults()
Initialize JList properties, e.g. font, foreground, and background, and add the CellRendererPane. The font, foreground, and background properties are only set if their current value is either null or a UIResource, other properties are set if the current value is null.- Overrides:
installDefaults
in classjavax.swing.plaf.basic.BasicListUI
- See Also:
uninstallDefaults()
,installUI(javax.swing.JComponent)
,CellRendererPane
-
updateIsFileList
private void updateIsFileList()
-
uninstallDefaults
protected void uninstallDefaults()
Set the JList properties that haven't been explicitly overridden to null. A property is considered overridden if its current value is not a UIResource.- Overrides:
uninstallDefaults
in classjavax.swing.plaf.basic.BasicListUI
- See Also:
installDefaults()
,uninstallUI(javax.swing.JComponent)
,CellRendererPane
-
installUI
public void installUI(javax.swing.JComponent c)
Initializesthis.list
by callinginstallDefaults()
,installListeners()
, andinstallKeyboardActions()
in order.- Overrides:
installUI
in classjavax.swing.plaf.basic.BasicListUI
- See Also:
installDefaults()
,installListeners()
,installKeyboardActions()
-
uninstallUI
public void uninstallUI(javax.swing.JComponent c)
Uninitializesthis.list
by callinguninstallListeners()
,uninstallKeyboardActions()
, anduninstallDefaults()
in order. Sets this.list to null.- Overrides:
uninstallUI
in classjavax.swing.plaf.basic.BasicListUI
- See Also:
uninstallListeners()
,uninstallKeyboardActions()
,uninstallDefaults()
-
createUI
public static javax.swing.plaf.ComponentUI createUI(javax.swing.JComponent list)
Returns a new instance of BasicXListUI. BasicXListUI delegates are allocated one per JList.- Returns:
- A new ListUI implementation for the Windows look and feel.
-
locationToIndex
public int locationToIndex(javax.swing.JList list, java.awt.Point location)
- Overrides:
locationToIndex
in classjavax.swing.plaf.basic.BasicListUI
- Throws:
java.lang.NullPointerException
-
indexToLocation
public java.awt.Point indexToLocation(javax.swing.JList list, int index)
- Overrides:
indexToLocation
in classjavax.swing.plaf.basic.BasicListUI
-
getCellBounds
public java.awt.Rectangle getCellBounds(javax.swing.JList list, int index1, int index2)
- Overrides:
getCellBounds
in classjavax.swing.plaf.basic.BasicListUI
-
getCellBounds
private java.awt.Rectangle getCellBounds(javax.swing.JList list, int index)
Gets the bounds of the specified model index, returning the resulting bounds, or null ifindex
is not valid.
-
getRowHeight
protected int getRowHeight(int row)
Returns the height of the specified row based on the current layout.- Overrides:
getRowHeight
in classjavax.swing.plaf.basic.BasicListUI
- Returns:
- The specified row height or -1 if row isn't valid.
- See Also:
convertYToRow(int)
,convertRowToY(int)
,updateLayoutState()
-
convertYToRow
protected int convertYToRow(int y0)
Convert the JList relative coordinate to the row that contains it, based on the current layout. If y0 doesn't fall within any row, return -1.- Overrides:
convertYToRow
in classjavax.swing.plaf.basic.BasicListUI
- Returns:
- The row that contains y0, or -1.
- See Also:
getRowHeight(int)
,updateLayoutState()
-
convertRowToY
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.- Overrides:
convertRowToY
in classjavax.swing.plaf.basic.BasicListUI
- Returns:
- The Y coordinate of the origin of row, or -1.
- See Also:
getRowHeight(int)
,updateLayoutState()
-
getHeight
private int getHeight(int column, int row)
Returns the height of the cell at the passed in location.
-
convertLocationToRow
private int convertLocationToRow(int x, int y0, boolean closest)
Returns the row at location x/y.- Parameters:
closest
- If true and the location doesn't exactly match a particular location, this will return the closest row.
-
convertLocationToRowInColumn
private int convertLocationToRowInColumn(int y, int column)
Returns the closest row that starts at the specified y-location in the passed in column.
-
convertLocationToModel
private int convertLocationToModel(int x, int y)
Returns the closest location to the model index of the passed in location.
-
getRowCount
private int getRowCount(int column)
Returns the number of rows in the given column.
-
getModelIndex
private int getModelIndex(int column, int row)
Returns the model index for the specified display location. Ifcolumn
xrow
is beyond the length of the model, this will return the model size - 1.
-
convertLocationToColumn
private int convertLocationToColumn(int x, int y)
Returns the closest column to the passed in location.
-
convertModelToRow
private int convertModelToRow(int index)
Returns the row that the model indexindex
will be displayed in..
-
convertModelToColumn
private int convertModelToColumn(int index)
Returns the column that the model indexindex
will be displayed in.
-
maybeUpdateLayoutState
protected void maybeUpdateLayoutState()
If updateLayoutStateNeeded is non zero, call updateLayoutState() and reset updateLayoutStateNeeded. This method should be called by methods before doing any computation based on the geometry of the list. For example it's the first call in paint() and getPreferredSize().- Overrides:
maybeUpdateLayoutState
in classjavax.swing.plaf.basic.BasicListUI
- See Also:
updateLayoutState()
-
updateLayoutState
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.- Overrides:
updateLayoutState
in classjavax.swing.plaf.basic.BasicListUI
- See Also:
maybeUpdateLayoutState()
-
updateHorizontalLayoutState
private void updateHorizontalLayoutState(int fixedCellWidth, int fixedCellHeight)
Invoked when the list is layed out horizontally to determine how many columns to create.This updates the
rowsPerColumn,
columnCount
,preferredHeight
and potentiallycellHeight
instance variables.
-
getHandler
private BasicXListUI.Handler getHandler()
-
createMouseInputListener
protected javax.swing.event.MouseInputListener createMouseInputListener()
Creates a delegate that implements MouseInputListener. The delegate is added to the corresponding java.awt.Component listener lists at installUI() time. Subclasses can override this method to return a custom MouseInputListener, e.g.class MyListUI extends BasicXListUI { 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); } } }
- Overrides:
createMouseInputListener
in classjavax.swing.plaf.basic.BasicListUI
- See Also:
BasicXListUI.MouseInputHandler
,installUI(javax.swing.JComponent)
-
createFocusListener
protected java.awt.event.FocusListener createFocusListener()
- Overrides:
createFocusListener
in classjavax.swing.plaf.basic.BasicListUI
-
createListSelectionListener
protected javax.swing.event.ListSelectionListener createListSelectionListener()
Creates an instance of ListSelectionHandler that's added to the JLists by selectionModel as needed. Subclasses can override this method to return a custom ListSelectionListener, e.g.class MyListUI extends BasicXListUI { 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); } } }
- Overrides:
createListSelectionListener
in classjavax.swing.plaf.basic.BasicListUI
- See Also:
BasicXListUI.ListSelectionHandler
,installUI(javax.swing.JComponent)
-
redrawList
private void redrawList()
-
createListDataListener
protected javax.swing.event.ListDataListener createListDataListener()
Creates an instance of ListDataListener that's added to the JLists by model as needed. Subclasses can override this method to return a custom ListDataListener, e.g.class MyListUI extends BasicXListUI { 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); } } }
- Overrides:
createListDataListener
in classjavax.swing.plaf.basic.BasicListUI
- See Also:
ListDataListener
,JList.getModel()
,installUI(javax.swing.JComponent)
-
createPropertyChangeListener
protected java.beans.PropertyChangeListener createPropertyChangeListener()
Creates an instance of PropertyChangeHandler that's added to the JList by installUI(). Subclasses can override this method to return a custom PropertyChangeListener, e.g.class MyListUI extends BasicXListUI { 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); } } }
- Overrides:
createPropertyChangeListener
in classjavax.swing.plaf.basic.BasicListUI
- See Also:
PropertyChangeListener
,installUI(javax.swing.JComponent)
-
adjustIndex
private static int adjustIndex(int index, javax.swing.JList list)
-
-