javafx.scene.control.cell

クラスTextFieldTableCell<S,T>

java.lang.Object

javafx.scene.Node

javafx.scene.Parent

javafx.scene.layout.Region

javafx.scene.control.Control

javafx.scene.control.Labeled

javafx.scene.control.Cell<T>

javafx.scene.control.IndexedCell<T>

javafx.scene.control.TableCell<S,T>

javafx.scene.control.cell.TextFieldTableCell<S,T>

型パラメータ:

T - TableColumnに含まれる要素の型。

すべての実装されたインタフェース:

Styleable、EventTarget、Skinnable

public class TextFieldTableCell<S,T>
extends TableCell<S,T>

セル内にTextFieldノードを描画するTableCell実装を含むクラス。

デフォルトでは、TextFieldTableCellは、編集されていない場合はLabelとしてレンダリングされ、編集モードの場合はTextFieldとしてレンダリングされます。TextFieldは、デフォルトで、表のセル全体に表示するように拡大されます。

導入されたバージョン:

JavaFX 2.2

プロパティのサマリー

Type	プロパティと説明
ObjectProperty<StringConverter<T>>	converter StringConverterプロパティ。

クラス javafx.scene.control.TableCellから継承されたプロパティ

tableColumn、tableRow、tableView

クラス javafx.scene.control.IndexedCellから継承されたプロパティ

index

クラス javafx.scene.control.Cellから継承されたプロパティ

editable、editing、empty、item、selected

クラス javafx.scene.control.Labeledから継承されたプロパティ

alignment、contentDisplay、ellipsisString、font、graphic、graphicTextGap、labelPadding、lineSpacing、mnemonicParsing、textAlignment、textFill、textOverrun、text、underline、wrapText

クラス javafx.scene.control.Controlから継承されたプロパティ

contextMenu、skin、tooltip

クラス javafx.scene.layout.Regionから継承されたプロパティ

background、border、cacheShape、centerShape、height、insets、maxHeight、maxWidth、minHeight、minWidth、opaqueInsets、padding、prefHeight、prefWidth、scaleShape、shape、snapToPixel、width

クラス javafx.scene.Parentから継承されたプロパティ

needsLayout

クラスjavafx.scene.Nodeから継承されたプロパティ

accessibleHelp、accessibleRoleDescription、accessibleRole、accessibleText、blendMode、boundsInLocal、boundsInParent、cacheHint、cache、clip、cursor、depthTest、disabled、disable、effectiveNodeOrientation、effect、eventDispatcher、focused、focusTraversable、hover、id、inputMethodRequests、layoutBounds、layoutX、layoutY、localToParentTransform、localToSceneTransform、managed、mouseTransparent、nodeOrientation、onContextMenuRequested、onDragDetected、onDragDone、onDragDropped、onDragEntered、onDragExited、onDragOver、onInputMethodTextChanged、onKeyPressed、onKeyReleased、onKeyTyped、onMouseClicked、onMouseDragEntered、onMouseDragExited、onMouseDragged、onMouseDragOver、onMouseDragReleased、onMouseEntered、onMouseExited、onMouseMoved、onMousePressed、onMouseReleased、onRotate、onRotationFinished、onRotationStarted、onScrollFinished、onScroll、onScrollStarted、onSwipeDown、onSwipeLeft、onSwipeRight、onSwipeUp、onTouchMoved、onTouchPressed、onTouchReleased、onTouchStationary、onZoomFinished、onZoom、onZoomStarted、opacity、parent、pickOnBounds、pressed、rotate、rotationAxis、scaleX、scaleY、scaleZ、scene、style、translateX、translateY、translateZ、visible

フィールドのサマリー

クラス javafx.scene.layout.Regionから継承されたフィールド

USE_COMPUTED_SIZE、USE_PREF_SIZE

クラスjavafx.scene.Nodeから継承されたフィールド

BASELINE_OFFSET_SAME_AS_HEIGHT

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
TextFieldTableCell() nullコンバータを使用して、デフォルトのTextFieldTableCellを作成します。
TextFieldTableCell(StringConverter<T> converter) セル内容の編集を許可する編集モードに設定したときに、TextFieldを提供するTextFieldTableCellを作成します。

メソッドのサマリー

修飾子と型	メソッドと説明
void	cancelEdit() この関数を呼び出して、ユーザーによる入力を保存せずに、編集状態から非編集状態に遷移します。
ObjectProperty<StringConverter<T>>	converterProperty() StringConverterプロパティ。
static <S> Callback<TableColumn<S,String>,TableCell<S,String>>	forTableColumn() セルがダブルクリックされるか、またはTableView.edit(int, javafx.scene.control.TableColumn)が呼び出されたときに、TextFieldを提供してセル内容を編集できるようにします。
static <S,T> Callback<TableColumn<S,T>,TableCell<S,T>>	forTableColumn(StringConverter<T> converter) セルがダブルクリックされるか、またはTableView.edit(int, javafx.scene.control.TableColumn)が呼び出されたときに、TextFieldを提供してセル内容を編集できるようにします。
StringConverter<T>	getConverter() このセルで使用するStringConverterを返します。
void	setConverter(StringConverter<T> value) このセルで使用するStringConverterを設定します。
void	startEdit() この関数を呼び出して、セルが編集可能な場合に、非編集状態から編集状態に遷移します。
void	updateItem(T item, boolean empty) updateItemメソッドは、開発者にとって、呼び出すことはできないが、オーバーライドしてセルのビジュアルをカスタマイズできる、最適なメソッドです。

クラス javafx.scene.control.TableCellから継承されたメソッド

commitEdit、createDefaultSkin、executeAccessibleAction、getTableColumn、getTableRow、getTableView、layoutChildren、queryAccessibleAttribute、tableColumnProperty、tableRowProperty、tableViewProperty、updateSelected、updateTableColumn、updateTableRow、updateTableView

クラス javafx.scene.control.IndexedCellから継承されたメソッド

getIndex、indexProperty、updateIndex

クラス javafx.scene.control.Cellから継承されたメソッド

editableProperty、editingProperty、emptyProperty、getItem、isEditable、isEditing、isEmpty、isItemChanged、isSelected、itemProperty、selectedProperty、setEditable、setItem

クラス javafx.scene.control.Labeledから継承されたメソッド

alignmentProperty、contentDisplayProperty、ellipsisStringProperty、fontProperty、getAlignment、getClassCssMetaData、getContentBias、getContentDisplay、getControlCssMetaData、getEllipsisString、getFont、getGraphic、getGraphicTextGap、getLabelPadding、getLineSpacing、getText、getTextAlignment、getTextFill、getTextOverrun、graphicProperty、graphicTextGapProperty、isMnemonicParsing、isUnderline、isWrapText、labelPaddingProperty、lineSpacingProperty、mnemonicParsingProperty、setAlignment、setContentDisplay、setEllipsisString、setFont、setGraphic、setGraphicTextGap、setLineSpacing、setMnemonicParsing、setText、setTextAlignment、setTextFill、setTextOverrun、setUnderline、setWrapText、textAlignmentProperty、textFillProperty、textOverrunProperty、textProperty、toString、underlineProperty、wrapTextProperty

クラス javafx.scene.control.Controlから継承されたメソッド

computeMaxHeight、computeMaxWidth、computeMinHeight、computeMinWidth、computePrefHeight、computePrefWidth、contextMenuProperty、getBaselineOffset、getContextMenu、getCssMetaData、getSkin、getTooltip、isResizable、setContextMenu、setSkin、setTooltip、skinProperty、tooltipProperty

クラス javafx.scene.layout.Regionから継承されたメソッド

backgroundProperty、borderProperty、cacheShapeProperty、centerShapeProperty、getBackground、getBorder、getHeight、getInsets、getMaxHeight、getMaxWidth、getMinHeight、getMinWidth、getOpaqueInsets、getPadding、getPrefHeight、getPrefWidth、getShape、getUserAgentStylesheet、getWidth、heightProperty、insetsProperty、isCacheShape、isCenterShape、isScaleShape、isSnapToPixel、layoutInArea、layoutInArea、layoutInArea、layoutInArea、maxHeight、maxHeightProperty、maxWidth、maxWidthProperty、minHeight、minHeightProperty、minWidth、minWidthProperty、opaqueInsetsProperty、paddingProperty、positionInArea、positionInArea、prefHeight、prefHeightProperty、prefWidth、prefWidthProperty、resize、scaleShapeProperty、setBackground、setBorder、setCacheShape、setCenterShape、setHeight、setMaxHeight、setMaxSize、setMaxWidth、setMinHeight、setMinSize、setMinWidth、setOpaqueInsets、setPadding、setPrefHeight、setPrefSize、setPrefWidth、setScaleShape、setShape、setSnapToPixel、setWidth、shapeProperty、snappedBottomInset、snappedLeftInset、snappedRightInset、snappedTopInset、snapPosition、snapSize、snapSpace、snapToPixelProperty、widthProperty

クラス javafx.scene.Parentから継承されたメソッド

getChildren、getChildrenUnmodifiable、getManagedChildren、getStylesheets、isNeedsLayout、layout、lookup、needsLayoutProperty、requestLayout、requestParentLayout、setNeedsLayout、updateBounds

クラスjavafx.scene.Nodeから継承されたメソッド

accessibleHelpProperty、accessibleRoleDescriptionProperty、accessibleRoleProperty、accessibleTextProperty、addEventFilter、addEventHandler、applyCss、autosize、blendModeProperty、boundsInLocalProperty、boundsInParentProperty、buildEventDispatchChain、cacheHintProperty、cacheProperty、clipProperty、computeAreaInScreen、contains、contains、cursorProperty、depthTestProperty、disabledProperty、disableProperty、effectiveNodeOrientationProperty、effectProperty、eventDispatcherProperty、fireEvent、focusedProperty、focusTraversableProperty、getAccessibleHelp、getAccessibleRole、getAccessibleRoleDescription、getAccessibleText、getBlendMode、getBoundsInLocal、getBoundsInParent、getCacheHint、getClip、getCursor、getDepthTest、getEffect、getEffectiveNodeOrientation、getEventDispatcher、getId、getInputMethodRequests、getLayoutBounds、getLayoutX、getLayoutY、getLocalToParentTransform、getLocalToSceneTransform、getNodeOrientation、getOnContextMenuRequested、getOnDragDetected、getOnDragDone、getOnDragDropped、getOnDragEntered、getOnDragExited、getOnDragOver、getOnInputMethodTextChanged、getOnKeyPressed、getOnKeyReleased、getOnKeyTyped、getOnMouseClicked、getOnMouseDragEntered、getOnMouseDragExited、getOnMouseDragged、getOnMouseDragOver、getOnMouseDragReleased、getOnMouseEntered、getOnMouseExited、getOnMouseMoved、getOnMousePressed、getOnMouseReleased、getOnRotate、getOnRotationFinished、getOnRotationStarted、getOnScroll、getOnScrollFinished、getOnScrollStarted、getOnSwipeDown、getOnSwipeLeft、getOnSwipeRight、getOnSwipeUp、getOnTouchMoved、getOnTouchPressed、getOnTouchReleased、getOnTouchStationary、getOnZoom、getOnZoomFinished、getOnZoomStarted、getOpacity、getParent、getProperties、getPseudoClassStates、getRotate、getRotationAxis、getScaleX、getScaleY、getScaleZ、getScene、getStyle、getStyleableParent、getStyleClass、getTransforms、getTranslateX、getTranslateY、getTranslateZ、getTypeSelector、getUserData、hasProperties、hoverProperty、idProperty、inputMethodRequestsProperty、intersects、intersects、isCache、isDisable、isDisabled、isFocused、isFocusTraversable、isHover、isManaged、isMouseTransparent、isPickOnBounds、isPressed、isVisible、layoutBoundsProperty、layoutXProperty、layoutYProperty、localToParent、localToParent、localToParent、localToParent、localToParent、localToParentTransformProperty、localToScene、localToScene、localToScene、localToScene、localToScene、localToScene、localToScene、localToScene、localToScene、localToScene、localToSceneTransformProperty、localToScreen、localToScreen、localToScreen、localToScreen、localToScreen、lookupAll、managedProperty、mouseTransparentProperty、nodeOrientationProperty、notifyAccessibleAttributeChanged、onContextMenuRequestedProperty、onDragDetectedProperty、onDragDoneProperty、onDragDroppedProperty、onDragEnteredProperty、onDragExitedProperty、onDragOverProperty、onInputMethodTextChangedProperty、onKeyPressedProperty、onKeyReleasedProperty、onKeyTypedProperty、onMouseClickedProperty、onMouseDragEnteredProperty、onMouseDragExitedProperty、onMouseDraggedProperty、onMouseDragOverProperty、onMouseDragReleasedProperty、onMouseEnteredProperty、onMouseExitedProperty、onMouseMovedProperty、onMousePressedProperty、onMouseReleasedProperty、onRotateProperty、onRotationFinishedProperty、onRotationStartedProperty、onScrollFinishedProperty、onScrollProperty、onScrollStartedProperty、onSwipeDownProperty、onSwipeLeftProperty、onSwipeRightProperty、onSwipeUpProperty、onTouchMovedProperty、onTouchPressedProperty、onTouchReleasedProperty、onTouchStationaryProperty、onZoomFinishedProperty、onZoomProperty、onZoomStartedProperty、opacityProperty、parentProperty、parentToLocal、parentToLocal、parentToLocal、parentToLocal、parentToLocal、pickOnBoundsProperty、pressedProperty、pseudoClassStateChanged、relocate、removeEventFilter、removeEventHandler、requestFocus、resizeRelocate、rotateProperty、rotationAxisProperty、scaleXProperty、scaleYProperty、scaleZProperty、sceneProperty、sceneToLocal、sceneToLocal、sceneToLocal、sceneToLocal、sceneToLocal、sceneToLocal、sceneToLocal、sceneToLocal、screenToLocal、screenToLocal、screenToLocal、setAccessibleHelp、setAccessibleRole、setAccessibleRoleDescription、setAccessibleText、setBlendMode、setCache、setCacheHint、setClip、setCursor、setDepthTest、setDisable、setDisabled、setEffect、setEventDispatcher、setEventHandler、setFocused、setFocusTraversable、setHover、setId、setInputMethodRequests、setLayoutX、setLayoutY、setManaged、setMouseTransparent、setNodeOrientation、setOnContextMenuRequested、setOnDragDetected、setOnDragDone、setOnDragDropped、setOnDragEntered、setOnDragExited、setOnDragOver、setOnInputMethodTextChanged、setOnKeyPressed、setOnKeyReleased、setOnKeyTyped、setOnMouseClicked、setOnMouseDragEntered、setOnMouseDragExited、setOnMouseDragged、setOnMouseDragOver、setOnMouseDragReleased、setOnMouseEntered、setOnMouseExited、setOnMouseMoved、setOnMousePressed、setOnMouseReleased、setOnRotate、setOnRotationFinished、setOnRotationStarted、setOnScroll、setOnScrollFinished、setOnScrollStarted、setOnSwipeDown、setOnSwipeLeft、setOnSwipeRight、setOnSwipeUp、setOnTouchMoved、setOnTouchPressed、setOnTouchReleased、setOnTouchStationary、setOnZoom、setOnZoomFinished、setOnZoomStarted、setOpacity、setPickOnBounds、setPressed、setRotate、setRotationAxis、setScaleX、setScaleY、setScaleZ、setStyle、setTranslateX、setTranslateY、setTranslateZ、setUserData、setVisible、snapshot、snapshot、startDragAndDrop、startFullDrag、styleProperty、toBack、toFront、translateXProperty、translateYProperty、translateZProperty、usesMirroring、visibleProperty

クラス java.lang.Objectから継承されたメソッド

clone、equals、finalize、getClass、hashCode、notify、notifyAll、wait、wait、wait

プロパティの詳細

converter

public final ObjectProperty<StringConverter<T>> converterProperty

StringConverterプロパティ。

コンストラクタの詳細

TextFieldTableCell

public TextFieldTableCell()

nullコンバータを使用して、デフォルトのTextFieldTableCellを作成します。StringConverterが指定されていない場合、このセルはTextFieldからの入力を受け入れることができません(この入力を変換してドメイン・オブジェクトに戻す方法がわからないため)。したがって、コンバータを個別に設定する場合を除き、このコンストラクタは使用しないことをお薦めします。

TextFieldTableCell

public TextFieldTableCell(StringConverter<T> converter)

セル内容の編集を許可する編集モードに設定したときに、TextFieldを提供するTextFieldTableCellを作成します。このメソッドは、すべてのTableColumnインスタンスで(その汎用型に関係なく)動作します。ただし、これを有効化するには、指定された文字列を(ユーザーの入力から)型Tのインスタンスに変換するStringConverterを指定する必要があります。このアイテムは、TableColumn.onEditCommitProperty()コールバックに渡されます。

パラメータ:

converter - 指定された文字列を(ユーザーの入力から)型Tのインスタンスに変換できるconverter。

メソッドの詳細

forTableColumn

public static <S> Callback<TableColumn<S,String>,TableCell<S,String>> forTableColumn()

セルがダブルクリックされるか、またはTableView.edit(int, javafx.scene.control.TableColumn)が呼び出されたときに、TextFieldを提供してセル内容を編集できるようにします。このメソッドは、文字列型のTableColumnインスタンスでのみ動作します。

戻り値:

コンテンツのテキスト編集を有効化する、TableColumnのcell factory propertyに挿入できるCallback。

forTableColumn

public static <S,T> Callback<TableColumn<S,T>,TableCell<S,T>> forTableColumn(StringConverter<T> converter)

セルがダブルクリックされるか、またはTableView.edit(int, javafx.scene.control.TableColumn)が呼び出されたときに、TextFieldを提供してセル内容を編集できるようにします。このメソッドは、すべてのTableColumnインスタンスで(その汎用型に関係なく)動作します。ただし、これを有効化するには、指定された文字列を(ユーザーの入力から)型Tのインスタンスに変換するStringConverterを指定する必要があります。このアイテムは、TableColumn.onEditCommitProperty()コールバックに渡されます。

パラメータ:

converter - 指定された文字列を(ユーザーの入力から)型Tのインスタンスに変換できるStringConverter。

戻り値:

コンテンツのテキスト編集を有効化する、TableColumnのcell factory propertyに挿入できるCallback。

converterProperty

public final ObjectProperty<StringConverter<T>> converterProperty()

StringConverterプロパティ。

setConverter

public final void setConverter(StringConverter<T> value)

このセルで使用するStringConverterを設定します。

getConverter

public final StringConverter<T> getConverter()

このセルで使用するStringConverterを返します。

startEdit

public void startEdit()

この関数を呼び出して、セルが編集可能な場合に、非編集状態から編集状態に遷移します。セルがすでに編集状態である場合は、その状態のままになります。

オーバーライド:

startEdit 、クラス: TableCell<S,T>

cancelEdit

public void cancelEdit()

この関数を呼び出して、ユーザーによる入力を保存せずに、編集状態から非編集状態に遷移します。

オーバーライド:

cancelEdit 、クラス: TableCell<S,T>

updateItem

public void updateItem(T item,
                       boolean empty)

updateItemメソッドは、開発者にとって、呼び出すことはできないが、オーバーライドしてセルのビジュアルをカスタマイズできる、最適なメソッドです。つまり、開発者は、コードでこのメソッドを呼び出さないようにしてください。このメソッドは、ListViewコントロールなどのUIコントロールによってのみ呼び出されるようにする必要があります。ただし、updateItemメソッドが存在する理由は、開発者がカスタム・セル・ファクトリ(ListView cell factoryなど)を指定するときに、updateItemメソッドをオーバーライドして、セルを完全にカスタマイズできるようにすることです。

CellのサブクラスがupdateItemメソッドを適切にオーバーライドすることは非常に重要であり、これは、そのようにしないと、セルが空白になったり、セルに予期しないコンテンツが含まれるなどの問題が発生するためです。updateItemメソッドを適切にオーバーライドする方法の例を次に示します。

 protected void updateItem(T item, boolean empty) {
     super.updateItem(item, empty);

     if (empty || item == null) {
         setText(null);
         setGraphic(null);
     } else {
         setText(item.toString());
     }
 }
 

このコード・サンプルには次の2つの重要なポイントがあることに注意してください。

1. super.updateItem(T, boolean)メソッドを呼び出します。これを行わないと、itemプロパティとemptyプロパティが正しく設定されず、グラフィカルな問題が発生する可能性があります。
2. empty状態をテストし、trueの場合は、textプロパティとgraphicプロパティをnullに設定します。これを行わないと、ほぼ確実に、エンド・ユーザーに対して予想外のグラフィカル・アーティファクトがセル内に表示されます。

オーバーライド:

updateItem 、クラス: Cell<T>

パラメータ:

item - セルの新しいアイテム。

empty - このセルがリストからのデータを表しているかどうか。空の場合、いずれのドメイン・データも表しませんが、空の行のレンダリングに使用されるセルとなります。