Module javafx.controls

软件包 javafx.scene.control

Class SingleSelectionModel<T>

java.lang.Object

javafx.scene.control.SelectionModel<T>

javafx.scene.control.SingleSelectionModel<T>

参数类型

T - 可以选择的控件中包含的项目的类型。

public abstract class SingleSelectionModel<T>
extends SelectionModel<T>

一个SelectionModel，它强制要求在任何给定的时间只选择一个索引。 该类存在用于允许可插拔选择模型但不允许多个选择的控件。 一个很好的例子是ChoiceBox控件。 相反，大多数其他控件（ ListView ， TreeView ， TableView等）需要MultipleSelectionModel个实现（虽然MultipleSelectionModel确实还允许单个选择经由设置selectionMode属性）。

从以下版本开始：

JavaFX 2.0

另请参见：

SelectionModel ， MultipleSelectionModel ， SelectionMode

Property Summary

Properties inherited from class javafx.scene.control.SelectionModel

selectedIndex, selectedItem

构造方法摘要

构造方法

Constructor	描述
SingleSelectionModel()	创建一个默认的SingleSelectionModel实例。

方法摘要

Modifier and Type	方法	描述
void	clearAndSelect(int index)	在SingleSelectionModel中，此方法在功能上等同于调用 select(index) ，因为一次只允许一个选择。
void	clearSelection()	清除所有选定索引的选择模型。
void	clearSelection(int index)	清除给定索引的选择，如果它当前被选中。
protected abstract int	getItemCount()	获取可用于选择模型的项目数。
protected abstract T	getModelItem(int index)	获取与特定索引关联的数据模型项。
boolean	isEmpty()	该方法可用于测试是否有任何选定的索引/项目。
boolean	isSelected(int index)	如果给定的索引是此SingleSelectionModel中当前选定的索引，则此方法将返回true。
void	select(int index)	选择给定的索引。
void	select(T obj)	选择基础数据模型中给定对象的第一个实例的索引。
void	selectFirst()	选择第一个索引。
void	selectLast()	选择最后一个索引。
void	selectNext()	选择下一个索引。
void	selectPrevious()	选择上一个索引。

Methods inherited from class java.lang.Object

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

Methods inherited from class javafx.scene.control.SelectionModel

getSelectedIndex, getSelectedItem, selectedIndexProperty, selectedItemProperty, setSelectedIndex, setSelectedItem

构造方法详细信息

SingleSelectionModel

public SingleSelectionModel()

创建一个默认的SingleSelectionModel实例。

方法详细信息

clearSelection

public void clearSelection()

清除所有选定索引的选择模型。

Specified by:

clearSelection在 SelectionModel<T>

clearSelection

public void clearSelection(int index)

清除给定索引的选择，如果它当前被选中。

Specified by:

clearSelection在 SelectionModel<T>

参数

index - 要取消选择的选定项目。

isEmpty

public boolean isEmpty()

该方法可用于测试是否有任何选定的索引/项目。 如果没有选定的项目，它将返回true，如果有，则返回false。

Specified by:

isEmpty在 SelectionModel<T>

结果

如果 没有选择的项目将返回true，如果有的话将返回false。

isSelected

public boolean isSelected(int index)

如果给定的索引是此SingleSelectionModel中当前选定的索引，则此方法将返回true。

Specified by:

isSelected在 SelectionModel<T>

参数

index - 检查当前是否选择的索引。

结果

如果给定的索引被选择，则为真，否则为false。

clearAndSelect

public void clearAndSelect(int index)

在SingleSelectionModel中，此方法在功能上等同于调用 select(index) ，因为一次只允许一个选择。

Specified by:

clearAndSelect在 SelectionModel<T>

参数

index - 应该是此选择模型中唯一选择的索引的索引。

select

public void select(T obj)

选择基础数据模型中给定对象的第一个实例的索引。 由于SingleSelectionModel只能支持一次选择一个索引，所以这也导致任何先前选择的索引被取消选择。

Specified by:

select中的 SelectionModel<T>

参数

obj - 要在底层数据模型中选择的对象。

select

public void select(int index)

选择给定的索引。 由于SingleSelectionModel只能支持一次选择一个索引，所以这也导致任何先前选择的索引被取消选择。

Specified by:

select类 SelectionModel<T>

参数

index - 选择模型中要选择的项目的位置。

selectPrevious

public void selectPrevious()

选择上一个索引。 由于SingleSelectionModel只能支持一次选择一个索引，所以这也导致任何先前选择的索引被取消选择。

Specified by:

selectPrevious在 SelectionModel<T>

selectNext

public void selectNext()

选择下一个索引。 由于SingleSelectionModel只能支持一次选择一个索引，所以这也导致任何先前选择的索引被取消选择。

Specified by:

selectNext在 SelectionModel<T>

selectFirst

public void selectFirst()

选择第一个索引。 由于SingleSelectionModel只能支持一次选择一个索引，所以这也导致任何先前选择的索引被取消选择。

Specified by:

selectFirst在 SelectionModel<T>

selectLast

public void selectLast()

选择最后一个索引。 由于SingleSelectionModel只能支持一次选择一个索引，所以这也导致任何先前选择的索引被取消选择。

Specified by:

selectLast中的 SelectionModel<T>

getModelItem

protected abstract T getModelItem(int index)

获取与特定索引关联的数据模型项。

参数

index - 项目在基础数据模型中的位置。

结果

存在于给定索引处的项目。

getItemCount

protected abstract int getItemCount()

获取可用于选择模型的项目数。 如果项目数量可以动态更改，则具体的SingleSelectionModel实现将有责任确保在项目更改时选择或取消选择项目。

结果

数字大于或等于0。