Класс TextFormatter<V>
- javafx.scene.control.TextFormatter<V>
Параметры типа:
V - Тип значения
public class TextFormatter<V> extends Object
TextInputControl текста, используя два разных механизма: - Фильтр (
getFilter()), который может перехватывать и изменять пользовательский ввод. Это помогает поддерживать текст в нужном формате. По умолчанию используется поставщик текста для первоначального текста. - Преобразователь значений (
getValueConverter()) и значение (valueProperty()) могут использоваться для предоставления специального формата, представляющего значение типаV. Если элемент управления разрешает редактирование, и текст изменяется пользователем, значение обновляется для соответствия тексту.
Возможен форматировщик только с фильтром или только с преобразователем значений. Однако, если преобразователь значений не задан, установка значения приведёт к IllegalStateException, а значение всегда будет null.
Поскольку Formatter содержит значение, представляющее состояние TextInputControl, которому он в данный момент присвоен, один экземпляр Formatter может использоваться только в одном TextInputControl одновременно.
С:
JavaFX 8u40
-
Краткое описание свойств
Все методыМетоды экземпляровКонкретные методы Тип Свойство и описание ObjectProperty<V>valueТекущее значение для этого форматировщика.
-
Краткое описание вложенных классов
Вложенные классы Модификатор и тип Класс и описание static classTextFormatter.ChangeСодержит состояние, представляющее изменение содержимого или выделения для TextInputControl.
-
Краткое описание полей
Поля Модификатор и тип Поле и описание static StringConverter<String>IDENTITY_STRING_CONVERTERЭтот преобразователь строк преобразует текст в то же значение типа String.
-
Краткое описание конструкторов
Конструкторы Конструктор и описание TextFormatter(StringConverter<V> valueConverter)Создаёт новый форматировщик с предоставленным преобразователем значений.TextFormatter(StringConverter<V> valueConverter, V defaultValue)Создаёт новый форматировщик с предоставленным преобразователем значений и значением по умолчанию.TextFormatter(StringConverter<V> valueConverter, V defaultValue, UnaryOperator<TextFormatter.Change> filter)Создаёт новый форматировщик с предоставленным фильтром, преобразователем значений и значением по умолчанию.TextFormatter(UnaryOperator<TextFormatter.Change> filter)Создаёт новый форматировщик с предоставленным фильтром.
-
Краткое описание методов
Все методыМетоды экземпляровКонкретные методы Модификатор и тип Метод и описание UnaryOperator<TextFormatter.Change>getFilter()Фильтр позволяет пользователю перехватывать и изменять любое изменение, внесённое в содержимое текста.VgetValue()Возвращает значение свойства value.StringConverter<V>getValueConverter()Преобразователь между значениями и текстом.voidsetValue(V value)Устанавливает значение свойства value.ObjectProperty<V>valueProperty()Текущее значение для этого форматировщика.
-
Подробное описание свойств
-
value
public final ObjectProperty<V> valueProperty
Текущее значение для этого форматировщика. При установке форматировщика наTextInputControlи наличияСм. также:
-
-
Подробное описание полей
-
IDENTITY_STRING_CONVERTER
public static final StringConverter<String> IDENTITY_STRING_CONVERTER
Этот преобразователь строк преобразует текст в то же значение типа String. Это может быть полезно в случаях, когда вы хотите работать с текстом через значение или вам нужно предоставить значение текста по умолчанию.
-
-
Подробное описание конструкторов
-
TextFormatter
public TextFormatter(UnaryOperator<TextFormatter.Change> filter)
Создаёт новый форматировщик с предоставленным фильтром.Параметры:
filter- Фильтр для использования в этом форматировщике или null
-
TextFormatter
public TextFormatter(StringConverter<V> valueConverter, V defaultValue, UnaryOperator<TextFormatter.Change> filter)Создаёт новый форматировщик с предоставленным фильтром, преобразователем значений и значением по умолчанию.Параметры:
valueConverter- Преобразователь значений для использования в этом форматировщике или null.
-
TextFormatter
public TextFormatter(StringConverter<V> valueConverter, V defaultValue)Создаёт новый форматировщик с предоставленным преобразователем значений и значением по умолчанию.Параметры:
valueConverter- Преобразователь значений для использования в этом форматировщике. Он не должен быть null.
-
TextFormatter
public TextFormatter(StringConverter<V> valueConverter)
Создаёт новый форматировщик с предоставленным преобразователем значений. Значение по умолчанию будет null.Параметры:
valueConverter- Преобразователь значений для использования в этом форматировщике. Он не должен быть null.
-
-
Подробное описание методов
-
getValueConverter
public final StringConverter<V> getValueConverter()
Преобразователь между значениями и текстом. Он поддерживает "связь" междуTextInputControl.textProperty()иvalueProperty(). Значение обновляется, когда элемент управления теряет фокус или выполняется подтверждение (только TextField). Установка значения обновит текст элемента управления, используя предоставленный преобразователь. Если преобразование текста в значение невозможно, должно быть выброшено исключение.Возвращает:
StringConverter для значений или null, если не задан
-
getFilter
public final UnaryOperator<TextFormatter.Change> getFilter()
Фильтр позволяет пользователю перехватывать и изменять любое изменение, внесённое в содержимое текста.Сам фильтр — это
UnaryOperator, который принимает объектTextFormatter.Change. Он должен возвращать объектTextFormatter.Change, который содержит фактическое (отфильтрованное) изменение. Возвращение null отклоняет изменение.Возвращает:
Фильтр для этого форматировщика или null, если его нет
-
valueProperty
public final ObjectProperty<V> valueProperty()
Текущее значение для этого форматировщика. При установке форматировщика наTextInputControlи наличияСм. также:
-
setValue
public final void setValue(V value)
Устанавливает значение свойства value.Описание свойства:
Текущее значение для этого форматировщика. При установке форматировщика на
TextInputControlи наличии
-
getValue
public final V getValue()
Возвращает значение свойства value.Описание свойства:
Текущее значение для этого форматировщика. При установке форматировщика на
TextInputControlи наличия
-
© 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.