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

См. также:

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

Тип	Свойство	Описание
`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, где первый аргумент задаёт значение по умолчанию, а все последующие аргументы — массив переменной длины всех доступных вариантов для пользователя.

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

Модификатор и тип	Метод	Описание
`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

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

См. также:

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

ChoiceDialog

public ChoiceDialog()

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

ChoiceDialog

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

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

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

ChoiceDialog

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

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

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

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

getSelectedItem

public final T getSelectedItem()

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

Возвращает:: текущий выбранный элемент

selectedItemProperty

public final ReadOnlyObjectProperty<T> selectedItemProperty()

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

Возвращает:

свойство текущего выбранного элемента

См. также:

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.