Класс 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

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

Свойства
Тип	Свойство	Описание
`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 по умолчанию, пустой, без заданных элементов и с нулевым значением по умолчанию.
`ChoiceDialog(T defaultChoice, Collection<T> choices)`	Создаёт новый экземпляр ChoiceDialog. Первый аргумент задаёт значение по умолчанию, которое должно быть показано пользователю, а второй — коллекцию всех доступных вариантов для пользователя.
`ChoiceDialog(T defaultChoice, T... choices)`	Создаёт новый экземпляр ChoiceDialog. Первый аргумент задаёт значение по умолчанию, которое должно быть показано пользователю, а все последующие аргументы — массив переменной длины всех доступных вариантов для пользователя.

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

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

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

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

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

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

Методы, объявленные в интерфейсе javafx.event.EventTarget

buildEventDispatchChain

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

selectedItem

public final ReadOnlyObjectProperty<T> selectedItemProperty

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

См. также:: getSelectedItem(), setSelectedItem(T)

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

ChoiceDialog

public ChoiceDialog()

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

ChoiceDialog

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

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

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

ChoiceDialog

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

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

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