モジュール javafx.controls
パッケージ javafx.scene.control

クラスCheckBoxTreeItem<T>

  • 型パラメータ:
    T - TreeItemに含まれる値の型
    すべての実装されたインタフェース:
    EventTarget
    public class CheckBoxTreeItem<T>
extends TreeItem<T>
    選択、選択解除および不確定の各状態のサポートを追加するTreeItemサブクラス。 CheckBoxTreeCellが実装されたTreeViewと組み合せて使用すると役立ちます。

    CheckBoxTreeItemは、independentまたは依存になります。 デフォルトでは、CheckBoxTreeItemインスタンスは依存となります(TreeItemの選択状態に対するあらゆる変更が親および子のCheckBoxTreeItemインスタンスに影響することを意味します)。 CheckBoxTreeItemがindependentに設定されている場合は、CheckBoxTreeItemに対するあらゆる変更が、親および子のCheckBoxTreeItemインスタンスに直接影響しないことを意味します。

    indeterminateプロパティは、CheckBox.indeterminateProperty()での場合と同じ概念(つまり、CheckBoxは選択または選択解除のいずれでもない)を表すために使用されます。 これは、ブランチの子が(全部ではなく)一部選択されている場合に、TreeView内で一般的に使用されます。

    CheckBoxTreeItemクラスをCheckBoxTreeCellと一緒に使用する単純な例を次に示します。 

    
 // create the tree model
 CheckBoxTreeItem<String> jonathanGiles = new CheckBoxTreeItem<String>("Jonathan");
 CheckBoxTreeItem<String> juliaGiles = new CheckBoxTreeItem<String>("Julia");
 CheckBoxTreeItem<String> mattGiles = new CheckBoxTreeItem<String>("Matt");
 CheckBoxTreeItem<String> sueGiles = new CheckBoxTreeItem<String>("Sue");
 CheckBoxTreeItem<String> ianGiles = new CheckBoxTreeItem<String>("Ian");

 CheckBoxTreeItem<String> gilesFamily = new CheckBoxTreeItem<String>("Giles Family");
 gilesFamily.setExpanded(true);
 gilesFamily.getChildren().addAll(jonathanGiles, juliaGiles, mattGiles, sueGiles, ianGiles);

 // create the treeView
 final TreeView<String> treeView = new TreeView<String>();
 treeView.setRoot(gilesFamily);

 // set the cell factory
 treeView.setCellFactory(CheckBoxTreeCell.<String>forTreeView());
    導入されたバージョン:
    JavaFX 2.2
    関連項目:
    CheckBoxTreeCell、TreeItem、CheckBox

    • プロパティの詳細

      • selected

        public final BooleanProperty selectedProperty
        このCheckBoxTreeItemの選択された状態を表すために使用するBooleanProperty。
        戻り値:
        このCheckBoxTreeItemの選択された状態プロパティ

      • independent

        public final BooleanProperty independentProperty
        CheckBoxTreeItemの独立した状態を表すために使用するBooleanProperty。 不確定状態は、単一のCheckBoxTreeItemに対する変更がその親および子の状態に影響するかどうかを表すために使用されます。

        デフォルトでは、independentプロパティはfalseで、これは、CheckBoxTreeItemで状態がselectedプロパティまたはindeterminateプロパティに変更されると、関連するCheckBoxTreeItemsの状態が変更される可能性があることを示します。 independentプロパティがtrueに設定されている場合、関連するCheckBoxTreeItemの状態は変更されません。

        関連項目:
        isIndependent()、setIndependent(boolean)

    • コンストラクタの詳細

      • CheckBoxTreeItem

        public CheckBoxTreeItem()
        空のCheckBoxTreeItemを作成します。

      • CheckBoxTreeItem

        public CheckBoxTreeItem​(T value)
        valueプロパティを指定されたオブジェクトに設定して、CheckBoxTreeItemを作成します。
        パラメータ:
        value - このTreeItemの値として格納されるオブジェクト。

      • CheckBoxTreeItem

        public CheckBoxTreeItem​(T value,
                        Node graphic)
        valueプロパティを指定されたオブジェクトに設定し、graphicを指定されたノードに設定して、CheckBoxTreeItemを作成します。
        パラメータ:
        value - このCheckBoxTreeItemの値として格納されるオブジェクト。
        graphic - このCheckBoxTreeItemの横のTreeViewに表示するノード。

      • CheckBoxTreeItem

        public CheckBoxTreeItem​(T value,
                        Node graphic,
                        boolean selected)
        valueプロパティを指定されたオブジェクトに設定し、graphicを指定されたノードに設定し、selectedProperty()の初期状態を指定されたブール値に設定して、CheckBoxTreeItemを作成します。
        パラメータ:
        value - このCheckBoxTreeItemの値として格納されるオブジェクト。
        graphic - このCheckBoxTreeItemの横のTreeViewに表示するノード。
        selected - selectedプロパティの初期値。

      • CheckBoxTreeItem

        public CheckBoxTreeItem​(T value,
                        Node graphic,
                        boolean selected,
                        boolean independent)
        valueプロパティを指定されたオブジェクトに設定し、graphicを指定されたノードに設定し、selectedProperty()の初期状態を指定されたブール値に設定し、independentプロパティの初期状態を指定されたブール値に設定して、CheckBoxTreeItemを作成します。
        パラメータ:
        value - このCheckBoxTreeItemの値として格納されるオブジェクト。
        graphic - このCheckBoxTreeItemの横のTreeViewに表示するノード。
        selected - selectedプロパティの初期値。
        independent - independentプロパティの初期値。

    • メソッドの詳細

      • checkBoxSelectionChangedEvent

        public static <T> EventType<CheckBoxTreeItem.TreeModificationEvent<T>> checkBoxSelectionChangedEvent()
        CheckBoxTreeItemの選択/不確定状態が変更された場合に使用されるEventType。 これを使用する場合は、次の行とともにコードを使用することをお薦めします。 
         
 child1.addEventHandler(CheckBoxTreeItem.<String>checkBoxSelectionChangedEvent(), new EventHandler<TreeModificationEvent<String>>() {
     public void handle(TreeModificationEvent<String> event) {
          ...
     }
 });
        型パラメータ:
        T - TreeItemに含まれる値の型。
        戻り値:
        CheckBoxTreeItem選択 / 不確定状態が変化したときに使用されるEventType

      • setSelected

        public final void setSelected​(boolean value)
        このCheckBoxTreeItemの選択状態を設定します。
        パラメータ:
        value - このCheckBoxTreeItemの選択された状態

      • isSelected

        public final boolean isSelected()
        このCheckBoxTreeItemの選択状態を返します。
        戻り値:
        CheckBoxTreeItemが選択されている場合はtrue

      • selectedProperty

        public final BooleanProperty selectedProperty()
        このCheckBoxTreeItemの選択された状態を表すために使用するBooleanProperty。
        戻り値:
        このCheckBoxTreeItemの選択された状態プロパティ

      • setIndeterminate

        public final void setIndeterminate​(boolean value)
        このCheckBoxTreeItemの不確定状態を設定します。
        パラメータ:
        value - このCheckBoxTreeItemの不定状態

      • isIndeterminate

        public final boolean isIndeterminate()
        このCheckBoxTreeItemの不確定状態を返します。
        戻り値:
        CheckBoxTreeItemが不定状態の場合はtrue

      • independentProperty

        public final BooleanProperty independentProperty()
        CheckBoxTreeItemの独立した状態を表すために使用するBooleanProperty。 不確定状態は、単一のCheckBoxTreeItemに対する変更がその親および子の状態に影響するかどうかを表すために使用されます。

        デフォルトでは、independentプロパティはfalseで、これは、CheckBoxTreeItemで状態がselectedプロパティまたはindeterminateプロパティに変更されると、関連するCheckBoxTreeItemsの状態が変更される可能性があることを示します。 independentプロパティがtrueに設定されている場合、関連するCheckBoxTreeItemの状態は変更されません。

        関連項目:
        isIndependent()、setIndependent(boolean)

      • setIndependent

        public final void setIndependent​(boolean value)
        プロパティindependentの値を設定します。
        プロパティの説明:
        CheckBoxTreeItemの独立した状態を表すために使用するBooleanProperty。 不確定状態は、単一のCheckBoxTreeItemに対する変更がその親および子の状態に影響するかどうかを表すために使用されます。

        デフォルトでは、independentプロパティはfalseで、これは、CheckBoxTreeItemで状態がselectedプロパティまたはindeterminateプロパティに変更されると、関連するCheckBoxTreeItemsの状態が変更される可能性があることを示します。 independentプロパティがtrueに設定されている場合、関連するCheckBoxTreeItemの状態は変更されません。

      • isIndependent

        public final boolean isIndependent()
        プロパティindependentの値を取得します。
        プロパティの説明:
        CheckBoxTreeItemの独立した状態を表すために使用するBooleanProperty。 不確定状態は、単一のCheckBoxTreeItemに対する変更がその親および子の状態に影響するかどうかを表すために使用されます。

        デフォルトでは、independentプロパティはfalseで、これは、CheckBoxTreeItemで状態がselectedプロパティまたはindeterminateプロパティに変更されると、関連するCheckBoxTreeItemsの状態が変更される可能性があることを示します。 independentプロパティがtrueに設定されている場合、関連するCheckBoxTreeItemの状態は変更されません。