機械翻訳について

javafx.scene.control.cell

クラスComboBoxListCell<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.ListCell<T>

javafx.scene.control.cell.ComboBoxListCell<T>

型パラメータ:

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

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

Styleable、EventTarget、Skinnable

public class ComboBoxListCell<T>
extends ListCell<T>

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

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

ComboBoxListCellを作成するには、ComboBoxメニューが表示されるとユーザーに表示される0以上のアイテムを提供する必要があります。 これらのアイテムはListViewアイテム・シーケンスと同じ型である必要があり、これにより、たとえば、選択時にitemsリストの既存値を置き換えます。

導入されたバージョン:

JavaFX 2.2

プロパティのサマリー

Type	プロパティと説明
BooleanProperty	comboBoxEditable ユーザーに表示する場合にComboBoxを編集可能にするかどうかを表すプロパティ。
ObjectProperty<StringConverter<T>>	converter StringConverterプロパティ。

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

listView

クラス 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

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

コンストラクタ

コンストラクタと説明
ComboBoxListCell() 空のアイテム・リストを持つデフォルトのComboBoxListCellを作成します。
ComboBoxListCell(ObservableList<T> items) ComboBoxが表示されているときにComboBoxの移入に使用される、指定されたアイテムを含むデフォルトのComboBoxListCellインスタンスを作成します。
ComboBoxListCell(StringConverter<T> converter, ObservableList<T> items) ComboBoxが表示されるときに、その値の移入に使用される、指定されたアイテムを含むComboBoxListCellインスタンス、およびアイテムをユーザーが読取り可能な形式に変換するために使用されるStringConverterを作成します。
ComboBoxListCell(StringConverter<T> converter, T... items) ComboBoxが表示されるときに、その値の移入に使用される、指定されたアイテムを含むComboBoxListCellインスタンス、およびアイテムをユーザーが読取り可能な形式に変換するために使用されるStringConverterを作成します。
ComboBoxListCell(T... items) ComboBoxが表示されているときにComboBoxの移入に使用される、指定されたアイテムを含むデフォルトのComboBoxListCellインスタンスを作成します。

メソッドのサマリー

修飾子と型	メソッドと説明
void	cancelEdit() この関数を呼び出して、ユーザーによる入力を保存せずに、編集状態から非編集状態に遷移します。
BooleanProperty	comboBoxEditableProperty() ユーザーに表示する場合にComboBoxを編集可能にするかどうかを表すプロパティ。
ObjectProperty<StringConverter<T>>	converterProperty() StringConverterプロパティ。
static <T> Callback<ListView<T>,ListCell<T>>	forListView(ObservableList<T> items) ListViewコントロールで使用するComboBoxセル・ファクトリを作成します。
static <T> Callback<ListView<T>,ListCell<T>>	forListView(StringConverter<T> converter, ObservableList<T> items) ListViewコントロールで使用するComboBoxセル・ファクトリを作成します。
static <T> Callback<ListView<T>,ListCell<T>>	forListView(StringConverter<T> converter, T... items) ListViewコントロールで使用するComboBoxセル・ファクトリを作成します。
static <T> Callback<ListView<T>,ListCell<T>>	forListView(T... items) ListViewコントロールで使用するComboBoxセル・ファクトリを作成します。
StringConverter<T>	getConverter() このセルで使用するStringConverterを返します。
ObservableList<T>	getItems() ChoiceBoxが表示されているときにChoiceBoxに表示されるアイテムを返します。
boolean	isComboBoxEditable() ComboBoxが編集可能な場合はtrueを返します。
void	setComboBoxEditable(boolean value) ComboBoxを編集可能に構成します(オプション以外のユーザー入力をドロップダウン・リストに提供することを許可します)。
void	setConverter(StringConverter<T> value) このセルで使用するStringConverterを設定します。
void	startEdit() この関数を呼び出して、セルが編集可能な場合に、非編集状態から編集状態に遷移します。
void	updateItem(T item, boolean empty) updateItemメソッドは、開発者にとって、呼び出すことはできないが、オーバーライドしてセルのビジュアルをカスタマイズできる、最適なメソッドです。

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

commitEdit, createDefaultSkin, executeAccessibleAction, getListView, listViewProperty, queryAccessibleAttribute, updateListView

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

getIndex, indexProperty, updateIndex

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

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

クラス 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, layoutChildren, 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プロパティ。

comboBoxEditable

public final BooleanProperty comboBoxEditableProperty

ユーザーに表示する場合にComboBoxを編集可能にするかどうかを表すプロパティ。

関連項目:

isComboBoxEditable()、setComboBoxEditable(boolean)

コンストラクタの詳細

ComboBoxListCell

public ComboBoxListCell()

空のアイテム・リストを持つデフォルトのComboBoxListCellを作成します。

ComboBoxListCell

@SafeVarargs
public ComboBoxListCell(T... items)

ComboBoxが表示されているときにComboBoxの移入に使用される、指定されたアイテムを含むデフォルトのComboBoxListCellインスタンスを作成します。

パラメータ:

items - ユーザーが選択した場合に、ComboBoxポップアップ・メニューに表示されるアイテム。

ComboBoxListCell

@SafeVarargs
public ComboBoxListCell(StringConverter<T> converter,
                                      T... items)

ComboBoxが表示されるときに、その値の移入に使用される、指定されたアイテムを含むComboBoxListCellインスタンス、およびアイテムをユーザーが読取り可能な形式に変換するために使用されるStringConverterを作成します。

パラメータ:

converter - 型Tのアイテムをユーザーが読取り可能な文字列に変換して、ComboBoxポップアップ・メニューに表示できるようにするStringConverter。

items - ユーザーが選択した場合に、ComboBoxポップアップ・メニューに表示されるアイテム。

ComboBoxListCell

public ComboBoxListCell(ObservableList<T> items)

ComboBoxが表示されているときにComboBoxの移入に使用される、指定されたアイテムを含むデフォルトのComboBoxListCellインスタンスを作成します。

パラメータ:

items - ユーザーが選択した場合に、ComboBoxポップアップ・メニューに表示されるアイテム。

ComboBoxListCell

public ComboBoxListCell(StringConverter<T> converter,
                        ObservableList<T> items)

ComboBoxが表示されるときに、その値の移入に使用される、指定されたアイテムを含むComboBoxListCellインスタンス、およびアイテムをユーザーが読取り可能な形式に変換するために使用されるStringConverterを作成します。

パラメータ:

converter - 型Tのアイテムをユーザーが読取り可能な文字列に変換して、ComboBoxポップアップ・メニューに表示できるようにするStringConverter。

items - ユーザーが選択した場合に、ComboBoxポップアップ・メニューに表示されるアイテム。

メソッドの詳細

forListView

@SafeVarargs
public static <T> Callback<ListView<T>,ListCell<T>> forListView(T... items)

ListViewコントロールで使用するComboBoxセル・ファクトリを作成します。 デフォルトでは、ComboBoxCellは、編集されていない場合はLabelとしてレンダリングされ、編集モードの場合はComboBoxとしてレンダリングされます。 ComboBoxは、デフォルトで、リスト・セル全体に表示するように拡大されます。

型パラメータ:

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

パラメータ:

items - ComboBoxメニューが表示されるとユーザーに表示される0以上のアイテム。 これらのアイテムはListViewアイテム・リストと同じ型である必要があり、これにより、たとえば、選択時にitemsリストの既存値を置き換えます。

戻り値:

ListViewに含まれる要素の型で動作できるListCellを返すCallback。

forListView

@SafeVarargs
public static <T> Callback<ListView<T>,ListCell<T>> forListView(StringConverter<T> converter,
                                                                              T... items)

ListViewコントロールで使用するComboBoxセル・ファクトリを作成します。 デフォルトでは、ComboBoxCellは、編集されていない場合はLabelとしてレンダリングされ、編集モードの場合はComboBoxとしてレンダリングされます。 ComboBoxは、デフォルトで、リスト・セル全体に表示するように拡大されます。

型パラメータ:

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

パラメータ:

converter - (型Tの)指定されたアイテムをユーザーに表示するために文字列に変換するStringConverter。

items - ComboBoxメニューが表示されるとユーザーに表示される0以上のアイテム。 これらのアイテムはListViewアイテム・リストと同じ型である必要があり、これにより、たとえば、選択時にitemsリストの既存値を置き換えます。

戻り値:

ListViewに含まれる要素の型で動作できるListCellを返すCallback。

forListView

public static <T> Callback<ListView<T>,ListCell<T>> forListView(ObservableList<T> items)

ListViewコントロールで使用するComboBoxセル・ファクトリを作成します。 デフォルトでは、ComboBoxCellは、編集されていない場合はLabelとしてレンダリングされ、編集モードの場合はComboBoxとしてレンダリングされます。 ComboBoxは、デフォルトで、リスト・セル全体に表示するように拡大されます。

型パラメータ:

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

パラメータ:

items - ComboBoxメニューが表示されるとユーザーに表示される0以上のアイテムを含むObservableList。 これらのアイテムはListViewアイテム・シーケンスと同じ型である必要があり、これにより、たとえば、選択時にitemsリストの既存値を置き換えます。

戻り値:

ListViewに含まれる要素の型で動作できるListCellを返すCallback。

forListView

public static <T> Callback<ListView<T>,ListCell<T>> forListView(StringConverter<T> converter,
                                                                ObservableList<T> items)

ListViewコントロールで使用するComboBoxセル・ファクトリを作成します。 デフォルトでは、ComboBoxCellは、編集されていない場合はLabelとしてレンダリングされ、編集モードの場合はComboBoxとしてレンダリングされます。 ComboBoxは、デフォルトで、リスト・セル全体に表示するように拡大されます。

型パラメータ:

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

パラメータ:

converter - (型Tの)指定されたアイテムをユーザーに表示するために文字列に変換するStringConverter。

items - ComboBoxメニューが表示されるとユーザーに表示される0以上のアイテムを含むObservableList。 これらのアイテムはListViewアイテム・シーケンスと同じ型である必要があり、これにより、たとえば、選択時にitemsリストの既存値を置き換えます。

戻り値:

ListViewに含まれる要素の型で動作できるListCellを返す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を返します。

comboBoxEditableProperty

public final BooleanProperty comboBoxEditableProperty()

ユーザーに表示する場合にComboBoxを編集可能にするかどうかを表すプロパティ。

関連項目:

isComboBoxEditable()、setComboBoxEditable(boolean)

setComboBoxEditable

public final void setComboBoxEditable(boolean value)

ComboBoxを編集可能に構成します(オプション以外のユーザー入力をドロップダウン・リストに提供することを許可します)。

isComboBoxEditable

public final boolean isComboBoxEditable()

ComboBoxが編集可能な場合はtrueを返します。

getItems

public ObservableList<T> getItems()

ChoiceBoxが表示されているときにChoiceBoxに表示されるアイテムを返します。

startEdit

public void startEdit()

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

オーバーライド:

startEdit、クラスListCell<T>

cancelEdit

public void cancelEdit()

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

オーバーライド:

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