T
- このTreeViewのすべてのツリー・アイテムに対する、TreeItem
値プロパティ内に含まれるアイテムの型。@DefaultProperty(value="root") public class TreeView<T> extends Control
TreeItem
型)のビューを提供します。TreeViewを使用することによって、TreeItemに子がなくなる(つまりツリーのleafノード)まで再帰的にTreeItemの子にドリル・ダウンできます。これを容易にするために、ListView
のようなコントロールとは異なり、TreeViewではroot
ノードを指定することのみが必要になっています。
このアプローチを使用したツリーの構築の詳細は、TreeItem
クラスのドキュメントを参照してください。ただし、TreeViewを簡単に作成するには、次のようなことを実行する必要があります。
TreeItem<String> root = new TreeItem<String>("Root Node");
root.setExpanded(true);
root.getChildren().addAll(
new TreeItem<String>("Item 1"),
new TreeItem<String>("Item 2"),
new TreeItem<String>("Item 3")
);
TreeView<String> treeView = new TreeView<String>(root);
TreeViewは、オプションで、showRoot
プロパティをfalse
に設定して、ルート・ノードが非表示になるように構成できます。ルート・ノードが非表示になると、インデントのレベルが1つ減り、ルート・ノードのすべての子ノードが表示されます。デフォルトでは、TreeViewのルート・ノードは表示されます。
選択およびフォーカスを追跡するには、SelectionModel
クラスおよびFocusModel
クラスに習熟することが必要です。TreeViewには、selectionModel
とfocusModel
のプロパティからそれぞれ入手できる、これらのクラスのインスタンスを最大で1つずつ指定できます。このAPIを使用すると新しい選択モデルを設定できますが、ほとんどの場合は、デフォルトの選択モデルおよびフォーカス・モデルが機能するため、このことは必要ありません。
デフォルトのSelectionModel
は、TreeViewのインスタンス化がMultipleSelectionModel
抽象クラスの実装の場合に使用されます。ただし、selectionMode
プロパティのAPIドキュメントに示されているように、デフォルト値はSelectionMode.SINGLE
です。したがって、デフォルトのTreeViewインスタンスで複数選択を可能にするには、次のことを実行する必要があります。
treeView.getSelectionModel().setSelectionMode(SelectionMode.MULTIPLE);
TreeViewのビジュアルは、デフォルトのcell factory
を置換することで、全体的にカスタマイズできます。セル・ファクトリを使用して、TreeViewのアイテムを表すために使用できるTreeCell
インスタンスを生成できます。カスタム・セルを作成する方法の詳細は、Cell
クラスのドキュメントを参照してください。
このコントロールは値のインライン編集をサポートしており、このセクションでは使用可能なAPIの概要とその使用方法を示します。
まず、通常、セルを編集する場合は、セルを編集しないときとは異なるユーザー・インタフェースが必要となります。このことは、使用するCell
実装によって行います。TreeViewでは、このことはcell factory
によって行われます。セルを永続的に編集状態にするか(たとえば、このことはCheckBox
セルでは一般的です)、編集が開始されたとき(たとえば、セルでダブルクリックを受け取ったとき)に別のUIに切り替えるかは任意です。
セルに対する編集がいつリクエストされたかを知るには、単にCell.startEdit()
メソッドをオーバーライドし、セルのtext
プロパティおよびgraphic
プロパティを適切に更新します(たとえば、textをnullに設定し、graphicをTextField
に設定します)。また、編集が完了したときにUIを元の視覚的状態にリセットするようにCell.cancelEdit()
もオーバーライドします。どちらの場合も、スーパー・メソッドを呼び出して、編集モードを開始または終了するために必要なすべての作業をセルで実行するようにすることが重要です。
セルが編集状態になったら、次に、現在行っている編集をコミットまたは取り消す方法を確認しておきましょう。このことは、セル・ファクトリ・プロバイダとしてユーザーが行います。セル実装は、ユーザー入力に基づいて(たとえば、ユーザーがキーボードで[Enter]キーまたは[Esc]キーを押したとき)、編集の終了を認識します。このことが発生したときは、Cell.commitEdit(Object)
またはCell.cancelEdit()
を適切に呼び出す必要があります。
Cell.commitEdit(Object)
を呼び出すと、TreeViewに対してイベントが起動され、これはsetOnEditCommit(javafx.event.EventHandler)
を介してEventHandler
を追加することで監視できます。また、edit start
とedit cancel
の編集イベントを監視することもできます。
デフォルトでは、TreeViewの編集コミット・ハンドラはnull以外であり、デフォルトのハンドラでは、現在編集中の行のアイテムのプロパティ値を上書きすることを試みます。このことは、Cell.commitEdit(Object)
メソッドに新しい値が渡され、これが、起動されたTreeView.EditEvent
を介して編集コミット・ハンドラに渡されると、実行可能になります。これは単に、この値を取得するためのTreeView.EditEvent.getNewValue()
の呼出しの問題です。
setOnEditCommit(javafx.event.EventHandler)
を独自のEventHandler
とともに呼び出すと、デフォルトのハンドラが削除されることに注意することは非常に重要です。その後、プロパティ(または関連するデータ・ソース)へのライトバックを処理しないかぎり、何も実行されません。このことは、Node.addEventHandler(javafx.event.EventType, javafx.event.EventHandler)
メソッドを使用し、2番目の引数を目的のEventHandler
として、EDIT_COMMIT_EVENT
EventType
を追加することによって回避できます。このメソッドを使用すると、デフォルトの実装は置き換えられず、編集コミットが発生したときに通知されるようになります。
このサマリーでは、よくある質問に対して答えを示すことを意図しています。JavaFXには、かわりにすべての編集要件を処理する、数多くの事前作成のセル・ファクトリが付属しています。これらの事前作成のセル・ファクトリは、javafx.scene.control.cellパッケージにあります。
Type | プロパティと説明 |
---|---|
ObjectProperty<Callback<TreeView<T>,TreeCell<T>>> |
cellFactory
TreeViewのアイテムを表すために使用されるTreeCellを作成するために使用されるセル・ファクトリを表します。
|
BooleanProperty |
editable
このTreeViewが編集可能かどうかを指定します - TreeViewおよびその中のTreeCellが両方とも編集可能な場合にのみ、TreeCellが編集状態になります。
|
ReadOnlyObjectProperty<TreeItem<T>> |
editingItem
編集が発生している場合にTreeViewの現在編集されているTreeItemを表し、編集されているアイテムがない場合はnullを表すために使用されるプロパティ。
|
ReadOnlyIntegerProperty |
expandedItemCount
TreeViewに現在表示できるツリー・ノードの数を表します。
|
DoubleProperty |
fixedCellSize
このコントロールが指定された値の固定された高さであるセルを持つかどうかを指定します。
|
ObjectProperty<FocusModel<TreeItem<T>>> |
focusModel
FocusModelには、TreeViewで0または1行のフォーカスを制御できるAPIが用意されています。
|
ObjectProperty<EventHandler<TreeView.EditEvent<T>>> |
onEditCancel
このイベント・ハンドラは、ユーザーがセルの編集を取り消すと起動されます。
|
ObjectProperty<EventHandler<TreeView.EditEvent<T>>> |
onEditCommit
このプロパティは、編集入力が永続化されるアクションをユーザーが実行すると使用されます。
|
ObjectProperty<EventHandler<TreeView.EditEvent<T>>> |
onEditStart
このイベント・ハンドラは、ユーザーが編集を正常に開始すると起動されます。
|
ObjectProperty<EventHandler<ScrollToEvent<Integer>>> |
onScrollTo
scrollTo(int) を使用してビューのインデックスをスクロールするリクエストがある場合に呼び出されます。 |
ObjectProperty<TreeItem<T>> |
root
TreeViewのルート・ノードを表すプロパティ。
|
ObjectProperty<MultipleSelectionModel<TreeItem<T>>> |
selectionModel
SelectionModelには、TreeView内の1つまたは複数のアイテムを選択でき、ユーザーがどの行を選択したかを調べることもできるAPIが用意されています。
|
BooleanProperty |
showRoot
TreeViewルート・ノードが表示可能であるかどうかを表すプロパティ。
|
contextMenu、skin、tooltip
background、border、cacheShape、centerShape、height、insets、maxHeight、maxWidth、minHeight、minWidth、opaqueInsets、padding、prefHeight、prefWidth、scaleShape、shape、snapToPixel、width
needsLayout
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
修飾子と型 | クラスと説明 |
---|---|
static class |
TreeView.EditEvent<T>
編集関連イベントを表すために特にTreeViewで使用される
Event サブクラス。 |
USE_COMPUTED_SIZE、USE_PREF_SIZE
BASELINE_OFFSET_SAME_AS_HEIGHT
コンストラクタと説明 |
---|
TreeView()
空のTreeViewを作成します。
|
TreeView(TreeItem<T> root)
指定されたルート・ノードを使用してTreeViewを作成します。
|
修飾子と型 | メソッドと説明 |
---|---|
ObjectProperty<Callback<TreeView<T>,TreeCell<T>>> |
cellFactoryProperty()
TreeViewのアイテムを表すために使用されるTreeCellを作成するために使用されるセル・ファクトリを表します。
|
protected Skin<?> |
createDefaultSkin()
このコントロールのデフォルト・スキンの新しいインスタンスを作成します。
|
void |
edit(TreeItem<T> item)
TreeViewが
editable の場合に、指定されたTreeItemの編集の開始をそのTreeViewに指示します。 |
BooleanProperty |
editableProperty()
このTreeViewが編集可能かどうかを指定します - TreeViewおよびその中のTreeCellが両方とも編集可能な場合にのみ、TreeCellが編集状態になります。
|
static <T> EventType<TreeView.EditEvent<T>> |
editAnyEvent()
なんらかの編集イベントが発生したことを示すEventType。
|
static <T> EventType<TreeView.EditEvent<T>> |
editCancelEvent()
TreeViewに対して起動された編集イベントが取り消されたことを示すEventType。
|
static <T> EventType<TreeView.EditEvent<T>> |
editCommitEvent()
TreeViewの編集がコミットされたことを示すEventType。
|
ReadOnlyObjectProperty<TreeItem<T>> |
editingItemProperty()
編集が発生している場合にTreeViewの現在編集されているTreeItemを表し、編集されているアイテムがない場合はnullを表すために使用されるプロパティ。
|
static <T> EventType<TreeView.EditEvent<T>> |
editStartEvent()
TreeViewに対して起動された編集イベントが開始されたことを示すEventType。
|
ReadOnlyIntegerProperty |
expandedItemCountProperty()
TreeViewに現在表示できるツリー・ノードの数を表します。
|
DoubleProperty |
fixedCellSizeProperty()
このコントロールが指定された値の固定された高さであるセルを持つかどうかを指定します。
|
ObjectProperty<FocusModel<TreeItem<T>>> |
focusModelProperty()
FocusModelには、TreeViewで0または1行のフォーカスを制御できるAPIが用意されています。
|
Callback<TreeView<T>,TreeCell<T>> |
getCellFactory()
TreeViewのアイテムを表すために使用されるTreeCellを作成するために使用されるセル・ファクトリを返すか、またはカスタム・セル・ファクトリが設定されていない場合にはnullを返します。
|
static List<CssMetaData<? extends Styleable,?>> |
getClassCssMetaData() |
List<CssMetaData<? extends Styleable,?>> |
getControlCssMetaData() |
TreeItem<T> |
getEditingItem()
TreeViewで現在編集されているTreeItemを返すか、編集されているアイテムがない場合はnullを返します。
|
int |
getExpandedItemCount()
プロパティexpandedItemCountの値を取得します。
|
double |
getFixedCellSize()
固定セル・サイズ値を返します。
|
FocusModel<TreeItem<T>> |
getFocusModel()
現在インストールされている
FocusModel を返します。 |
static int |
getNodeLevel(TreeItem<?> node)
非推奨。
このメソッドでは、指定されたTreeItemからTreeViewのルートまでの距離が正しく計算されません。JavaFX 8.0_20では、これを行う適切な方法は、
getTreeItemLevel(TreeItem) を使用することです。 |
EventHandler<TreeView.EditEvent<T>> |
getOnEditCancel()
ユーザーが編集を取り消したときに呼び出される
EventHandler を返します。 |
EventHandler<TreeView.EditEvent<T>> |
getOnEditCommit()
ユーザーが編集をコミットしたときに呼び出される
EventHandler を返します。 |
EventHandler<TreeView.EditEvent<T>> |
getOnEditStart()
ユーザーが編集を開始したときに呼び出される
EventHandler を返します。 |
EventHandler<ScrollToEvent<Integer>> |
getOnScrollTo()
プロパティonScrollToの値を取得します。
|
TreeItem<T> |
getRoot()
このTreeViewの現在のルート・ノードを返すか、ルート・ノードが指定されていない場合はnullを返します。
|
int |
getRow(TreeItem<T> item)
各TreeItemの現在の状態を考慮して、指定されたTreeItemのインデックス位置を返します。
|
MultipleSelectionModel<TreeItem<T>> |
getSelectionModel()
現在インストールされている選択モデルを返します。
|
TreeItem<T> |
getTreeItem(int row)
指定されたインデックスのTreeItemを返すか、範囲外である場合はnullを返します。
|
int |
getTreeItemLevel(TreeItem<?> node)
getParent()を再帰的に呼び出すことができる回数に基づいて、指定されたTreeItemのインデントのレベル数を返します。
|
boolean |
isEditable()
プロパティeditableの値を取得します。
|
boolean |
isShowRoot()
TreeViewのルートが表示される場合はtrue、されない場合はfalseを返します。
|
protected void |
layoutChildren()
この
Parent の子をレイアウトするレイアウト・パス中に起動されます。 |
ObjectProperty<EventHandler<TreeView.EditEvent<T>>> |
onEditCancelProperty()
このイベント・ハンドラは、ユーザーがセルの編集を取り消すと起動されます。
|
ObjectProperty<EventHandler<TreeView.EditEvent<T>>> |
onEditCommitProperty()
このプロパティは、編集入力が永続化されるアクションをユーザーが実行すると使用されます。
|
ObjectProperty<EventHandler<TreeView.EditEvent<T>>> |
onEditStartProperty()
このイベント・ハンドラは、ユーザーが編集を正常に開始すると起動されます。
|
ObjectProperty<EventHandler<ScrollToEvent<Integer>>> |
onScrollToProperty()
scrollTo(int) を使用してビューのインデックスをスクロールするリクエストがある場合に呼び出されます。 |
Object |
queryAccessibleAttribute(AccessibleAttribute attribute, Object... parameters)
*アクセシビリティ処理* *
|
ObjectProperty<TreeItem<T>> |
rootProperty()
TreeViewのルート・ノードを表すプロパティ。
|
void |
scrollTo(int index)
特定のインデックスのアイテムがエンド・ユーザーに表示されるように、TreeViewをスクロールします。
|
ObjectProperty<MultipleSelectionModel<TreeItem<T>>> |
selectionModelProperty()
SelectionModelには、TreeView内の1つまたは複数のアイテムを選択でき、ユーザーがどの行を選択したかを調べることもできるAPIが用意されています。
|
void |
setCellFactory(Callback<TreeView<T>,TreeCell<T>> value)
TreeViewのアイテムを表すために使用されるTreeCellを作成するために使用されるセル・ファクトリを設定します。
|
void |
setEditable(boolean value)
プロパティeditableの値を設定します。
|
void |
setFixedCellSize(double value)
このコントロールの新しい固定セル・サイズを設定します。
|
void |
setFocusModel(FocusModel<TreeItem<T>> value)
TreeViewで使用する
FocusModel を設定します。 |
void |
setOnEditCancel(EventHandler<TreeView.EditEvent<T>> value)
ユーザーが編集を取り消したときに呼び出される
EventHandler を設定します。 |
void |
setOnEditCommit(EventHandler<TreeView.EditEvent<T>> value)
ユーザーが編集をコミットしたときに呼び出される
EventHandler を設定します。 |
void |
setOnEditStart(EventHandler<TreeView.EditEvent<T>> value)
ユーザーが編集を開始したときに呼び出される
EventHandler を設定します。 |
void |
setOnScrollTo(EventHandler<ScrollToEvent<Integer>> value)
プロパティonScrollToの値を設定します。
|
void |
setRoot(TreeItem<T> value)
このTreeViewのルート・ノードを設定します。
|
void |
setSelectionModel(MultipleSelectionModel<TreeItem<T>> value)
TreeViewで使用する
MultipleSelectionModel を設定します。 |
void |
setShowRoot(boolean value)
ルート
TreeItem がこのTreeView内で表示されるかどうかを指定します。 |
BooleanProperty |
showRootProperty()
TreeViewルート・ノードが表示可能であるかどうかを表すプロパティ。
|
computeMaxHeight、computeMaxWidth、computeMinHeight、computeMinWidth、computePrefHeight、computePrefWidth、contextMenuProperty、executeAccessibleAction、getBaselineOffset、getContextMenu、getCssMetaData、getSkin、getTooltip、isResizable、setContextMenu、setSkin、setTooltip、skinProperty、tooltipProperty
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
getChildren、getChildrenUnmodifiable、getManagedChildren、getStylesheets、isNeedsLayout、layout、lookup、needsLayoutProperty、requestLayout、requestParentLayout、setNeedsLayout、updateBounds
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、getContentBias、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、toString、translateXProperty、translateYProperty、translateZProperty、usesMirroring、visibleProperty
public final ObjectProperty<Callback<TreeView<T>,TreeCell<T>>> cellFactoryProperty
public final ObjectProperty<TreeItem<T>> rootProperty
getRoot()
、setRoot(TreeItem)
public final BooleanProperty showRootProperty
public final ObjectProperty<MultipleSelectionModel<TreeItem<T>>> selectionModelProperty
public final ObjectProperty<FocusModel<TreeItem<T>>> focusModelProperty
public final ReadOnlyIntegerProperty expandedItemCountProperty
TreeViewに現在表示できるツリー・ノードの数を表します。これは基本的に、すべての展開されたツリー・アイテムとその子の数です。
たとえば、ルート・ノードのみが表示されている場合は、expandedItemCountは1になります。ルートに3つの子があり、ルートが展開されていた場合は、値は4になります。
getExpandedItemCount()
public final DoubleProperty fixedCellSizeProperty
CSSでこのプロパティを設定するには、-fx-fixed-cell-sizeプロパティを使用します。これを-fx-cell-sizeプロパティと混同しないでください。この2つのCSSプロパティ間の違いは、-fx-cell-sizeではすべてのセルを指定されたサイズに設定しますが、これが唯一のサイズとはならないことです(このため、可変セル・サイズが許容され、パフォーマンスの向上を妨げる可能性があります)。このため、パフォーマンスを重視する場合は、-fx-cell-sizeではなく-fx-fixed-cell-sizeを使用してください。CSSに両方のプロパティを指定した場合は、-fx-fixed-cell-sizeが優先されます。
getFixedCellSize()
、setFixedCellSize(double)
public final BooleanProperty editableProperty
public final ReadOnlyObjectProperty<TreeItem<T>> editingItemProperty
編集が発生している場合にTreeViewの現在編集されているTreeItemを表し、編集されているアイテムがない場合はnullを表すために使用されるプロパティ。
編集アイテムは設定できず、かわりにedit(javafx.scene.control.TreeItem)
を呼び出す必要があります。
getEditingItem()
public final ObjectProperty<EventHandler<TreeView.EditEvent<T>>> onEditStartProperty
public final ObjectProperty<EventHandler<TreeView.EditEvent<T>>> onEditCommitProperty
このプロパティは、編集入力が永続化されるアクションをユーザーが実行すると使用されます。
このプロパティのEventHandlerを直接呼び出すことはできません。かわりにカスタムのTreeCell内からTreeCell.commitEdit(java.lang.Object)
を呼び出してください。これは、このイベントの作成、ビューの更新および編集状態の切替えを処理します。
public final ObjectProperty<EventHandler<TreeView.EditEvent<T>>> onEditCancelProperty
public ObjectProperty<EventHandler<ScrollToEvent<Integer>>> onScrollToProperty
scrollTo(int)
を使用してビューのインデックスをスクロールするリクエストがある場合に呼び出されます。getOnScrollTo()
、setOnScrollTo(EventHandler)
public TreeView()
その他のプロパティのデフォルトの状態の詳細は、TreeView
クラスのドキュメントを参照してください。
public static <T> EventType<TreeView.EditEvent<T>> editAnyEvent()
editStartEvent()
、editCommitEvent()
およびeditCancelEvent()
)の親タイプです。public static <T> EventType<TreeView.EditEvent<T>> editStartEvent()
public static <T> EventType<TreeView.EditEvent<T>> editCancelEvent()
public static <T> EventType<TreeView.EditEvent<T>> editCommitEvent()
@Deprecated public static int getNodeLevel(TreeItem<?> node)
getTreeItemLevel(TreeItem)
を使用することです。TreeItem.getParent()
を再帰的に呼び出すことができる回数に基づいて、特定のTreeItemのインデントのレベル数を返します。TreeItemに親セットがない場合は、返される値はゼロになります。getParent()が再帰的に呼び出されるたびに、返される値が1つずつ増えていきます。
重要な注意: このメソッドはルート・ノードを考慮しないため、それは非推奨です。これは、ルート・ノードに親がある場合に、このメソッドがTreeViewコントロールのルート・ノードを超えて繰り返されることを意味します。このことが重要である場合は、かわりにgetTreeItemLevel(TreeItem)
を呼び出します。
node
- レベルが必要なTreeItem。public final void setCellFactory(Callback<TreeView<T>,TreeCell<T>> value)
詳細は、Cell
クラスのドキュメントを参照してください。
value
- TreeCellインスタンスの生成に使用するCallback
、またはデフォルトのセル・ファクトリが使用される場合はnull。public final Callback<TreeView<T>,TreeCell<T>> getCellFactory()
TreeViewのアイテムを表すために使用されるTreeCellを作成するために使用されるセル・ファクトリを返すか、またはカスタム・セル・ファクトリが設定されていない場合にはnullを返します。
public final ObjectProperty<Callback<TreeView<T>,TreeCell<T>>> cellFactoryProperty()
public final void setRoot(TreeItem<T> value)
TreeItem
クラス・レベルのドキュメントを参照してください。value
- TreeViewのルートに配置されるTreeItem
。public final TreeItem<T> getRoot()
public final ObjectProperty<TreeItem<T>> rootProperty()
getRoot()
、setRoot(TreeItem)
public final void setShowRoot(boolean value)
TreeItem
がこのTreeView内で表示されるかどうかを指定します。value
- trueの場合はルートTreeItemが表示され、falseの場合はそれが非表示になります。public final boolean isShowRoot()
public final BooleanProperty showRootProperty()
public final void setSelectionModel(MultipleSelectionModel<TreeItem<T>> value)
MultipleSelectionModel
を設定します。MultipleSelectionModel
を必要とするTreeViewでも、単一選択のみが許可されるように設定できます(詳細は、MultipleSelectionModel.setSelectionMode(javafx.scene.control.SelectionMode)
を参照)。public final MultipleSelectionModel<TreeItem<T>> getSelectionModel()
public final ObjectProperty<MultipleSelectionModel<TreeItem<T>>> selectionModelProperty()
public final void setFocusModel(FocusModel<TreeItem<T>> value)
FocusModel
を設定します。public final FocusModel<TreeItem<T>> getFocusModel()
FocusModel
を返します。public final ObjectProperty<FocusModel<TreeItem<T>>> focusModelProperty()
public final ReadOnlyIntegerProperty expandedItemCountProperty()
TreeViewに現在表示できるツリー・ノードの数を表します。これは基本的に、すべての展開されたツリー・アイテムとその子の数です。
たとえば、ルート・ノードのみが表示されている場合は、expandedItemCountは1になります。ルートに3つの子があり、ルートが展開されていた場合は、値は4になります。
getExpandedItemCount()
public final int getExpandedItemCount()
TreeViewに現在表示できるツリー・ノードの数を表します。これは基本的に、すべての展開されたツリー・アイテムとその子の数です。
たとえば、ルート・ノードのみが表示されている場合は、expandedItemCountは1になります。ルートに3つの子があり、ルートが展開されていた場合は、値は4になります。
public final void setFixedCellSize(double value)
value
- 新しい固定セル・サイズ値。無効にするには、ゼロ以下の値(または、Region.USE_COMPUTED_SIZE)にします。public final double getFixedCellSize()
public final DoubleProperty fixedCellSizeProperty()
CSSでこのプロパティを設定するには、-fx-fixed-cell-sizeプロパティを使用します。これを-fx-cell-sizeプロパティと混同しないでください。この2つのCSSプロパティ間の違いは、-fx-cell-sizeではすべてのセルを指定されたサイズに設定しますが、これが唯一のサイズとはならないことです(このため、可変セル・サイズが許容され、パフォーマンスの向上を妨げる可能性があります)。このため、パフォーマンスを重視する場合は、-fx-cell-sizeではなく-fx-fixed-cell-sizeを使用してください。CSSに両方のプロパティを指定した場合は、-fx-fixed-cell-sizeが優先されます。
getFixedCellSize()
、setFixedCellSize(double)
public final void setEditable(boolean value)
public final boolean isEditable()
public final BooleanProperty editableProperty()
public final TreeItem<T> getEditingItem()
public final ReadOnlyObjectProperty<TreeItem<T>> editingItemProperty()
編集が発生している場合にTreeViewの現在編集されているTreeItemを表し、編集されているアイテムがない場合はnullを表すために使用されるプロパティ。
編集アイテムは設定できず、かわりにedit(javafx.scene.control.TreeItem)
を呼び出す必要があります。
getEditingItem()
public final void setOnEditStart(EventHandler<TreeView.EditEvent<T>> value)
EventHandler
を設定します。public final EventHandler<TreeView.EditEvent<T>> getOnEditStart()
EventHandler
を返します。public final ObjectProperty<EventHandler<TreeView.EditEvent<T>>> onEditStartProperty()
public final void setOnEditCommit(EventHandler<TreeView.EditEvent<T>> value)
EventHandler
を設定します。public final EventHandler<TreeView.EditEvent<T>> getOnEditCommit()
EventHandler
を返します。public final ObjectProperty<EventHandler<TreeView.EditEvent<T>>> onEditCommitProperty()
このプロパティは、編集入力が永続化されるアクションをユーザーが実行すると使用されます。
このプロパティのEventHandlerを直接呼び出すことはできません。かわりにカスタムのTreeCell内からTreeCell.commitEdit(java.lang.Object)
を呼び出してください。これは、このイベントの作成、ビューの更新および編集状態の切替えを処理します。
public final void setOnEditCancel(EventHandler<TreeView.EditEvent<T>> value)
EventHandler
を設定します。public final EventHandler<TreeView.EditEvent<T>> getOnEditCancel()
EventHandler
を返します。public final ObjectProperty<EventHandler<TreeView.EditEvent<T>>> onEditCancelProperty()
protected void layoutChildren()
Parent
の子をレイアウトするレイアウト・パス中に起動されます。デフォルトでは、管理対象のサイズ変更可能なコンテンツのサイズをその優先サイズに合せて設定するのみで、ノードの配置は行われません。
サブクラスは必要に応じてこの関数をオーバーライドし、コンテンツをレイアウトする必要があります。
layoutChildren
、クラス: Control
public void edit(TreeItem<T> item)
editable
の場合に、指定されたTreeItemの編集の開始をそのTreeViewに指示します。このメソッドが呼び出されると、現在のcell factory
が編集をサポートするように設定されている場合は、セルでその視覚的状態が切り替わり、ユーザー入力を実行できるようになります。item
- 編集するTreeViewのTreeItem。public void scrollTo(int index)
index
- ユーザーに表示されるようにするインデックス。0以上で、TreeViewの表示可能なアイテムの数未満であることを想定しています。public void setOnScrollTo(EventHandler<ScrollToEvent<Integer>> value)
scrollTo(int)
を使用してビューのインデックスをスクロールするリクエストがある場合に呼び出されます。public EventHandler<ScrollToEvent<Integer>> getOnScrollTo()
scrollTo(int)
を使用してビューのインデックスをスクロールするリクエストがある場合に呼び出されます。public ObjectProperty<EventHandler<ScrollToEvent<Integer>>> onScrollToProperty()
scrollTo(int)
を使用してビューのインデックスをスクロールするリクエストがある場合に呼び出されます。getOnScrollTo()
、setOnScrollTo(EventHandler)
public int getRow(TreeItem<T> item)
item
- インデックスが検索されるTreeItem。public TreeItem<T> getTreeItem(int row)
row
- 検索されているTreeItemのインデックス。public int getTreeItemLevel(TreeItem<?> node)
node
- レベルが必要なTreeItem。protected Skin<?> createDefaultSkin()
-fx-skin
を介してスキンが提供されていない場合にコントロール用のスキンを作成するために、またはsetSkin(...)
を使用してサブクラスで明示的に設定するために呼び出されます。createDefaultSkin
、クラス: Control
public static List<CssMetaData<? extends Styleable,?>> getClassCssMetaData()
public List<CssMetaData<? extends Styleable,?>> getControlCssMetaData()
getControlCssMetaData
、クラス: Control
public Object queryAccessibleAttribute(AccessibleAttribute attribute, Object... parameters)
queryAccessibleAttribute
、クラス: Control
attribute
- リクエストされた属性parameters
- オプションのパラメータ・リストAccessibleAttribute
Copyright (c) 2008, 2015, Oracle and/or its affiliates. All rights reserved.