jidefx.scene.control.searchable

Class TableViewSearchable<T>

java.lang.Object

jidefx.scene.control.searchable.Searchable<java.lang.Object>

jidefx.scene.control.searchable.TableViewSearchable<T>

public class TableViewSearchable<T>
extends Searchable<java.lang.Object>

TableSearchable is an concrete implementation of Searchable that enables the search function in TableView.

It's very simple to use it. Assuming you have a TableView, all you need to do is to call

 TableView table = ....;
 TableSearchable searchable = new TableSearchable(table);
 

Now the TableView will have the search function.

As TableView is a two dimension data, the search is a little different from ListView and TreeView which both have one dimension data. So there is a little work you need to do in order to convert from two dimension data to one dimension data. We use the selection mode to determine how to convert. There is a special property called mainIndex. You can set it using setMainIndex(). If the TableView is in row selection mode, mainIndex will be the column that you want search at. Please note you can change mainIndex at any time.

On the other hand, if the TableView is in column selection mode, mainIndex will be the row that you want search at. There is one more case when cell selection is enabled. In this case, mainIndex will be ignore; all cells will be searched.

In three cases above, the keys for find next and find previous are different too. In row selection mode, up/down arrow are the keys. In column selection mode, left/right arrow are keys. In cell selection mode, both up and left arrow are keys to find previous occurrence, both down and right arrow are keys to find next occurrence.

In addition, you might need to override convertElementToString() to provide you own algorithm to do the conversion.

 TableView table = ....;
 TableViewSearchable searchable = new TableViewSearchable(table) {
      protected String convertElementToString(Object object) {
          ...
      }
 };
 

Additional customization can be done on the base Searchable class such as background and foreground color, keystrokes, case sensitivity,

Property Summary

Properties inherited from class jidefx.scene.control.searchable.Searchable

caeSensitiveProperty, fromStartProperty, matchingElementProperty, matchingIndexProperty, popupPositionProperty, popupPositionRelativeToProperty, repeatsProperty, searchingDelayProperty, searchingLabelProperty, searchingProperty, searchingTextProperty, typedTextProperty, wildcardEnabledProperty

Nested Class Summary

Nested classes/interfaces inherited from class jidefx.scene.control.searchable.Searchable

Searchable.SearchPopup

Field Summary

Fields inherited from class jidefx.scene.control.searchable.Searchable

_boundsListener, _keyListener, _node, _visibleListener, PROPERTY_SEARCHABLE

Constructor Summary

Constructors

Constructor and Description
TableViewSearchable(javafx.scene.control.TableView<T> tableView)

Method Summary

Modifier and Type	Method and Description
protected void	addTableSelection(javafx.scene.control.TableView<T> table, int rowIndex, int columnIndex, boolean incremental) Selects the cell at the specified row and column index.
protected java.lang.String	convertElementToString(java.lang.Object item) Converts the element that returns from getElementAt() to string.
protected java.lang.Object	getElementAt(int index) Gets the element at the specified index.
protected int	getElementCount() Gets the total element count in the control.
int	getMainIndex() Gets the index of the column to be searched.
int[]	getSearchColumnIndices() Gets the indexes of the column to be searched.
protected int	getSelectedIndex() Gets the selected index.
protected java.lang.Object	getValueAt(javafx.scene.control.TableView table, int rowIndex, int columnIndex) Get string value of the table.
void	installListeners() Installs necessary listeners to the control.
protected boolean	isActivateKey(javafx.scene.input.KeyEvent e) Checks if the key in KeyEvent should activate the search popup.
protected boolean	isFindNextKey(javafx.scene.input.KeyEvent e) Checks if the key is used as a key to find the next occurrence.
protected boolean	isFindPreviousKey(javafx.scene.input.KeyEvent e) Checks if the key is used as a key to find the previous occurrence.
protected boolean	isRowSelectionAllowed(javafx.scene.control.TableView<T> table) Is the row selection allowed?
protected boolean	isSearchSelectedRows() Are we trying to search on multi-columns (but NOT all columns)?
protected boolean	isSelectedCellEditable() Checks if the selected cell is editable.
void	setMainIndex(int mainIndex) Sets the main index.
void	setSearchColumnIndices(int[] columnIndices) Sets the main indexes.
protected void	setSelectedIndex(int index, boolean incremental) Sets the selected index.
void	uninstallListeners() Uninstall the listeners that installed before.

Methods inherited from class jidefx.scene.control.searchable.Searchable

adjustSelectedIndex, caeSensitiveProperty, compare, compareAsString, createSearchPopup, findAll, findFirst, findFromCursor, findLast, findNext, findPrevious, fromStartProperty, getCurrentIndex, getCursor, getElementAtAsString, getHidePopupDelay, getMatchingElement, getMatchingIndex, getNode, getPopupPosition, getPopupPositionRelativeTo, getResourceString, getSearchable, getSearchingDelay, getSearchingText, getSearchLabel, getWildcardSupport, hidePopup, highlightAll, isCaseSensitive, isDeactivateKey, isFindFirstKey, isFindLastKey, isFromStart, isIncrementalSelectKey, isNavigationKey, isPopupVisible, isRepeats, isReverseOrder, isSearching, isSelectAllKey, isWildcardEnabled, keyTypedOrPressed, matchingElementProperty, matchingIndexProperty, popupPositionProperty, popupPositionRelativeToProperty, repeatsProperty, reverseFindFromCursor, searchingDelayProperty, searchingLabelProperty, searchingProperty, searchingTextProperty, select, setCaseSensitive, setCursor, setCursor, setFromStart, setHidePopupDelay, setMatchingElement, setMatchingIndex, setPopupPosition, setPopupPositionRelativeTo, setRepeats, setReverseOrder, setSearching, setSearchingDelay, setSearchingText, setSearchLabel, setWildcardEnabled, setWildcardSupport, showPopup, typedTextProperty, wildcardEnabledProperty

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

TableViewSearchable

public TableViewSearchable(javafx.scene.control.TableView<T> tableView)

Method Detail

installListeners

public void installListeners()

Description copied from class: Searchable

Installs necessary listeners to the control. This method will be called automatically when Searchable is created.

Overrides:

installListeners in class Searchable<java.lang.Object>

uninstallListeners

public void uninstallListeners()

Description copied from class: Searchable

Uninstall the listeners that installed before. You can call this method if you decide to make the existing searchable control not searchable.

Overrides:

uninstallListeners in class Searchable<java.lang.Object>

setSelectedIndex

protected void setSelectedIndex(int index,
                                boolean incremental)

Description copied from class: Searchable

Sets the selected index. The concrete implementation should call methods on the control to select the element at the specified index. The incremental flag is used to do multiple select. If the flag is true, the element at the index should be added to current selection. If false, you should clear previous selection and then select the element.

Specified by:

setSelectedIndex in class Searchable<java.lang.Object>

Parameters:

index - the index to be selected

incremental - a flag to enable multiple selection. If the flag is true, the element at the index should be added to current selection. If false, you should clear previous selection and then select the element.

addTableSelection

protected void addTableSelection(javafx.scene.control.TableView<T> table,
                                 int rowIndex,
                                 int columnIndex,
                                 boolean incremental)

Selects the cell at the specified row and column index. If incremental is true, the previous selection will not be cleared.

Parameters:

table - the table

rowIndex - the row index of the cell.

columnIndex - the column index of the cell

incremental - false to clear all previous selection. True to keep the previous selection.

isRowSelectionAllowed

protected boolean isRowSelectionAllowed(javafx.scene.control.TableView<T> table)

Is the row selection allowed?

Parameters:

table - the table.

Returns:

true if the table is the row selection.

isSearchSelectedRows

protected boolean isSearchSelectedRows()

Are we trying to search on multi-columns (but NOT all columns)?

Returns:

true if the search is set to look at multi-columns (but NOT all columns).

getSelectedIndex

protected int getSelectedIndex()

Gets the selected index.

Specified by:

getSelectedIndex in class Searchable<java.lang.Object>

Returns:

the selected index.

getElementAt

protected java.lang.Object getElementAt(int index)

Description copied from class: Searchable

Gets the element at the specified index. The element could be any data structure that internally used in the control. The convertElementToString method will give you a chance to convert the element to string which is used to compare with the string that user types in.

Specified by:

getElementAt in class Searchable<java.lang.Object>

Parameters:

index - the index

Returns:

the element at the specified index.

getValueAt

protected java.lang.Object getValueAt(javafx.scene.control.TableView table,
                                      int rowIndex,
                                      int columnIndex)

Get string value of the table.

Parameters:

table - the TableView

rowIndex - the row index

columnIndex - the column index

Returns:

the string value of the cell in the table.

getElementCount

protected int getElementCount()

Description copied from class: Searchable

Gets the total element count in the control. Different concrete implementation could have different interpretation of the count. This is totally OK as long as it's consistent in all the methods. For example, the index parameter in other methods should be always a valid value within the total count.

Specified by:

getElementCount in class Searchable<java.lang.Object>

Returns:

the total element count.

convertElementToString

protected java.lang.String convertElementToString(java.lang.Object item)

Description copied from class: Searchable

Converts the element that returns from getElementAt() to string.

Specified by:

convertElementToString in class Searchable<java.lang.Object>

Parameters:

item - the element to be converted

Returns:

the string representing the element in the control.

getSearchColumnIndices

public int[] getSearchColumnIndices()

Gets the indexes of the column to be searched.

Returns:

the indexes of the column to be searched.

getMainIndex

public int getMainIndex()

Gets the index of the column to be searched.

Returns:

the index of the column to be searched.

setSearchColumnIndices

public void setSearchColumnIndices(int[] columnIndices)

Sets the main indexes. Main indexes are the columns index which you want to be searched.

Parameters:

columnIndices - the index of the columns to be searched. If empty, all columns will be searched.

setMainIndex

public void setMainIndex(int mainIndex)

Sets the main index. Main index is the column index which you want to be searched.

Parameters:

mainIndex - the index of the column to be searched. If -1, all columns will be searched.

isFindNextKey

protected boolean isFindNextKey(javafx.scene.input.KeyEvent e)

Description copied from class: Searchable

Checks if the key is used as a key to find the next occurrence.

Overrides:

isFindNextKey in class Searchable<java.lang.Object>

Parameters:

e - the key event

Returns:

true if the key in KeyEvent is a key to find the next occurrence. By default, down arrow key is used.

isFindPreviousKey

protected boolean isFindPreviousKey(javafx.scene.input.KeyEvent e)

Description copied from class: Searchable

Checks if the key is used as a key to find the previous occurrence.

Overrides:

isFindPreviousKey in class Searchable<java.lang.Object>

Parameters:

e - the key event

Returns:

true if the key in KeyEvent is a key to find the previous occurrence. By default, up arrow key is used.

isActivateKey

protected boolean isActivateKey(javafx.scene.input.KeyEvent e)

Description copied from class: Searchable

Checks if the key in KeyEvent should activate the search popup.

Overrides:

isActivateKey in class Searchable<java.lang.Object>

Parameters:

e - the key event

Returns:

true if the KeyEvent is a KEY_PRESSED event and the key code is isLetterKey or isDigitKey.

isSelectedCellEditable

protected boolean isSelectedCellEditable()

Checks if the selected cell is editable. If yes, we will not activate Searchable when key is typed.

Returns:

true if the selected cell is editable.