JavaTM 2 Platform
Std. Ed. v1.3

javax.swing
クラス JTree

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.Container
              |
              +--javax.swing.JComponent
                    |
                    +--javax.swing.JTree
すべての実装インタフェース:
Accessible, ImageObserver, MenuContainer, Scrollable, Serializable

public class JTree
extends JComponent
implements Scrollable, Accessible

階層データのセットをアウトラインで表示するコントロールです。タスク指向のマニュアルおよびツリーの使用例については、「The Java Tutorial」 のセクション 「How to Use Trees」を参照してください。

ツリーの特定のノードは、ノードおよびすべての上位ノードをカプセル化するオブジェクトである TreePath または、表示領域の各行が 1 つのノードを表示する表示行により識別されます。「展開された」ノードはその子を表示します。「収納された」 ノードは子を隠します。「隠された」ノードは収納された親の下にあります。すべての「表示可能」ノードの親は展開されますが表示される場合とされない場合があります。「表示」ノードは表示可能であり、表示領域にあります。

次の JTree メソッドは「visible」を使用して「displayed」を表します。

JTree の次のメソッドは「visible」を使用して「viewable」を表します (展開された親の下)。

いつ選択が変更されたかを知りたい場合は、TreeSelectionListener インタフェースを実装し、addTreeSelectionListener メソッドを使用してそのインタフェースを追加します。valueChanged は、選択が変更されたときに呼び出されます。つまり、ユーザが同じノードを 2 回クリックしたときに valueChanged は一度だけ呼び出されます。

ノードが選択されていたかどうかにかかわらず、ダブルクリックイベントまたはユーザがノードをクリックしたときを知りたい場合は、次のようにします。

 final JTree tree = ...;

 MouseListener ml = new MouseAdapter() {
     public void mousePressed(MouseEvent e) {
         int selRow = tree.getRowForLocation(e.getX(), e.getY());
         TreePath selPath = tree.getPathForLocation(e.getX(), e.getY());
         if(selRow != -1) {
             if(e.getClickCount() == 1) {
                 mySingleClick(selRow, selPath);
             }
             else if(e.getClickCount() == 2) {
                 myDoubleClick(selRow, selPath);
             }
         }
     }
 };
 tree.addMouseListener(ml);
注: この例はパスと行の両方を取得しますが、必要な方だけを取得してください。

JTree を使用して複合ノード (たとえば、グラフィックアイコンおよびテキストの両方を持つノード) を表示するには、TreeCellRenderer をサブクラス化し、setCellRenderer(javax.swing.tree.TreeCellRenderer) を使用してツリーにそれを使用することを指示します。複合ノードを編集するには、TreeCellEditor をサブクラス化し、setCellEditor(javax.swing.tree.TreeCellEditor) を使用します。

すべての JComponent クラスと同様、InputMapActionMap を使用して Action オブジェクトと KeyStroke を関連付け、指定した条件でアクションを実行できます。

標準の Look & Feel (L&F) 表現でこのコンポーネントが使用するキーボードのキーについては、JTree のキーの割り当てを参照してください。

警告: このクラスの直列化されたオブジェクトは、今後の Swing リリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の運用や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。今後の Swing リリースでは、長期間の持続性をサポートする予定です。

関連項目:
直列化された形式

内部クラスの概要
protected  class JTree.AccessibleJTree
          このクラスは JTree クラス用のユーザ補助機能のサポートを実装しています。
static class JTree.DynamicUtilTreeNode
          DynamicUtilTreeNode は、ベクタ、ハッシュテーブル、配列、および文字列をラップし、必要に応じて適切な子ツリーノードを作成できます。
protected static class JTree.EmptySelectionModel
          EmptySelectionModel は、何の選択も許可しない TreeSelectionModel です。
protected  class JTree.TreeModelHandler
          モデルを監視し、ノードが削除または変更された場合にそれに応じてexpandedState を更新します。
protected  class JTree.TreeSelectionRedirector
          JTree をソースとして新しい TreeSelectionEvent を生成し、それをすべてのリスナーに転送します。
 
クラス javax.swing.JComponent から継承した内部クラス
JComponent.AccessibleJComponent
 
クラス java.awt.Container から継承した内部クラス
Container.AccessibleAWTContainer
 
クラス java.awt.Component から継承した内部クラス
Component.AccessibleAWTComponent
 
フィールドの概要
static String ANCHOR_SELECTION_PATH_PROPERTY
          アンカー選択パスのバウンドプロパティ名です。
static String CELL_EDITOR_PROPERTY
          cellEditor のバウンドプロパティ名です。
static String CELL_RENDERER_PROPERTY
          cellRenderer のバウンドプロパティ名です。
protected  TreeCellEditor cellEditor
          エントリのエディタです。
protected  TreeCellRenderer cellRenderer
          ノードを描画するために使用されるセルです。
protected  boolean editable
          ツリーが編集できるかどうかを示します。
static String EDITABLE_PROPERTY
          editable のバウンドプロパティ名です。
static String EXPANDS_SELECTED_PATHS_PROPERTY
          選択パスのプロパティを展開するバウンドプロパティ名です。
static String INVOKES_STOP_CELL_EDITING_PROPERTY
          messagesStopCellEditing のバウンドプロパティ名です。
protected  boolean invokesStopCellEditing
          true の場合、選択の変更、ツリー内のデータの変更、またはほかの手段によって編集が停止されたときに、stopCellEditing が呼び出され、変更が保存されます。
static String LARGE_MODEL_PROPERTY
          largeModel のバウンドプロパティ名です。
protected  boolean largeModel
          このツリーが大きなモデルかどうかを示します。
static String LEAD_SELECTION_PATH_PROPERTY
          leadSelectionPath のバウンドプロパティ名です。
static String ROOT_VISIBLE_PROPERTY
          rootVisible のバウンドプロパティ名です。
protected  boolean rootVisible
          ルートノードが表示されている場合は true、その子が最上位の可視ノードである場合は false です。
static String ROW_HEIGHT_PROPERTY
          rowHeight のバウンドプロパティ名です。
protected  int rowHeight
          各表示行に使用する高さです。
static String SCROLLS_ON_EXPAND_PROPERTY
          scrollsOnExpand のバウンドプロパティ名です。
protected  boolean scrollsOnExpand
          true の場合、ノードが展開されると、そのすべての下位ノードが可視になるようにスクロールされます。
static String SELECTION_MODEL_PROPERTY
          selectionModel のバウンドプロパティ名です。
protected  TreeSelectionModel selectionModel
          このツリー内の選択されたノードのセットをモデル化します。
protected  JTree.TreeSelectionRedirector selectionRedirector
          新しいイベントを生成し、それを selectionListeners に渡します。
static String SHOWS_ROOT_HANDLES_PROPERTY
          showsRootHandles のバウンドプロパティ名です。
protected  boolean showsRootHandles
          ハンドルがツリーの最上位レベルに表示されている場合は true です。
static String TOGGLE_CLICK_COUNT_PROPERTY
          toggleClickCount のバウンドプロパティ名です。
protected  int toggleClickCount
          ノードを展開するために必要なマウスクリックの数です。
static String TREE_MODEL_PROPERTY
          treeModel のバウンドプロパティ名です。
protected  TreeModel treeModel
          このオブジェクトによって表示されるツリーを定義するモデルです。
protected  TreeModelListener treeModelListener
          expandedState を更新します。
static String VISIBLE_ROW_COUNT_PROPERTY
          visibleRowCount のバウンドプロパティ名です。
protected  int visibleRowCount
          一度に可視にする行数です。
 
クラス javax.swing.JComponent から継承したフィールド
accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
 
クラス java.awt.Component から継承したフィールド
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
 
インタフェース java.awt.image.ImageObserver から継承したフィールド
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
 
コンストラクタの概要
JTree()
          サンプルモデルを持つ JTree を返します。
JTree(Hashtable value)
          Hashtable から生成された、ルートを表示しない JTree を返します。
JTree(Object[] value)
          指定された配列の各要素を、表示されていない新しいルートノードの子として持つ JTree を返します。
JTree(TreeModel newModel)
          ルートノードを表示する JTree のインスタンスを返します。
JTree(TreeNode root)
          指定された TreeNode をルートに持つ、ルートノードを表示する JTree を返します。
JTree(TreeNode root, boolean asksAllowsChildren)
          ルートノードを表示し、ノードが葉ノードかどうかを指定された方法で決める、指定された TreeNode をルートとして持つ JTree を返します。
JTree(Vector value)
          指定された Vector の各要素を、表示されていない新しいルートノードの子として持つ JTree を返します。
 
メソッドの概要
 void addSelectionInterval(int index0, int index1)
          index0 から index1 までのパスを選択に追加します。
 void addSelectionPath(TreePath path)
          指定された TreePath によって識別されるノードを現在の選択に追加します。
 void addSelectionPaths(TreePath[] paths)
          パスの配列の各パスを現在の選択に追加します。
 void addSelectionRow(int row)
          指定された行にあるパスを現在の選択に追加します。
 void addSelectionRows(int[] rows)
          指定された各行にあるパスを現在の選択に追加します。
 void addTreeExpansionListener(TreeExpansionListener tel)
          TreeExpansion イベントのリスナーを追加します。
 void addTreeSelectionListener(TreeSelectionListener tsl)
          TreeSelection イベントのリスナーを追加します。
 void addTreeWillExpandListener(TreeWillExpandListener tel)
          TreeWillExpand イベントのリスナーを追加します。
 void cancelEditing()
          現在の編集セッションを取り消します。
 void clearSelection()
          選択をクリアします。
protected  void clearToggledPaths()
          切り替えられたツリーパスのキャッシュをクリアします。
 void collapsePath(TreePath path)
          指定されたパスによって識別されるノードが収納され、表示可能になるようにします。
 void collapseRow(int row)
          指定された行にあるノードが収納されているようにします。
 String convertValueToText(Object value, boolean selected, boolean expanded, boolean leaf, int row, boolean hasFocus)
          レンダリングによって呼び出され、指定された値をテキストに変換します。
protected static TreeModel createTreeModel(Object value)
          指定されたオブジェクトをラップする TreeModel を返します。
protected  TreeModelListener createTreeModelListener()
          TreeModelHandler のインスタンスを生成して返します。
 void expandPath(TreePath path)
          指定されたパスによって識別されるノードが展開され、表示可能になるようにします。
 void expandRow(int row)
          指定された行にあるノードが展開され、表示可能になるようにします。
 void fireTreeCollapsed(TreePath path)
          このイベントタイプの通知を受けるように登録されたすべてのリスナーに通知します。
 void fireTreeExpanded(TreePath path)
          このイベントタイプへの通知を配信対象に登録しているリスナーすべてに通知します。
 void fireTreeWillCollapse(TreePath path)
          このイベントタイプの通知を受けるように登録されたすべてのリスナーに通知します。
 void fireTreeWillExpand(TreePath path)
          このイベントタイプの通知を受けるように登録されたすべてのリスナーに通知します。
protected  void fireValueChanged(TreeSelectionEvent e)
          このイベントタイプの通知を配信対象として登録しているリスナーすべてに通知します。
 AccessibleContext getAccessibleContext()
          この JTree に関連した AccessibleContext を返します。
 TreePath getAnchorSelectionPath()
          アンカーと識別されたパスを返します。
 TreeCellEditor getCellEditor()
          ツリーのエントリを編集するために使用されるエディタを返します。
 TreeCellRenderer getCellRenderer()
          各セルを描画している現在の TreeCellRenderer を返します。
 TreePath getClosestPathForLocation(int x, int y)
          x、y にもっとも近いノードのパスを返します。
 int getClosestRowForLocation(int x, int y)
          x、y にもっとも近いノードの行を返します。
protected static TreeModel getDefaultTreeModel()
          サンプル TreeModel を生成し、それを返します。
protected  Enumeration getDescendantToggledPaths(TreePath parent)
          parent の下位ノードであり、展開されている TreePathsEnumeration を返します。
 TreePath getEditingPath()
          現在編集されている要素のパスを返します。
 Enumeration getExpandedDescendants(TreePath parent)
          現在展開されているパス parent の下位ノードから成る Enumeration を返します。
 boolean getExpandsSelectedPaths()
          expandsSelectedPaths プロパティを返します。
 boolean getInvokesStopCellEditing()
          編集が割り込まれたときに何をするかを示すインジケータを返します。
 Object getLastSelectedPathComponent()
          現在の選択の最初のノードにある最後のパスコンポーネントを返します。
 TreePath getLeadSelectionPath()
          リードと識別されたパスを返します。
 int getLeadSelectionRow()
          リードパスに対応する行のインデックスを返します。
 int getMaxSelectionRow()
          選択されている最後の行を返します。
 int getMinSelectionRow()
          選択されている最初の行を返します。
 TreeModel getModel()
          データを提供している TreeModel を返します。
protected  TreePath[] getPathBetweenRows(int index0, int index1)
          index0 から index1 までのパスを表す JTreePath のインスタンスを返します。
 Rectangle getPathBounds(TreePath path)
          指定されたノードが描画される Rectangle を返します。
 TreePath getPathForLocation(int x, int y)
          指定された位置にあるノードのパスを返します。
 TreePath getPathForRow(int row)
          指定された行のパスを返します。
 Dimension getPreferredScrollableViewportSize()
          JTree の適切な表示サイズを返します。
 Rectangle getRowBounds(int row)
          指定された行にあるノードが描画される Rectangle を返します。
 int getRowCount()
          現在表示されている行数を返します。
 int getRowForLocation(int x, int y)
          指定された位置にある行を返します。
 int getRowForPath(TreePath path)
          指定されたパスによって識別されるノードを表示する行を返します。
 int getRowHeight()
          各行の高さを返します。
 int getScrollableBlockIncrement(Rectangle visibleRect, int orientation, int direction)
          「ブロック」増分値の量を返します。
 boolean getScrollableTracksViewportHeight()
          ツリーの適切な高さがビューポートの高さより小さくない限り、false を返して、ビューポートの高さがテーブルの高さを決めないことを示します。
 boolean getScrollableTracksViewportWidth()
          ツリーの適切な幅がビューポートの幅より小さくない限り、false を返して、ビューポートの幅がテーブルの幅を決めないことを示します。
 int getScrollableUnitIncrement(Rectangle visibleRect, int orientation, int direction)
          スクロール時に増分する量を返します。
 boolean getScrollsOnExpand()
          隠れていた子を表示するためにツリーをスクロールする場合に true を返します。
 int getSelectionCount()
          選択されたノードの数を返します。
 TreeSelectionModel getSelectionModel()
          選択のモデルを返します。
 TreePath getSelectionPath()
          選択された最初のノードのパスを返します。
 TreePath[] getSelectionPaths()
          選択されたすべての値のパスを返します。
 int[] getSelectionRows()
          現在選択されているすべての行を返します。
 boolean getShowsRootHandles()
          ルートノードのハンドルが表示されている場合に true を返します。
 int getToggleClickCount()
          ノードを展開したり閉じるときに必要なマウスクリックの回数を返します。
 String getToolTipText(MouseEvent event)
          JComponentgetToolTipText メソッドをオーバーライドして、レンダリングのヒント (テキストセットがある場合) を使用できるようにします。
 TreeUI getUI()
          このコンポーネントを描画する L&F オブジェクトを返します。
 String getUIClassID()
          このコンポーネントを描画する L&F クラスの名前を返します。
 int getVisibleRowCount()
          表示領域に表示されている行数を返します。
 boolean hasBeenExpanded(TreePath path)
          パスによって識別されるノードが今までに展開されたことがある場合に true を返します。
 boolean isCollapsed(int row)
          指定された表示行にあるノードが収納されている場合に true を返します。
 boolean isCollapsed(TreePath path)
          パスによって識別される値が現在収納されている場合に true を返します。
 boolean isEditable()
          ツリーが編集可能な場合に true を返します。
 boolean isEditing()
          ツリーが編集されている場合に true を返します。
 boolean isExpanded(int row)
          指定された表示行にあるノードが現在展開されている場合に true を返します。
 boolean isExpanded(TreePath path)
          パスによって識別されるノードが現在展開されている場合に true を返します。
 boolean isFixedRowHeight()
          各表示行の高さが固定サイズの場合に true を返します。
 boolean isLargeModel()
          ツリーが大きなモデル用に設定されている場合に true を返します。
 boolean isPathEditable(TreePath path)
          isEditable を返します。
 boolean isPathSelected(TreePath path)
          パスによって識別される項目が現在選択されている場合に true を返します。
 boolean isRootVisible()
          ツリーのルートノードが表示されている場合に true を返します。
 boolean isRowSelected(int row)
          行によって識別されるノードが選択されている場合に true を返します。
 boolean isSelectionEmpty()
          選択範囲が現在空の場合に true を返します。
 boolean isVisible(TreePath path)
          パスによって識別される値が現在表示可能である場合、つまりそれがルートであるか、そのすべての親が展開されている場合に true を返します。
 void makeVisible(TreePath path)
          パスによって識別されるノードが現在表示可能であるようにします。
protected  String paramString()
          この JTree の文字列表現を返します。
protected  boolean removeDescendantSelectedPaths(TreePath path, boolean includePath)
          path の下位ノードである選択されたすべてのパスを削除します。
protected  void removeDescendantToggledPaths(Enumeration toRemove)
          toRemove にある、展開されている TreePaths の下位ノードを削除します。
 void removeSelectionInterval(int index0, int index1)
          index0 から index1 までのノードを選択から削除します。
 void removeSelectionPath(TreePath path)
          指定されたパスによって識別されるノードを現在の選択から削除します。
 void removeSelectionPaths(TreePath[] paths)
          指定されたパスによって識別されるノードを現在の選択から削除します。
 void removeSelectionRow(int row)
          インデックス row にあるパスを現在の選択から削除します。
 void removeSelectionRows(int[] rows)
          指定された各行で選択されているパスを削除します。
 void removeTreeExpansionListener(TreeExpansionListener tel)
          TreeExpansion イベントのリスナーを削除します。
 void removeTreeSelectionListener(TreeSelectionListener tsl)
          TreeSelection リスナーを削除します。
 void removeTreeWillExpandListener(TreeWillExpandListener tel)
          TreeWillExpand イベントのリスナーを削除します。
 void scrollPathToVisible(TreePath path)
          パスにあるすべてのパスコンポーネント (最後のパスコンポーネントは除く) を展開し、パスによって指定されるノードが表示されるようにスクロールします。
 void scrollRowToVisible(int row)
          行によって識別される項目を表示されるまでスクロールします。
 void setAnchorSelectionPath(TreePath newPath)
          アンカーとして識別するパスを設定します。
 void setCellEditor(TreeCellEditor cellEditor)
          セルエディタを設定します。
 void setCellRenderer(TreeCellRenderer x)
          各セルを描画するために使用される TreeCellRenderer を設定します。
 void setEditable(boolean flag)
          ツリーが編集可能かどうかを設定します。
protected  void setExpandedState(TreePath path, boolean state)
          この JTree の展開状態を設定します。
 void setExpandsSelectedPaths(boolean newValue)
          expandsSelectedPaths プロパティを設定します。
 void setInvokesStopCellEditing(boolean newValue)
          ツリーの別のノードの選択、ツリーのデータの変更、またはほかの手段によって編集が割り込まれたときに何をするかを設定します。
 void setLargeModel(boolean newValue)
          UI が大きなモデルを使用するかどうかを設定します (すべての UI がこれを実装するわけではない)。
 void setLeadSelectionPath(TreePath newPath)
          リードとして識別するパスを設定します。
 void setModel(TreeModel newModel)
          データを提供する TreeModel を設定します。
 void setRootVisible(boolean rootVisible)
          TreeModel のルートノードが可視かどうかを判定します。
 void setRowHeight(int rowHeight)
          各セルの高さをピクセル単位で設定します。
 void setScrollsOnExpand(boolean newValue)
          ノードが展開されたときに、できるだけ多くの下位ノードがビューポート内にスクロールされるかどうかを設定します。
 void setSelectionInterval(int index0, int index1)
          index0 から index1 までのノードを選択します。
 void setSelectionModel(TreeSelectionModel selectionModel)
          ツリーの選択モデルを設定します。
 void setSelectionPath(TreePath path)
          指定されたパスで識別されるノードを選択します。
 void setSelectionPaths(TreePath[] paths)
          指定されたパスの配列によって識別されるノードを選択します。
 void setSelectionRow(int row)
          指定された表示行にあるノードを選択します。
 void setSelectionRows(int[] rows)
          指定された各表示行に対応するノードを選択します。
 void setShowsRootHandles(boolean newValue)
          ノードのハンドルが表示されるかどうかを決めます。
 void setToggleClickCount(int clickCount)
          ノードを展開したり閉じるために必要なマウスクリックの回数を設定します。
 void setUI(TreeUI ui)
          このコンポーネントを描画する L&F オブジェクトを設定します。
 void setVisibleRowCount(int newCount)
          表示する行数を設定します。
 void startEditingAtPath(TreePath path)
          指定されたパスによって識別されるノードを選択し、編集を開始します。
 boolean stopEditing()
          現在の編集セッションを終了します。
 void treeDidChange()
          ツリーの変更が、境界をサイズ変更する必要があるほど大きいが、展開されたノードセットを削除するほどではない場合に送られます (たとえば、ノードが展開されるか、収納されたとき、またはノードがツリーに挿入されたとき)。
 void updateUI()
          L&F が変更されたという UIManager からの通知です。
 
クラス javax.swing.JComponent から継承したメソッド
addAncestorListener, addNotify, addPropertyChangeListener, addPropertyChangeListener, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAutoscrolls, getBorder, getBounds, getClientProperty, getComponentGraphics, getConditionForKeyStroke, getDebugGraphicsOptions, getGraphics, getHeight, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getTopLevelAncestor, getVerifyInputWhenFocusTarget, getVisibleRect, getWidth, getX, getY, grabFocus, hasFocus, hide, isDoubleBuffered, isFocusCycleRoot, isFocusTraversable, isLightweightComponent, isManagingFocus, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isOptimizedDrawingEnabled, isPaintingTile, isPreferredSizeSet, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processFocusEvent, processKeyBinding, processKeyEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setDebugGraphicsOptions, setDoubleBuffered, setEnabled, setFont, setForeground, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update
 
クラス java.awt.Container から継承したメソッド
add, add, add, add, add, addContainerListener, addImpl, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getLayout, insets, invalidate, isAncestorOf, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setLayout, validate, validateTree
 
クラス java.awt.Component から継承したメソッド
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, getBackground, getBounds, getColorModel, getComponentOrientation, getCursor, getDropTarget, getFont, getFontMetrics, getForeground, getGraphicsConfiguration, getInputContext, getInputMethodRequests, getLocale, getLocation, getLocationOnScreen, getName, getParent, getPeer, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, imageUpdate, inside, isDisplayable, isEnabled, isLightweight, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus
 
クラス java.lang.Object から継承したメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

フィールドの詳細

treeModel

protected transient TreeModel treeModel
このオブジェクトによって表示されるツリーを定義するモデルです。

selectionModel

protected transient TreeSelectionModel selectionModel
このツリー内の選択されたノードのセットをモデル化します。

rootVisible

protected boolean rootVisible
ルートノードが表示されている場合は true、その子が最上位の可視ノードである場合は false です。

cellRenderer

protected transient TreeCellRenderer cellRenderer
ノードを描画するために使用されるセルです。null の場合、UI はデフォルトの cellRenderer を使用します。

rowHeight

protected int rowHeight
各表示行に使用する高さです。0 以下の場合、レンダリングが各行の高さを決めます。

showsRootHandles

protected boolean showsRootHandles
ハンドルがツリーの最上位レベルに表示されている場合は true です。

ハンドルとはノードのとなりに表示される小さなアイコンであり、ユーザがクリックするとノードが展開されるか、収納されます。共通のインタフェースは、展開できるノードでプラス符号 (+) を表示し、収納できるノードではマイナス符号 (-) を表示します。ハンドルは、最上位レベルより下のノードで常に表示されます。

rootVisible の設定がルートノードの表示を指定する場合は、それが最上位レベルの唯一のノードです。ルートノードが表示されない場合、そのすべての子がツリーの最上位レベルにあります。ハンドルは、最上位以外のノードで常に表示されます。

ルートノードが可視ではない場合、通常はこの値を true に設定します。true に設定しないと、ツリーはリストのように表示され、ユーザは「リストエントリ」が実際にはツリーノードであることを認識できません。

関連項目:
rootVisible

selectionRedirector

protected transient JTree.TreeSelectionRedirector selectionRedirector
新しいイベントを生成し、それを selectionListeners に渡します。

cellEditor

protected transient TreeCellEditor cellEditor
エントリのエディタです。デフォルトは null (ツリーは編集できない) です。

editable

protected boolean editable
ツリーが編集できるかどうかを示します。デフォルトは false です。

largeModel

protected boolean largeModel
このツリーが大きなモデルかどうかを示します。これは、コード最適化の設定です。大きなモデルは、セルの高さがすべてのノードで同じ場合に使用できます。大きなモデルを使用すると、UI は情報をほとんどキャッシュに書き込まず、その代わりに継続的にモデルに転送します。大きなモデルがない場合、UI はほとんどの情報をキャッシュに書き込み、その結果としてモデルに対するメソッドの呼び出しが少なくなります。

この値は、UI への単なる提案です。すべての UI がこの値を利用するわけではありません。デフォルト値は false です。


visibleRowCount

protected int visibleRowCount
一度に可視にする行数です。この値は、Scrollable インタフェースで使用されます。この値は、表示領域の適切なサイズを決めます。

invokesStopCellEditing

protected boolean invokesStopCellEditing
true の場合、選択の変更、ツリー内のデータの変更、またはほかの手段によって編集が停止されたときに、stopCellEditing が呼び出され、変更が保存されます。false の場合、cancelCellEditing が呼び出され、変更は破棄されます。デフォルトは false です。

scrollsOnExpand

protected boolean scrollsOnExpand
true の場合、ノードが展開されると、そのすべての下位ノードが可視になるようにスクロールされます。

toggleClickCount

protected int toggleClickCount
ノードを展開するために必要なマウスクリックの数です。

treeModelListener

protected transient TreeModelListener treeModelListener
expandedState を更新します。

CELL_RENDERER_PROPERTY

public static final String CELL_RENDERER_PROPERTY
cellRenderer のバウンドプロパティ名です。

TREE_MODEL_PROPERTY

public static final String TREE_MODEL_PROPERTY
treeModel のバウンドプロパティ名です。

ROOT_VISIBLE_PROPERTY

public static final String ROOT_VISIBLE_PROPERTY
rootVisible のバウンドプロパティ名です。

SHOWS_ROOT_HANDLES_PROPERTY

public static final String SHOWS_ROOT_HANDLES_PROPERTY
showsRootHandles のバウンドプロパティ名です。

ROW_HEIGHT_PROPERTY

public static final String ROW_HEIGHT_PROPERTY
rowHeight のバウンドプロパティ名です。

CELL_EDITOR_PROPERTY

public static final String CELL_EDITOR_PROPERTY
cellEditor のバウンドプロパティ名です。

EDITABLE_PROPERTY

public static final String EDITABLE_PROPERTY
editable のバウンドプロパティ名です。

LARGE_MODEL_PROPERTY

public static final String LARGE_MODEL_PROPERTY
largeModel のバウンドプロパティ名です。

SELECTION_MODEL_PROPERTY

public static final String SELECTION_MODEL_PROPERTY
selectionModel のバウンドプロパティ名です。

VISIBLE_ROW_COUNT_PROPERTY

public static final String VISIBLE_ROW_COUNT_PROPERTY
visibleRowCount のバウンドプロパティ名です。

INVOKES_STOP_CELL_EDITING_PROPERTY

public static final String INVOKES_STOP_CELL_EDITING_PROPERTY
messagesStopCellEditing のバウンドプロパティ名です。

SCROLLS_ON_EXPAND_PROPERTY

public static final String SCROLLS_ON_EXPAND_PROPERTY
scrollsOnExpand のバウンドプロパティ名です。

TOGGLE_CLICK_COUNT_PROPERTY

public static final String TOGGLE_CLICK_COUNT_PROPERTY
toggleClickCount のバウンドプロパティ名です。

LEAD_SELECTION_PATH_PROPERTY

public static final String LEAD_SELECTION_PATH_PROPERTY
leadSelectionPath のバウンドプロパティ名です。
導入されたバージョン:
1.3

ANCHOR_SELECTION_PATH_PROPERTY

public static final String ANCHOR_SELECTION_PATH_PROPERTY
アンカー選択パスのバウンドプロパティ名です。
導入されたバージョン:
1.3

EXPANDS_SELECTED_PATHS_PROPERTY

public static final String EXPANDS_SELECTED_PATHS_PROPERTY
選択パスのプロパティを展開するバウンドプロパティ名です。
導入されたバージョン:
1.3
コンストラクタの詳細

JTree

public JTree()
サンプルモデルを持つ JTree を返します。ツリーが使用するデフォルトモデルは、葉ノードを子のない任意ノードとして定義します。
関連項目:
DefaultTreeModel.asksAllowsChildren

JTree

public JTree(Object[] value)
指定された配列の各要素を、表示されていない新しいルートノードの子として持つ JTree を返します。デフォルトでは、ツリーは葉ノードを子のない任意ノードとして定義します。
パラメータ:
value - Object の配列
関連項目:
DefaultTreeModel.asksAllowsChildren

JTree

public JTree(Vector value)
指定された Vector の各要素を、表示されていない新しいルートノードの子として持つ JTree を返します。デフォルトでは、ツリーは葉ノードを子のない任意ノードとして定義します。
パラメータ:
value - Vector
関連項目:
DefaultTreeModel.asksAllowsChildren

JTree

public JTree(Hashtable value)
Hashtable から生成された、ルートを表示しない JTree を返します。HashTable のキーと値の組の値側が新しいルートノードの子になります。デフォルトでは、ツリーは葉ノードを子のない任意のノードとして定義します。
パラメータ:
value - Hashtable
関連項目:
DefaultTreeModel.asksAllowsChildren

JTree

public JTree(TreeNode root)
指定された TreeNode をルートに持つ、ルートノードを表示する JTree を返します。デフォルトでは、ツリーは葉ノードを子のない任意のノードとして定義します。
パラメータ:
root - TreeNode オブジェクト
関連項目:
DefaultTreeModel.asksAllowsChildren

JTree

public JTree(TreeNode root,
             boolean asksAllowsChildren)
ルートノードを表示し、ノードが葉ノードかどうかを指定された方法で決める、指定された TreeNode をルートとして持つ JTree を返します。
パラメータ:
root - TreeNode オブジェクト
asksAllowsChildren - false の場合、子を持たないすべてのノードが葉ノード。true の場合、子を許可しないノードだけが葉ノード
関連項目:
DefaultTreeModel.asksAllowsChildren

JTree

public JTree(TreeModel newModel)
ルートノードを表示する JTree のインスタンスを返します。ツリーは、指定されたデータモデルを使用して生成されます。
パラメータ:
newModel - データモデルとして使用する TreeModel
メソッドの詳細

getDefaultTreeModel

protected static TreeModel getDefaultTreeModel()
サンプル TreeModel を生成し、それを返します。何かを興味深く見せるために、主に Beanbuilder で使用されます。
戻り値:
デフォルトの TreeModel

createTreeModel

protected static TreeModel createTreeModel(Object value)
指定されたオブジェクトをラップする TreeModel を返します。オブジェクトが次のどれかの場合です。 新しいルートノードは、各オブジェクトを子として作成されます。そうでない場合、新しいルートは指定されたオブジェクトをその値として作成されます。
パラメータ:
value - TreeModel の基礎として使用される Object
戻り値:
指定されたオブジェクトをラップする TreeModel

getUI

public TreeUI getUI()
このコンポーネントを描画する L&F オブジェクトを返します。
戻り値:
このコンポーネントを描画する TreeUI オブジェクト

setUI

public void setUI(TreeUI ui)
このコンポーネントを描画する L&F オブジェクトを設定します。
パラメータ:
ui - TreeUI の L&F オブジェクト
関連項目:
UIDefaults.getUI(javax.swing.JComponent)

updateUI

public void updateUI()
L&F が変更されたという UIManager からの通知です。現在の UI オブジェクトを UIManager からの最新バージョンに置き換えます。
オーバーライド:
クラス JComponent 内の updateUI
関連項目:
JComponent.updateUI()

getUIClassID

public String getUIClassID()
このコンポーネントを描画する L&F クラスの名前を返します。
オーバーライド:
クラス JComponent 内の getUIClassID
戻り値:
TreeUI の文字列
関連項目:
JComponent.getUIClassID(), UIDefaults.getUI(javax.swing.JComponent)

getCellRenderer

public TreeCellRenderer getCellRenderer()
各セルを描画している現在の TreeCellRenderer を返します。
戻り値:
各セルを描画している TreeCellRenderer

setCellRenderer

public void setCellRenderer(TreeCellRenderer x)
各セルを描画するために使用される TreeCellRenderer を設定します。
パラメータ:
x - 各セルを描画する TreeCellRenderer

setEditable

public void setEditable(boolean flag)
ツリーが編集可能かどうかを設定します。新しい設定が既存の設定と違う場合はプロパティ変更イベントをトリガーします。
パラメータ:
flag - boolean 値。ツリーが編集可能な場合は true

isEditable

public boolean isEditable()
ツリーが編集可能な場合に true を返します。
戻り値:
ツリーが編集可能な場合は true

setCellEditor

public void setCellEditor(TreeCellEditor cellEditor)
セルエディタを設定します。null 値は、ツリーが編集できないことを示します。これが cellEditor での変更を表す場合、propertyChange メソッドがすべてのリスナーで呼び出されます。
パラメータ:
cellEditor - 使用する TreeCellEditor

getCellEditor

public TreeCellEditor getCellEditor()
ツリーのエントリを編集するために使用されるエディタを返します。
戻り値:
使用中の TreeCellEditor。ツリーが編集できない場合は null

getModel

public TreeModel getModel()
データを提供している TreeModel を返します。
戻り値:
データを提供している TreeModel

setModel

public void setModel(TreeModel newModel)
データを提供する TreeModel を設定します。
パラメータ:
newModel - データを提供する TreeModel

isRootVisible

public boolean isRootVisible()
ツリーのルートノードが表示されている場合に true を返します。
戻り値:
ツリーのルートノードが表示されている場合は true
関連項目:
rootVisible

setRootVisible

public void setRootVisible(boolean rootVisible)
TreeModel のルートノードが可視かどうかを判定します。
パラメータ:
rootVisible - ツリーのルートノードが表示される場合は true
関連項目:
rootVisible

setShowsRootHandles

public void setShowsRootHandles(boolean newValue)
ノードのハンドルが表示されるかどうかを決めます。
パラメータ:
newValue - ルートのハンドルが表示される場合は true
関連項目:
showsRootHandles

getShowsRootHandles

public boolean getShowsRootHandles()
ルートノードのハンドルが表示されている場合に true を返します。
戻り値:
ルートのハンドルが表示されている場合は true
関連項目:
showsRootHandles

setRowHeight

public void setRowHeight(int rowHeight)
各セルの高さをピクセル単位で設定します。指定された値が 0 以下の場合は、各行の高さについて現在のセルレンダリングが照会されます。
パラメータ:
rowHeight - 各セルのピクセル単位の高さ

getRowHeight

public int getRowHeight()
各行の高さを返します。戻り値が 0 以下の場合、各行の高さはレンダリングによって決められます。
戻り値:
各セルの高さ (ピクセル単位)。各行の高さがツリーセルレンダリングによって決められる場合は 0 または負の値

isFixedRowHeight

public boolean isFixedRowHeight()
各表示行の高さが固定サイズの場合に true を返します。
戻り値:
各行の高さが固定サイズの場合は true

setLargeModel

public void setLargeModel(boolean newValue)
UI が大きなモデルを使用するかどうかを設定します (すべての UI がこれを実装するわけではない)。LARGE_MODEL_PROPERTY のプロパティ変更をトリガーします。
パラメータ:
newValue - UI に対して大きなモデルを提案する場合は true
関連項目:
largeModel

isLargeModel

public boolean isLargeModel()
ツリーが大きなモデル用に設定されている場合に true を返します。
戻り値:
大きなモデルが提案されている場合は true
関連項目:
largeModel

setInvokesStopCellEditing

public void setInvokesStopCellEditing(boolean newValue)
ツリーの別のノードの選択、ツリーのデータの変更、またはほかの手段によって編集が割り込まれたときに何をするかを設定します。このプロパティを true に設定すると、編集が割り込まれたときに変更が自動的に保存されます。

INVOKES_STOP_CELL_EDITING_PROPERTY のプロパティ変更をトリガーします。

パラメータ:
newValue - true の場合は、編集が割り込まれたときに stopCellEditing が呼び出され、データが保存される。false の場合は、cancelCellEditing が呼び出され、変更が失われる

getInvokesStopCellEditing

public boolean getInvokesStopCellEditing()
編集が割り込まれたときに何をするかを示すインジケータを返します。
戻り値:
編集が割り込まれるとどうなるかを示すインジケータ
関連項目:
setInvokesStopCellEditing(boolean)

setScrollsOnExpand

public void setScrollsOnExpand(boolean newValue)
ノードが展開されたときに、できるだけ多くの下位ノードがビューポート内にスクロールされるかどうかを設定します。デフォルトは true です。

getScrollsOnExpand

public boolean getScrollsOnExpand()
隠れていた子を表示するためにツリーをスクロールする場合に true を返します。
戻り値:
ノードが展開されたときに、できるだけ多くの下位ノードが可視になるようにスクロールされる場合は true

setToggleClickCount

public void setToggleClickCount(int clickCount)
ノードを展開したり閉じるために必要なマウスクリックの回数を設定します。デフォルトは 2 回です。
導入されたバージョン:
1.3

getToggleClickCount

public int getToggleClickCount()
ノードを展開したり閉じるときに必要なマウスクリックの回数を返します。
戻り値:
ノードを展開するために必要なマウスクリックの数
導入されたバージョン:
1.3

setExpandsSelectedPaths

public void setExpandsSelectedPaths(boolean newValue)
expandsSelectedPaths プロパティを設定します。true の場合には、TreeSelectionModel またはJTree が提供するカバーメソッドによりいつでも選択を変更でき、TreePath の親が展開され可視になります。可視とは、JTree の可視矩形にかぎらず親パスが展開されている状態を意味します。false の場合、ノード選択を変更すると親はすべて展開されても可視にはなりません。選択モデルのパスを、すべての親を展開し常に非表示にする場合には便利です。
パラメータ:
newValue - expandsSelectedPaths の新規の値
導入されたバージョン:
1.3

getExpandsSelectedPaths

public boolean getExpandsSelectedPaths()
expandsSelectedPaths プロパティを返します。
戻り値:
選択変更によって親パスが展開される結果となる場合は true
導入されたバージョン:
1.3
関連項目:
setExpandsSelectedPaths(boolean)

isPathEditable

public boolean isPathEditable(TreePath path)
isEditable を返します。このメソッドは編集が始まる前に UI から呼び出され、指定されたパスを編集できるようにします。このメソッドは、新しいエディタを作成することなくフィルタ編集を追加するためのサブクラサのエントリポイントとして提供されます。
戻り値:
すべての親ノードおよびそのノード自体が編集可能な場合は true
関連項目:
isEditable()

getToolTipText

public String getToolTipText(MouseEvent event)
JComponentgetToolTipText メソッドをオーバーライドして、レンダリングのヒント (テキストセットがある場合) を使用できるようにします。

注: JTree がレンダリングのツールヒントを正しく表示するためには、JTree がコンポーネントとして ToolTipManager に登録されている必要があります。登録するには、ToolTipManager.sharedInstance().registerComponent(tree) を呼び出します。これは自動的には行われません。

オーバーライド:
クラス JComponent 内の getToolTipText
パラメータ:
event - ToolTip の表示を起動した MouseEvent
戻り値:
ツールヒントを格納する文字列。event が null の場合は null

convertValueToText

public String convertValueToText(Object value,
                                 boolean selected,
                                 boolean expanded,
                                 boolean leaf,
                                 int row,
                                 boolean hasFocus)
レンダリングによって呼び出され、指定された値をテキストに変換します。この実装は、value.toString を返し、ほかのすべての引数を無視します。変換を制御するには、このメソッドをサブクラス化し、必要な任意の引数を使用します。
パラメータ:
value - テキストに変換する Object
selected - ノードが選択されている場合は true
expanded - ノードが展開されている場合は true
leaf - ノードが葉ノードの場合は true
row - ノードの表示行を指定する int 値。0 は最初の行
hasFocus - ノードがフォーカスを持つ場合は true
戻り値:
ノードの値の String 表現

getRowCount

public int getRowCount()
現在表示されている行数を返します。
戻り値:
表示されている行数

setSelectionPath

public void setSelectionPath(TreePath path)
指定されたパスで識別されるノードを選択します。そのパスのコンポーネントが隠れていて (収納されたノードの下にある)、getExpandsSelectedPaths が true の場合には表示可能になります。
パラメータ:
path - 選択するノードを指定する TreePath

setSelectionPaths

public void setSelectionPaths(TreePath[] paths)
指定されたパスの配列によって識別されるノードを選択します。そのパスのコンポーネントが隠されていて (収納されたノードの下にある)、getExpandsSelectedPaths が true の場合には表示可能になります。
パラメータ:
paths - 選択するノードを指定する TreePath オブジェクトの配列

setLeadSelectionPath

public void setLeadSelectionPath(TreePath newPath)
リードとして識別するパスを設定します。リードは選択されません。リードは JTree によって維持されるのではなく、UI が更新します。
パラメータ:
newPath - 新しいリードパス
導入されたバージョン:
1.3

setAnchorSelectionPath

public void setAnchorSelectionPath(TreePath newPath)
アンカーとして識別するパスを設定します。アンカーは JTree によって維持されるのではなく、UI が更新します。
パラメータ:
newPath - 新しいアンカーパス
導入されたバージョン:
1.3

setSelectionRow

public void setSelectionRow(int row)
指定された表示行にあるノードを選択します。
パラメータ:
row - 選択する行。0 は最初の行

setSelectionRows

public void setSelectionRows(int[] rows)
指定された各表示行に対応するノードを選択します。rows の特定の要素が < 0 または>= getRowCount の場合、その要素は無視されます。rows のすべての要素が無効な行である場合、選択はクリアされます。つまり、clearSelection が呼び出された場合と同じです。
パラメータ:
rows - 選択する行を指定する int の配列。0 は最初の行を示す

addSelectionPath

public void addSelectionPath(TreePath path)
指定された TreePath によって識別されるノードを現在の選択に追加します。そのパスのコンポーネントが表示可能ではなく、getExpandsSelectedPaths が true の場合には表示可能になります。
パラメータ:
path - 追加する TreePath

addSelectionPaths

public void addSelectionPaths(TreePath[] paths)
パスの配列の各パスを現在の選択に追加します。そのパスのコンポーネントが表示可能ではなく、getExpandsSelectedPaths が true の場合には表示可能になります。
パラメータ:
paths - 追加するノードを指定する TreePath オブジェクトの配列

addSelectionRow

public void addSelectionRow(int row)
指定された行にあるパスを現在の選択に追加します。
パラメータ:
row - 追加するノードの行を指定する int 値。0 は最初の行

addSelectionRows

public void addSelectionRows(int[] rows)
指定された各行にあるパスを現在の選択に追加します。
パラメータ:
rows - 追加する行を指定する int の配列。0 は最初の行を示す

getLastSelectedPathComponent

public Object getLastSelectedPathComponent()
現在の選択の最初のノードにある最後のパスコンポーネントを返します。
戻り値:
選択された最初のノードの TreePath にある最後の Object。何も選択されていない場合は null
関連項目:
TreePath.getLastPathComponent()

getLeadSelectionPath

public TreePath getLeadSelectionPath()
リードと識別されたパスを返します。
戻り値:
リードと識別されたパス

getAnchorSelectionPath

public TreePath getAnchorSelectionPath()
アンカーと識別されたパスを返します。
戻り値:
アンカーと識別されたパス
導入されたバージョン:
1.3

getSelectionPath

public TreePath getSelectionPath()
選択された最初のノードのパスを返します。
戻り値:
選択された最初のノードの TreePath。現在何も選択されていない場合は null

getSelectionPaths

public TreePath[] getSelectionPaths()
選択されたすべての値のパスを返します。
戻り値:
選択されたノードを示す TreePath オブジェクトの配列。現在何も選択されていない場合は null

getSelectionRows

public int[] getSelectionRows()
現在選択されているすべての行を返します。このメソッドは単に TreeSelectionModel に転送されます。何も選択されていない場合は、null または空の配列が返されます。どちらが返されるかは、TreeSelectionModel の実装によって異なります。
戻り値:
現在選択されているすべての行を識別する int の配列。0 は最初の行

getSelectionCount

public int getSelectionCount()
選択されたノードの数を返します。
戻り値:
選択されたノードの数

getMinSelectionRow

public int getMinSelectionRow()
選択されている最初の行を返します。
戻り値:
選択された最初の行を指定する int 値。0 は最初の行

getMaxSelectionRow

public int getMaxSelectionRow()
選択されている最後の行を返します。
戻り値:
選択された最後の行を指定する int 値。0 は最初の行

getLeadSelectionRow

public int getLeadSelectionRow()
リードパスに対応する行のインデックスを返します。
戻り値:
リードパスの行のインデックスを指定する int 値。0 は最初の行。leadPathnull の場合は -1

isPathSelected

public boolean isPathSelected(TreePath path)
パスによって識別される項目が現在選択されている場合に true を返します。
パラメータ:
path - ノードを識別する TreePath
戻り値:
ノードが選択されている場合は true

isRowSelected

public boolean isRowSelected(int row)
行によって識別されるノードが選択されている場合に true を返します。
パラメータ:
row - 表示行を指定する int 値。0 は最初の行
戻り値:
ノードが選択されている場合は true

getExpandedDescendants

public Enumeration getExpandedDescendants(TreePath parent)
現在展開されているパス parent の下位ノードから成る Enumeration を返します。parent が現在展開されていない場合、このメソッドは null を返します。返された Enumeration で繰り返している間ノードを展開するか、収納すると、このメソッドは展開されたすべてのパスを返すのではなく、それ以上展開されていないパスを返します。
パラメータ:
parent - 調べられるパス
戻り値:
parent の下位ノードの Enumerationparent が現在展開されていない場合は、null

hasBeenExpanded

public boolean hasBeenExpanded(TreePath path)
パスによって識別されるノードが今までに展開されたことがある場合に true を返します。
戻り値:
path が今までに展開された場合は true

isExpanded

public boolean isExpanded(TreePath path)
パスによって識別されるノードが現在展開されている場合に true を返します。
パラメータ:
path - 調べるノードを指定する TreePath
戻り値:
ノードのパスにあるノードが収納されている場合は false、パスにあるすべてのノードが展開されている場合は true

isExpanded

public boolean isExpanded(int row)
指定された表示行にあるノードが現在展開されている場合に true を返します。
パラメータ:
row - 調べる行。0 は最初の行
戻り値:
ノードが現在展開されている場合は true、そうでない場合は false

isCollapsed

public boolean isCollapsed(TreePath path)
パスによって識別される値が現在収納されている場合に true を返します。このメソッドは、パスにある値が現在表示されていない場合は false を返します。
パラメータ:
path - 調べる TreePath
戻り値:
ノードのパスにあるノードが収納されている場合は true、パスにあるすべてのノードが展開されている場合は false

isCollapsed

public boolean isCollapsed(int row)
指定された表示行にあるノードが収納されている場合に true を返します。
パラメータ:
row - 調べる行。0 は最初の行
戻り値:
ノードが現在展開されている場合は true、そうでない場合は false

makeVisible

public void makeVisible(TreePath path)
パスによって識別されるノードが現在表示可能であるようにします。
パラメータ:
path - 可視にする TreePath

isVisible

public boolean isVisible(TreePath path)
パスによって識別される値が現在表示可能である場合、つまりそれがルートであるか、そのすべての親が展開されている場合に true を返します。そうでない場合、このメソッドは false を返します。
戻り値:
ノードが表示可能な場合は true、そうでない場合は false

getPathBounds

public Rectangle getPathBounds(TreePath path)
指定されたノードが描画される Rectangle を返します。パスにあるコンポーネントが隠れている (収納された親の下にある) 場合は null を返します。

注:
このメソッドは、指定されたノードが現在表示されていない場合でも有効な矩形を返します。

パラメータ:
path - ノードを識別する TreePath
戻り値:
ノードが描画される Rectangle または null

getRowBounds

public Rectangle getRowBounds(int row)
指定された行にあるノードが描画される Rectangle を返します。
パラメータ:
row - 描画される行。0 は最初の行
戻り値:
ノードが描画される Rectangle

scrollPathToVisible

public void scrollPathToVisible(TreePath path)
パスにあるすべてのパスコンポーネント (最後のパスコンポーネントは除く) を展開し、パスによって指定されるノードが表示されるようにスクロールします。この JTreeJScrollPane に格納されている場合だけ機能します。
パラメータ:
path - 表示するノードを識別する TreePath

scrollRowToVisible

public void scrollRowToVisible(int row)
行によって識別される項目を表示されるまでスクロールします。行を表示するために必要な最小の量だけスクロールします。この JTreeJScrollPane に格納されている場合だけ機能します。
パラメータ:
row - スクロールする行を指定する int 値。0 は最初の行

getPathForRow

public TreePath getPathForRow(int row)
指定された行のパスを返します。row が可視でない場合は、null が返されます。
パラメータ:
row - 行を指定する int 値
戻り値:
指定されたノードの TreePathrow < 0 または row > getRowCount() の場合は null

getRowForPath

public int getRowForPath(TreePath path)
指定されたパスによって識別されるノードを表示する行を返します。
パラメータ:
path - ノードを識別する TreePath
戻り値:
表示行を指定する int 値。0 は最初の行。パスの要素が収納された親の下で隠れている場合は -1

expandPath

public void expandPath(TreePath path)
指定されたパスによって識別されるノードが展開され、表示可能になるようにします。
パラメータ:
path - ノードを識別する TreePath

expandRow

public void expandRow(int row)
指定された行にあるノードが展開され、表示可能になるようにします。

row が < 0 または >= getRowCount の場合、このメソッドは何もしません。

パラメータ:
row - 表示行を指定する int 値。0 は最初の行

collapsePath

public void collapsePath(TreePath path)
指定されたパスによって識別されるノードが収納され、表示可能になるようにします。
パラメータ:
path - ノードを識別する TreePath

collapseRow

public void collapseRow(int row)
指定された行にあるノードが収納されているようにします。

row が < 0 または >= getRowCount の場合、このメソッドは何もしません。

パラメータ:
row - 表示行を指定する int 値。0 は最初の行

getPathForLocation

public TreePath getPathForLocation(int x,
                                   int y)
指定された位置にあるノードのパスを返します。
パラメータ:
x - 表示領域 (左マージンは除く) の左端からの水平距離を示す int 値 (ピクセル単位)
y - 表示領域 (上マージンは除く) の上端からの垂直距離を示す int 値 (ピクセル単位)
戻り値:
指定された位置にあるノードの TreePath

getRowForLocation

public int getRowForLocation(int x,
                             int y)
指定された位置にある行を返します。
パラメータ:
x - 表示領域 (左マージンは除く) の左端からの水平距離を示す int 値 (ピクセル単位)
y - 表示領域 (上マージンは除く) の上端からの垂直距離を示す int 値 (ピクセル単位)
戻り値:
指定された位置に対応する行。指定された位置が表示セルの境界外の場合は -1
関連項目:
getClosestRowForLocation(int, int)

getClosestPathForLocation

public TreePath getClosestPathForLocation(int x,
                                          int y)
x、y にもっとも近いノードのパスを返します。現在表示可能なノードがない場合、またはモデルがない場合は null が返されます。そうでない場合、このメソッドは常に有効なパスを返します。ノードが正確に x、y の位置にあるかどうかをテストするには、ノードの境界を取得し、それを基準に x、y をテストします。
パラメータ:
x - 表示領域 (左マージンは除く) の左端からの水平距離を示す int 値 (ピクセル単位)
y - 表示領域 (上マージンは除く) の上端からの垂直距離を示す int 値 (ピクセル単位)
戻り値:
指定された位置にもっとも近いノードの TreePath。表示可能なノードがない場合、またはモデルがない場合は null
関連項目:
getPathForLocation(int, int), getPathBounds(javax.swing.tree.TreePath)

getClosestRowForLocation

public int getClosestRowForLocation(int x,
                                    int y)
x、y にもっとも近いノードの行を返します。表示可能なノードがないか、モデルがない場合は -1 が返されます。そうでない場合、このメソッドは常に有効な行を返します。返されたオブジェクトが正確に x、y の位置にあるかどうかをテストするには、返された行にあるノードの境界を取得し、それを基準に x、y をテストします。
パラメータ:
x - 表示領域 (左マージンは除く) の左端からの水平距離を示す int 値 (ピクセル単位)
y - 表示領域 (上マージンは除く) の上端からの垂直距離を示す int 値 (ピクセル単位)
戻り値:
指定された位置にもっとも近い行。表示可能なノードがない場合、またはモデルがない場合は -1
関連項目:
getRowForLocation(int, int), getRowBounds(int)

isEditing

public boolean isEditing()
ツリーが編集されている場合に true を返します。編集されている項目は、getSelectionPath を使用して取得できます。
戻り値:
ユーザが現在ノードを編集している場合は true
関連項目:
getSelectionPath()

stopEditing

public boolean stopEditing()
現在の編集セッションを終了します。DefaultTreeCellEditor オブジェクトは、セル上で進行中の編集をすべて保存します。ほかの実装は異なる動作をする場合があります。ツリーが編集されていない場合は何もしません。
注:
ユーザがツリー内で移動したときに自動的に編集を保存するには、setInvokesStopCellEditing(boolean) を使用します。
戻り値:
編集が行われていて、現在停止している場合は true。編集が行われていなかった場合は false

cancelEditing

public void cancelEditing()
現在の編集セッションを取り消します。ツリーが編集されてない場合は何もしません。

startEditingAtPath

public void startEditingAtPath(TreePath path)
指定されたパスによって識別されるノードを選択し、編集を開始します。CellEditor が指定された項目の編集を許可しない場合、編集の試みは失敗します。
パラメータ:
path - ノードを識別する TreePath

getEditingPath

public TreePath getEditingPath()
現在編集されている要素のパスを返します。
戻り値:
編集されているノードの TreePath

setSelectionModel

public void setSelectionModel(TreeSelectionModel selectionModel)
ツリーの選択モデルを設定します。null 値を指定すると、選択を許可しない空の selectionModel が使用されます。
パラメータ:
selectionModel - 使用する TreeSelectionModel。選択を無効にする場合は null
関連項目:
TreeSelectionModel

getSelectionModel

public TreeSelectionModel getSelectionModel()
選択のモデルを返します。このメソッドは、常に null 以外の値を返します。選択を許可したくない場合は、選択モデルを null に設定して強制的に空の選択モデルを使用します。
戻り値:
使用されている TreeSelectionModel
関連項目:
setSelectionModel(javax.swing.tree.TreeSelectionModel)

getPathBetweenRows

protected TreePath[] getPathBetweenRows(int index0,
                                        int index1)
index0 から index1 までのパスを表す JTreePath のインスタンスを返します。ツリーがない場合は null を返します。
パラメータ:
index0 - 表示行を指定する int 値。0 は最初の行
index1 - 2 番目の行を指定する int 値
戻り値:
TreePath オブジェクト (index0 から index1 までの各ノードに 1 つ) の配列。ツリーがない場合は、null

setSelectionInterval

public void setSelectionInterval(int index0,
                                 int index1)
index0 から index1 までのノードを選択します。
パラメータ:
index0 - 表示行を指定する int 値。0 は最初の行
index1 - 2 番目の行を指定する int 値

addSelectionInterval

public void addSelectionInterval(int index0,
                                 int index1)
index0 から index1 までのパスを選択に追加します。
パラメータ:
index0 - 表示行を指定する int 値。0 は最初の行
index1 - 2 番目の行を指定する int 値

removeSelectionInterval

public void removeSelectionInterval(int index0,
                                    int index1)
index0 から index1 までのノードを選択から削除します。
パラメータ:
index0 - 表示行を指定する int 値。0 は最初の行
index1 - 2 番目の行を指定する int 値

removeSelectionPath

public void removeSelectionPath(TreePath path)
指定されたパスによって識別されるノードを現在の選択から削除します。
パラメータ:
path - ノードを識別する TreePath

removeSelectionPaths

public void removeSelectionPaths(TreePath[] paths)
指定されたパスによって識別されるノードを現在の選択から削除します。
パラメータ:
paths - 削除するノードを指定する TreePath オブジェクトの配列

removeSelectionRow

public void removeSelectionRow(int row)
インデックス row にあるパスを現在の選択から削除します。
パラメータ:
path - 削除するノードを識別する TreePath

removeSelectionRows

public void removeSelectionRows(int[] rows)
指定された各行で選択されているパスを削除します。
パラメータ:
row - 表示行を指定する int の配列。0 は最初の行

clearSelection

public void clearSelection()
選択をクリアします。

isSelectionEmpty

public boolean isSelectionEmpty()
選択範囲が現在空の場合に true を返します。
戻り値:
選択が現在空である場合は true

addTreeExpansionListener

public void addTreeExpansionListener(TreeExpansionListener tel)
TreeExpansion イベントのリスナーを追加します。
パラメータ:
tel - ツリーノードが展開されたとき、または収納されたとき (負の展開) に通知される TreeExpansionListener

removeTreeExpansionListener

public void removeTreeExpansionListener(TreeExpansionListener tel)
TreeExpansion イベントのリスナーを削除します。
パラメータ:
tel - 削除する TreeExpansionListener

addTreeWillExpandListener

public void addTreeWillExpandListener(TreeWillExpandListener tel)
TreeWillExpand イベントのリスナーを追加します。
パラメータ:
tel - ツリーノードが展開されるとき、または収納されるとき (負の展開) に通知される TreeWillExpandListener

removeTreeWillExpandListener

public void removeTreeWillExpandListener(TreeWillExpandListener tel)
TreeWillExpand イベントのリスナーを削除します。
パラメータ:
tel - 削除する TreeWillExpandListener

fireTreeExpanded

public void fireTreeExpanded(TreePath path)
このイベントタイプへの通知を配信対象に登録しているリスナーすべてに通知します。トリガーメソッドに渡されたパラメータを使用して、イベントのインスタンスは生成されます。
パラメータ:
path - 展開されたノードを示す TreePath
関連項目:
EventListenerList

fireTreeCollapsed

public void fireTreeCollapsed(TreePath path)
このイベントタイプの通知を受けるように登録されたすべてのリスナーに通知します。イベントのインスタンスは、このトリガーメソッドに渡されたパラメータを使用して作成されます。
パラメータ:
path - 収納されたノードを示す TreePath
関連項目:
EventListenerList

fireTreeWillExpand

public void fireTreeWillExpand(TreePath path)
                        throws ExpandVetoException
このイベントタイプの通知を受けるように登録されたすべてのリスナーに通知します。イベントのインスタンスは、このトリガーメソッドに渡されたパラメータを使用して作成されます。
パラメータ:
path - 展開されたノードを示す TreePath
関連項目:
EventListenerList

fireTreeWillCollapse

public void fireTreeWillCollapse(TreePath path)
                          throws ExpandVetoException
このイベントタイプの通知を受けるように登録されたすべてのリスナーに通知します。イベントのインスタンスは、このトリガーメソッドに渡されたパラメータを使用して作成されます。
パラメータ:
path - 展開されたノードを示す TreePath
関連項目:
EventListenerList

addTreeSelectionListener

public void addTreeSelectionListener(TreeSelectionListener tsl)
TreeSelection イベントのリスナーを追加します。
パラメータ:
tsl - ノードが選択されたとき、または選択を解除されたとき (負の選択) に通知される TreeSelectionListener

removeTreeSelectionListener

public void removeTreeSelectionListener(TreeSelectionListener tsl)
TreeSelection リスナーを削除します。
パラメータ:
tsl - 削除する TreeSelectionListener

fireValueChanged

protected void fireValueChanged(TreeSelectionEvent e)
このイベントタイプの通知を配信対象として登録しているリスナーすべてに通知します。fire メソッドに渡されたパラメータを使用して、イベントのインスタンスは生成されます。
パラメータ:
e - ノードが選択されるか、選択を解除されるときに TreeSelectionModel によって生成される TreeSelectionEvent
関連項目:
EventListenerList

treeDidChange

public void treeDidChange()
ツリーの変更が、境界をサイズ変更する必要があるほど大きいが、展開されたノードセットを削除するほどではない場合に送られます (たとえば、ノードが展開されるか、収納されたとき、またはノードがツリーに挿入されたとき)。このメソッドを呼び出す必要はなく、必要な場合は UI が呼び出します。

setVisibleRowCount

public void setVisibleRowCount(int newCount)
表示する行数を設定します。このメソッドは、レシーバが JScrollPane に格納されている場合だけ機能し、スクロールペインの適切なサイズを調整します。
パラメータ:
newCount - 表示する行数

getVisibleRowCount

public int getVisibleRowCount()
表示領域に表示されている行数を返します。
戻り値:
表示された行数

getPreferredScrollableViewportSize

public Dimension getPreferredScrollableViewportSize()
JTree の適切な表示サイズを返します。高さは getVisibleRowCount から決められ、幅は現在の適切な幅です。
定義:
インタフェース Scrollable 内の getPreferredScrollableViewportSize
戻り値:
適切なサイズを保持する Dimension オブジェクト

getScrollableUnitIncrement

public int getScrollableUnitIncrement(Rectangle visibleRect,
                                      int orientation,
                                      int direction)
スクロール時に増分する量を返します。この量は、完全に表示されていない最初に表示されている行の高さ、またはその行が完全に表示されている場合は、スクロールする方向にある次の行の高さです。
定義:
インタフェース Scrollable 内の getScrollableUnitIncrement
パラメータ:
visibleRect - ビューポート内の可視のビュー領域
orientation - SwingConstants.VERTICAL または SwingConstants.HORIZONTAL
direction - 上または左にスクロールする場合は 0 より小さく、下または右にスクロールする場合は 0 より大きい
戻り値:
指定された方向にスクロールするための「ユニット」増分値
関連項目:
JScrollBar.setUnitIncrement(int)

getScrollableBlockIncrement

public int getScrollableBlockIncrement(Rectangle visibleRect,
                                       int orientation,
                                       int direction)
「ブロック」増分値の量を返します。この量は、orientation に基づいた visibleRect の高さまたは幅です。
定義:
インタフェース Scrollable 内の getScrollableBlockIncrement
パラメータ:
visibleRect - ビューポート内の可視のビュー領域
orientation - SwingConstants.VERTICAL または SwingConstants.HORIZONTAL
direction - 上または左にスクロールする場合は 0 より小さく、下または右にスクロールする場合は 0 より大きい
戻り値:
指定された方向にスクロールするための「ブロック」増分値
関連項目:
JScrollBar.setBlockIncrement(int)

getScrollableTracksViewportWidth

public boolean getScrollableTracksViewportWidth()
ツリーの適切な幅がビューポートの幅より小さくない限り、false を返して、ビューポートの幅がテーブルの幅を決めないことを示します。つまり、ツリーがビューポートより小さくならないようにします。
定義:
インタフェース Scrollable 内の getScrollableTracksViewportWidth
戻り値:
false
関連項目:
Scrollable.getScrollableTracksViewportWidth()

getScrollableTracksViewportHeight

public boolean getScrollableTracksViewportHeight()
ツリーの適切な高さがビューポートの高さより小さくない限り、false を返して、ビューポートの高さがテーブルの高さを決めないことを示します。つまり、ツリーがビューポートより小さくならないようにします。
定義:
インタフェース Scrollable 内の getScrollableTracksViewportHeight
戻り値:
false
関連項目:
Scrollable.getScrollableTracksViewportHeight()

setExpandedState

protected void setExpandedState(TreePath path,
                                boolean state)
この JTree の展開状態を設定します。state が true の場合、path のすべての親およびパスに展開のマークが付けられます。state が false の場合、path のすべての親は EXPANDED で示されますが、path 自体は収納されていることが示されます。

これは、TreeWillExpandListener に拒否される場合は失敗します。


getDescendantToggledPaths

protected Enumeration getDescendantToggledPaths(TreePath parent)
parent の下位ノードであり、展開されている TreePathsEnumeration を返します。

removeDescendantToggledPaths

protected void removeDescendantToggledPaths(Enumeration toRemove)
toRemove にある、展開されている TreePaths の下位ノードを削除します。

clearToggledPaths

protected void clearToggledPaths()
切り替えられたツリーパスのキャッシュをクリアします。これは、TreeExpansionListener イベントを送出しません。

createTreeModelListener

protected TreeModelListener createTreeModelListener()
TreeModelHandler のインスタンスを生成して返します。返されたオブジェクトは、TreeModel が変更されたときに展開状態を更新します。

展開状態の詳細は上記の、JTree description を参照してください。


removeDescendantSelectedPaths

protected boolean removeDescendantSelectedPaths(TreePath path,
                                                boolean includePath)
path の下位ノードである選択されたすべてのパスを削除します。includePath が true で path が選択されている場合は、選択から削除されます。
戻り値:
下位ノードが選択された場合は true
導入されたバージョン:
1.3

paramString

protected String paramString()
この JTree の文字列表現を返します。このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なります。返される文字列は空の場合がありますが、null にはなりません。
オーバーライド:
クラス JComponent 内の paramString
戻り値:
この JTree の文字列表現

getAccessibleContext

public AccessibleContext getAccessibleContext()
この JTree に関連した AccessibleContext を返します。JTree の場合、AccessibleContext は AccessibleJTree の形式を取ります。必要に応じて新規の AccessibleJTree インスタンスが作成されます。
定義:
インタフェース Accessible 内の getAccessibleContext
オーバーライド:
クラス JComponent 内の getAccessibleContext
戻り値:
この JTree の AccessibleContext として機能する AccessibleJTree

JavaTM 2 Platform
Std. Ed. v1.3

バグや機能要求の報告
さらに詳しい API リファレンスおよび開発者ドキュメントについては、 Java 2 SDK SE Developer Documentation を参照してください。このドキュメントには、概念、用語の定義、回避策、 実用的なコード例など、開発者を対象にした詳細な解説が掲載されています。

Java、Java 2D、JDBC は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.