V
- 値の型public class TextFormatter<V> extends Object
TextInputControl
テキストのフォーマットを記述します。
getFilter()
)。これは、テキストの目的のフォーマットを保持する際に役立ちます。デフォルトのテキスト・サプライヤを使用すると、初期テキストを提供できます。getValueConverter()
)および値(valueProperty()
)を使用すると、V
型の値を表す特殊なフォーマットを提供できます。コントロールが編集可能な場合、ユーザーによりテキストが変更されると、値はテキストと一致するように更新されます。
フィルタのみまたは値コンバータのみを含むフォーマッタにすることも可能です。ただし、値コンバータが提供されていない場合、値を設定するとIllegalStateException
が発生し、値は常にnullとなります。
Formatter
には、その現在の割当て先であるTextInputControl
の状態を表す値が含まれるため、1つのTextInputControl
で一度に使用できるFormatter
インスタンスは1つのみです。
Type | プロパティと説明 |
---|---|
ObjectProperty<V> |
value
このフォーマッタの現在の値。
|
修飾子と型 | クラスと説明 |
---|---|
static class |
TextFormatter.Change
TextInputControlのコンテンツまたは選択内容の変更を表す状態が含まれます。
|
修飾子と型 | フィールドと説明 |
---|---|
static StringConverter<String> |
IDENTITY_STRING_CONVERTER
この文字列コンバータは、テキストを同じString値に変換します。
|
コンストラクタと説明 |
---|
TextFormatter(StringConverter<V> valueConverter)
提供された値コンバータを使用して新しいFormatterを作成します。
|
TextFormatter(StringConverter<V> valueConverter, V defaultValue)
提供された値コンバータおよびデフォルト値を使用して新しいFormatterを作成します。
|
TextFormatter(StringConverter<V> valueConverter, V defaultValue, UnaryOperator<TextFormatter.Change> filter)
提供されたフィルタ、値コンバータおよびデフォルト値を使用して新しいFormatterを作成します。
|
TextFormatter(UnaryOperator<TextFormatter.Change> filter)
提供されたフィルタを使用して新しいFormatterを作成します。
|
修飾子と型 | メソッドと説明 |
---|---|
UnaryOperator<TextFormatter.Change> |
getFilter()
フィルタによって、ユーザーはテキスト・コンテンツに対して行われた変更をインターセプトおよび変更できます。
|
V |
getValue()
プロパティvalueの値を取得します。
|
StringConverter<V> |
getValueConverter()
値とテキストの間のコンバータ。
|
void |
setValue(V value)
プロパティvalueの値を設定します。
|
ObjectProperty<V> |
valueProperty()
このフォーマッタの現在の値。
|
public final ObjectProperty<V> valueProperty
TextInputControl
にフォーマッタが設定されている場合ですgetValue()
、setValue(V)
public static final StringConverter<String> IDENTITY_STRING_CONVERTER
public TextFormatter(UnaryOperator<TextFormatter.Change> filter)
filter
- このフォーマッタで使用するフィルタ、またはnullpublic TextFormatter(StringConverter<V> valueConverter, V defaultValue, UnaryOperator<TextFormatter.Change> filter)
valueConverter
- このフォーマッタで使用する値コンバータ、またはnull。defaultValue
- デフォルト値。filter
- このフォーマッタで使用するフィルタ、またはnullpublic TextFormatter(StringConverter<V> valueConverter, V defaultValue)
valueConverter
- このフォーマッタで使用する値コンバータ。nullは指定できません。defaultValue
- デフォルト値public TextFormatter(StringConverter<V> valueConverter)
valueConverter
- このフォーマッタで使用する値コンバータ。nullは指定できません。public final StringConverter<V> getValueConverter()
TextInputControl.textProperty()
}とvalueProperty()
}の間の"バインディング"を管理します。コントロールがフォーカスを失った場合、または値がコミットされた場合(TextFieldのみ)、値が更新されます。値を設定すると、提供されたコンバータを使用してコントロールのテキストが更新されます。テキストを値に変換できない場合は、例外がスローされます。TextInputControl.commitValue()
、TextInputControl.cancelEdit()
public final UnaryOperator<TextFormatter.Change> getFilter()
フィルタ自体は、TextFormatter.Change
オブジェクトを受け入れるUnaryOperator
です。実際の(フィルタ処理された)変更を含むTextFormatter.Change
オブジェクトを返します。nullを返すと、変更が拒否されます。
public final ObjectProperty<V> valueProperty()
TextInputControl
にフォーマッタが設定されている場合ですgetValue()
、setValue(V)
public final void setValue(V value)
TextInputControl
にフォーマッタが設定されている場合ですpublic final V getValue()
TextInputControl
にフォーマッタが設定されている場合ですCopyright (c) 2008, 2015, Oracle and/or its affiliates. All rights reserved.