Класс ChoiceDialog<T>

java.lang.Object

javafx.scene.control.Dialog<T>

javafx.scene.control.ChoiceDialog<T>

Параметры типа:: T - Тип элементов, которые будут отображаться пользователю, и тип, который возвращается через Dialog.getResult() при закрытии диалогового окна.

Все реализуемые интерфейсы:: EventTarget

public class ChoiceDialog<T> extends Dialog<T>

Диалоговое окно, отображающее пользователю список вариантов, из которого он может выбрать не более одного элемента.

Пример:

 List<String> colors = List.of("Red", "Yellow", "Green");
 ChoiceDialog choiceDialog = new ChoiceDialog<>("Yellow", colors);
 choiceDialog.showAndWait();

С тех пор:

JavaFX 8u40

См. также:

Dialog

Краткое описание свойств

Тип	Свойство	Описание
`final ReadOnlyObjectProperty<T>`	`selectedItem`	Возвращает свойство, представляющее текущий выбранный элемент в диалоговом окне.

Свойства, объявленные в классе javafx.scene.control.Dialog

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

Краткое описание конструкторов

Конструктор	Описание
`ChoiceDialog()`	Создаёт пустой экземпляр ChoiceDialog по умолчанию без заданных элементов и значением по умолчанию null.
`ChoiceDialog(T defaultChoice, Collection<T> choices)`	Создаёт новый экземпляр ChoiceDialog с первым аргументом, определяющим значение по умолчанию, которое должно быть отображено пользователю, и вторым аргументом, определяющим коллекцию всех доступных вариантов для пользователя.
`ChoiceDialog(T defaultChoice, T... choices)`	Создаёт новый экземпляр ChoiceDialog с первым аргументом, определяющим значение по умолчанию, которое должно быть отображено пользователю, и последующими аргументами, рассматриваемыми как массив varargs всех доступных вариантов для пользователя.

Краткое описание методов

Модификатор и тип	Метод	Описание
`final T`	`getDefaultChoice()`	Возвращает значение по умолчанию, которое было указано в конструкторе.
`final ObservableList<T>`	`getItems()`	Возвращает список всех элементов, которые будут отображены пользователю.
`final T`	`getSelectedItem()`	Возвращает текущий выбранный элемент в диалоговом окне.
`final ReadOnlyObjectProperty<T>`	`selectedItemProperty()`	Возвращает свойство, представляющее текущий выбранный элемент в диалоговом окне.
`final void`	`setSelectedItem(T item)`	Устанавливает текущий выбранный элемент в диалоговом окне.

Методы, объявленные в классе javafx.scene.control.Dialog

addEventFilter, addEventHandler, 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, removeEventFilter, removeEventHandler, 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

Методы, объявленные в классе java.lang.Object

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

Подробное описание свойств

selectedItem

public final ReadOnlyObjectProperty<T> selectedItemProperty

Возвращает свойство, представляющее текущий выбранный элемент в диалоговом окне.

См. также:

getSelectedItem()
setSelectedItem(T)
selectedItemProperty()

Подробное описание конструкторов

ChoiceDialog

public ChoiceDialog()

Создаёт пустой экземпляр ChoiceDialog по умолчанию без заданных элементов и значением по умолчанию null. Пользователям этого конструктора потребуется впоследствии вызвать getItems() для указания элементов, которые нужно отобразить пользователю.

ChoiceDialog

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

Создаёт новый экземпляр ChoiceDialog с первым аргументом, определяющим значение по умолчанию, которое должно быть отображено пользователю, и последующими аргументами, рассматриваемыми как массив varargs всех доступных вариантов для пользователя. Ожидается, что defaultChoice будет одним из элементов в массиве varargs choices. Если это не так, то defaultChoice будет установлен в null, и диалоговое окно будет отображено с начальным выбором, установленным на первый элемент в списке вариантов.

Параметры:: defaultChoice - Элемент, отображаемый как предварительно выбранный выбор в диалоговом окне. Этот элемент должен содержаться в массиве varargs choices.; choices - Все возможные варианты, которые нужно представить пользователю.

ChoiceDialog

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

Создаёт новый экземпляр ChoiceDialog с первым аргументом, определяющим значение по умолчанию, которое должно быть отображено пользователю, и вторым аргументом, определяющим коллекцию всех доступных вариантов для пользователя. Ожидается, что defaultChoice будет одним из элементов в коллекции choices. Если это не так, то defaultChoice будет установлен в null, и диалоговое окно будет отображено с начальным выбором, установленным на первый элемент в списке вариантов.

Параметры:: defaultChoice - Элемент, отображаемый как предварительно выбранный выбор в диалоговом окне. Этот элемент должен содержаться в массиве varargs choices.; 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()

Возвращает значение по умолчанию, которое было указано в конструкторе.

Возвращает:: значение по умолчанию

© 2008, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from JavaFX API Documentation.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Java, JavaFX and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.