Module javafx.controls

软件包 javafx.scene.control

Class ChoiceDialog<T>

java.lang.Object

javafx.scene.control.Dialog<T>

javafx.scene.control.ChoiceDialog<T>

参数类型

T - 要向用户显示的项目的类型， 以及当对话框被关闭时通过 Dialog.getResult()返回的类型。

All Implemented Interfaces:

EventTarget

public class ChoiceDialog<T>
extends Dialog<T>

一个对话框，向用户显示选择列表，最多可以从中选择一个项目。

从以下版本开始：

JavaFX 8u40

另请参见：

Dialog

Property Summary

Properties

Type	Property	描述
ReadOnlyObjectProperty<T>	selectedItem	返回表示对话框中当前选定项目的属性。

Properties inherited from class javafx.scene.control.Dialog

contentText, dialogPane, graphic, headerText, height, onCloseRequest, onHidden, onHiding, onShowing, onShown, resizable, resultConverter, result, showing, title, width, x, y

构造方法摘要

构造方法

Constructor	描述
ChoiceDialog()	创建一个DefaultDialog的默认空的实例，没有设置项和空默认选项。
ChoiceDialog(T defaultChoice, Collection<T> choices)	创建一个新的ChoiceDialog实例，第一个参数指定应向用户显示的默认选择，第二个参数指定用户的所有可用选项的集合。
ChoiceDialog(T defaultChoice, T... choices)	创建一个新的ChoiceDialog实例，第一个参数指定应向用户显示的默认选项，并且所有以下参数都被视为用户所有可用选项的varargs数组。

方法摘要

Modifier and Type	方法	描述
T	getDefaultChoice()	返回在构造函数中指定的默认选项。
ObservableList<T>	getItems()	返回将显示给用户的所有项目的列表。
T	getSelectedItem()	返回对话框中当前选定的项目。
ReadOnlyObjectProperty<T>	selectedItemProperty()	返回表示对话框中当前选定项目的属性。
void	setSelectedItem(T item)	设置对话框中当前选定的项目。

Methods inherited from class javafx.scene.control.Dialog

buildEventDispatchChain, close, contentTextProperty, dialogPaneProperty, getContentText, getDialogPane, getGraphic, getHeaderText, getHeight, getModality, getOnCloseRequest, getOnHidden, getOnHiding, getOnShowing, getOnShown, getOwner, getResult, getResultConverter, getTitle, getWidth, getX, getY, graphicProperty, headerTextProperty, heightProperty, hide, initModality, initOwner, initStyle, isResizable, isShowing, onCloseRequestProperty, onHiddenProperty, onHidingProperty, onShowingProperty, onShownProperty, resizableProperty, resultConverterProperty, resultProperty, setContentText, setDialogPane, setGraphic, setHeaderText, setHeight, setOnCloseRequest, setOnHidden, setOnHiding, setOnShowing, setOnShown, setResizable, setResult, setResultConverter, setTitle, setWidth, setX, setY, show, showAndWait, showingProperty, titleProperty, widthProperty, xProperty, yProperty

Methods inherited from class java.lang.Object

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

Property Detail

selectedItem

public final ReadOnlyObjectProperty<T> selectedItemProperty

返回表示对话框中当前选定项目的属性。

另请参见：

getSelectedItem() ， setSelectedItem(T)

构造方法详细信息

ChoiceDialog

public ChoiceDialog()

创建一个DefaultDialog的默认空的实例，没有设置项和空默认选项。 此构造函数的用户随后需要调用getItems()来指定向用户显示哪些项目。

ChoiceDialog

public ChoiceDialog(T defaultChoice,
                    T... choices)

创建一个新的ChoiceDialog实例，第一个参数指定应向用户显示的默认选项，并且所有以下参数都被视为用户所有可用选项的varargs数组。 预期defaultChoice是选项varargs数组中的一个元素。 如果这不是真的，那么defaultChoice将被设置为null，对话框将显示初始选择设置为选项列表中的第一个项目。

参数

defaultChoice - 在对话框中作为预先选择的选项显示的项目。 该项目必须包含在选项varargs数组中。

choices - 向用户呈现的所有可能选择。

ChoiceDialog

public ChoiceDialog(T defaultChoice,
                    Collection<T> choices)

创建一个新的ChoiceDialog实例，第一个参数指定应向用户显示的默认选择，第二个参数指定用户的所有可用选项的集合。 预期defaultChoice是选择集合中的元素之一。 如果这不是真的，那么defaultChoice将被设置为null，对话框将显示初始选择设置为选项列表中的第一个项目。

参数

defaultChoice - 在对话框中作为预先选择的选项显示的项目。 该项目必须包含在选项varargs数组中。

choices - 向用户呈现的所有可能选择。

方法详细信息

getSelectedItem

public final T getSelectedItem()

返回对话框中当前选定的项目。

结果

当前选择的项目

selectedItemProperty

public final ReadOnlyObjectProperty<T> selectedItemProperty()

返回表示对话框中当前选定项目的属性。

另请参见：

getSelectedItem() ， setSelectedItem(T)

setSelectedItem

public final void setSelectedItem(T item)

设置对话框中当前选定的项目。

参数

item - 在对话框中选择的项目。

getItems

public final ObservableList<T> getItems()

返回将显示给用户的所有项目的列表。 开发人员可以修改此列表，以添加，删除或重新排序要呈现给用户的项目。

结果

将显示给用户的所有项目的列表

getDefaultChoice

public final T getDefaultChoice()

返回在构造函数中指定的默认选项。

结果

默认选择