/* * Copyright (c) 2012, 2017, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it * under the terms of the GNU General Public License version 2 only, as * published by the Free Software Foundation. Oracle designates this * particular file as subject to the "Classpath" exception as provided * by Oracle in the LICENSE file that accompanied this code. * * This code is distributed in the hope that it will be useful, but WITHOUT * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License * version 2 for more details (a copy is included in the LICENSE file that * accompanied this code). * * You should have received a copy of the GNU General Public License version * 2 along with this work; if not, write to the Free Software Foundation, * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. * * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA * or visit www.oracle.com if you need additional information or have any * questions. */ package javafx.scene.control.cell; import javafx.beans.property.ObjectProperty; import javafx.beans.property.SimpleObjectProperty; import javafx.scene.control.TextField; import javafx.scene.control.TreeTableCell; import javafx.scene.control.TreeTableColumn; import javafx.util.Callback; import javafx.util.StringConverter; import javafx.util.converter.DefaultStringConverter; import java.util.Optional; /** * A class containing a {@link javafx.scene.control.TableCell} implementation that draws a * {@link TextField} node inside the cell. * *

By default, the TextFieldTableCell is rendered as a {@link javafx.scene.control.Label} when not * being edited, and as a TextField when in editing mode. The TextField will, by * default, stretch to fill the entire table cell. * * @param The type of the TreeTableView generic type * @param The type of the elements contained within the TreeTableColumn. * @since JavaFX 8.0 */ public class TextFieldTreeTableCell extends TreeTableCell { /*************************************************************************** * * * Static cell factories * * * **************************************************************************/ /** * Provides a {@link TextField} that allows editing of the cell content when * the cell is double-clicked, or when * {@link javafx.scene.control.TreeTableView#edit(int, javafx.scene.control.TreeTableColumn)} is called. * This method will only work on {@link TreeTableColumn} instances which are of * type String. * * @param The type of the TreeTableView generic type * @return A {@link Callback} that can be inserted into the * {@link TreeTableColumn#cellFactoryProperty() cell factory property} of a * TreeTableColumn, that enables textual editing of the content. */ public static Callback, TreeTableCell> forTreeTableColumn() { return forTreeTableColumn(new DefaultStringConverter()); } /** * Provides a {@link TextField} that allows editing of the cell content when * the cell is double-clicked, or when * {@link javafx.scene.control.TreeTableView#edit(int, javafx.scene.control.TreeTableColumn) } is called. * This method will work on any {@link TreeTableColumn} instance, regardless of * its generic type. However, to enable this, a {@link StringConverter} must * be provided that will convert the given String (from what the user typed * in) into an instance of type T. This item will then be passed along to the * {@link TreeTableColumn#onEditCommitProperty()} callback. * * @param The type of the TreeTableView generic type * @param The type of the elements contained within the TreeTableColumn * @param converter A {@link StringConverter} that can convert the given String * (from what the user typed in) into an instance of type T. * @return A {@link Callback} that can be inserted into the * {@link TreeTableColumn#cellFactoryProperty() cell factory property} of a * TreeTableColumn, that enables textual editing of the content. */ public static Callback, TreeTableCell> forTreeTableColumn( final StringConverter converter) { return list -> new TextFieldTreeTableCell<>(converter); } /*************************************************************************** * * * Fields * * * **************************************************************************/ private TextField textField; /*************************************************************************** * * * Constructors * * * **************************************************************************/ /** * Creates a default TextFieldTreeTableCell with a null converter. Without a * {@link StringConverter} specified, this cell will not be able to accept * input from the TextField (as it will not know how to convert this back * to the domain object). It is therefore strongly encouraged to not use * this constructor unless you intend to set the converter separately. */ public TextFieldTreeTableCell() { this(null); } /** * Creates a TextFieldTreeTableCell that provides a {@link TextField} when put * into editing mode that allows editing of the cell content. This method * will work on any TreeTableColumn instance, regardless of its generic type. * However, to enable this, a {@link StringConverter} must be provided that * will convert the given String (from what the user typed in) into an * instance of type T. This item will then be passed along to the * {@link TreeTableColumn#onEditCommitProperty()} callback. * * @param converter A {@link StringConverter converter} that can convert * the given String (from what the user typed in) into an instance of * type T. */ public TextFieldTreeTableCell(StringConverter converter) { this.getStyleClass().add("text-field-tree-table-cell"); setConverter(converter); } /*************************************************************************** * * * Properties * * * **************************************************************************/ // --- converter private ObjectProperty> converter = new SimpleObjectProperty<>(this, "converter"); /** * The {@link StringConverter} property. * @return the {@link StringConverter} property */ public final ObjectProperty> converterProperty() { return converter; } /** * Sets the {@link StringConverter} to be used in this cell. * @param value the {@link StringConverter} to be used in this cell */ public final void setConverter(StringConverter value) { converterProperty().set(value); } /** * Returns the {@link StringConverter} used in this cell. * @return the {@link StringConverter} used in this cell */ public final StringConverter getConverter() { return converterProperty().get(); } /*************************************************************************** * * * Public API * * * **************************************************************************/ /** {@inheritDoc} */ @Override public void startEdit() { if (! isEditable() || ! getTreeTableView().isEditable() || ! getTableColumn().isEditable()) { return; } super.startEdit(); if (isEditing()) { if (textField == null) { textField = CellUtils.createTextField(this, getConverter()); } CellUtils.startEdit(this, getConverter(), null, null, textField); } } /** {@inheritDoc} */ @Override public void cancelEdit() { super.cancelEdit(); CellUtils.cancelEdit(this, getConverter(), null); } /** {@inheritDoc} */ @Override public void updateItem(T item, boolean empty) { super.updateItem(item, empty); CellUtils.updateItem(this, getConverter(), null, null, textField); } /** {@inheritDoc} */ @Override protected Optional getEditorValue() { StringConverter converter = getConverter(); return converter == null ? Optional.empty() : Optional.of(converter.fromString(textField.getText())); } }