クラスJTree

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JTree

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

ImageObserver, MenuContainer, Serializable, Accessible, Scrollable

@JavaBean(defaultProperty="UI", description="A component that displays a set of hierarchical data as an outline.") public class JTree extends JComponent implements Scrollable, Accessible

階層データのセットをアウトラインとして表示するコントロール。 ツリーに関するタスク指向のドキュメントと使用例については、「The Java Tutorial」の「How to Use Trees」を参照してく� さい。

ツリーの特定のノードは、ノードおよびすべての上位ノードをカプセル化するオブジェクトであるTreePath、または表示� �域の各行が1つのノードを表示する表示行により識別されます。 展開されたノードは、葉以外のノード(TreeModel.isLeaf(node)がfalseを返すことで識別される)であり、そのすべての上位ノードが展開されたときに子を表示します。 折りたたまれたノードは子を� します。 � されたノードは折りたたまれた親の下にあります。 すべての表示可能ノードの親は展開されますが、表示される� �合とされない� �合があります。 表示ノードは表示可能であり、表示� �域にあります。

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

• isRootVisible()
• setRootVisible()
• scrollPathToVisible()
• scrollRowToVisible()
• getVisibleRowCount()
• setVisibleRowCount()

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

• isVisible()
• makeVisible()

いつ選択が変更されたかを知りたい� �合は、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クラスと同様に、InputMapとActionMapを使用してActionオブジェクトとKeyStrokeを関連付け、指定した条件でアクションを実行できます。

警告: Swingはスレッドに対して安全ではありません。 詳細は、「Swing's Threading Policy」を参照してく� さい。

警告: このクラスの直列化されたオブジェクトは、今後のSwingリリースと互換ではなくなる予定です。 現在の直列化のサポートは、短期間の� �納や、同じバージョンのSwingを実行するアプリケーション間のRMIに適しています。 1.4では、すべてのJavaBeansの長期ストレージのサポートがjava.beansパッケージに追� されました。 XMLEncoderを参照してく� さい。

導入されたバージョン:

1.2

ネストされたクラスのサマリー

ネストされたクラス

修飾子と型	クラス	説明
protected class	JTree.AccessibleJTree	このクラスはJTreeクラスのアクセシビリティ・サポートを実装しています。
static final class	JTree.DropLocation	TransferHandler.DropLocationのサブクラスであり、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, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

フィールドのサマリー

フィールド

修飾子と型	フィールド	説明
static final String	ANCHOR_SELECTION_PATH_PROPERTY	アンカー選択パスのバウンド・プロパティ名です。
static final String	CELL_EDITOR_PROPERTY	cellEditorのバウンド・プロパティ名です。
static final String	CELL_RENDERER_PROPERTY	cellRendererのバウンド・プロパティ名です。
protected TreeCellEditor	cellEditor	エントリのエディタです。
protected TreeCellRenderer	cellRenderer	ノードを描画するために使用されるセルです。
protected boolean	editable	ツリーが編集できるかどうかを示します。
static final String	EDITABLE_PROPERTY	editableのバウンド・プロパティ名です。
static final String	EXPANDS_SELECTED_PATHS_PROPERTY	選択パスのプロパティを展開するバウンド・プロパティ名です。
static final String	INVOKES_STOP_CELL_EDITING_PROPERTY	messagesStopCellEditingのバウンド・プロパティ名です。
protected boolean	invokesStopCellEditing	trueの� �合、選択の変更、ツリー内のデータの変更、またはほかの手段によって編集が停止されたときに、stopCellEditingが呼び出され、変更が保存されます。
static final String	LARGE_MODEL_PROPERTY	largeModelのバウンド・プロパティ名です。
protected boolean	largeModel	このツリーが大きなモデルかどうかを示します。
static final String	LEAD_SELECTION_PATH_PROPERTY	leadSelectionPathのバウンド・プロパティ名です。
static final String	ROOT_VISIBLE_PROPERTY	rootVisibleのバウンド・プロパティ名です。
protected boolean	rootVisible	ルート・ノードが表示されている� �合はtrue、その子が最上位の可視ノードである� �合はfalseです。
static final String	ROW_HEIGHT_PROPERTY	rowHeightのバウンド・プロパティ名です。
protected int	rowHeight	各表示行に使用する高さです。
static final String	SCROLLS_ON_EXPAND_PROPERTY	scrollsOnExpandのバウンド・プロパティ名です。
protected boolean	scrollsOnExpand	trueの� �合、ノードが展開されると、そのすべての下位ノードが可視になるようにスクロールされます。
static final String	SELECTION_MODEL_PROPERTY	selectionModelのバウンド・プロパティ名です。
protected TreeSelectionModel	selectionModel	このツリー内の選択されたノードのセットをモデル化します。
protected JTree.TreeSelectionRedirector	selectionRedirector	新しいイベントを生成し、それをselectionListenersに渡します。
static final String	SHOWS_ROOT_HANDLES_PROPERTY	showsRootHandlesのバウンド・プロパティ名です。
protected boolean	showsRootHandles	ハンドルがツリーの最上位レベルに表示されている� �合はtrueです。
static final String	TOGGLE_CLICK_COUNT_PROPERTY	toggleClickCountのバウンド・プロパティ名です。
protected int	toggleClickCount	ノードを展開するために必要なマウス・クリックの数です。
static final String	TREE_MODEL_PROPERTY	treeModelのバウンド・プロパティ名です。
protected TreeModel	treeModel	このオブジェクトによって表示されるツリーを定義するモデルです。
protected TreeModelListener	treeModelListener	expandedStateを更新します。
static final String	VISIBLE_ROW_COUNT_PROPERTY	visibleRowCountのバウンド・プロパティ名です。
protected int	visibleRowCount	一度に可視にする行数です。

クラスjavax.swing.JComponentで宣言されたフィールド

listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

クラスjava.awt.Componentで宣言されたフィールド

accessibleContext, 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(Object[] value)	指定された配列の各要� を、表示されていない新しいルート・ノードの子として持つJTreeを返します。
JTree(Hashtable<?,?> value)	Hashtableから生成された、ルートを表示しないJTreeを返します。
JTree(Vector<?> value)	指定されたVectorの各要� を、表示されていない新しいルート・ノードの子として持つJTreeを返します。
JTree(TreeModel newModel)	ルート・ノードを表示するJTreeのインスタンスを返します。ツリーは、指定されたデータ・モデルを使用して生成されます。
JTree(TreeNode root)	指定されたTreeNodeをルートに持ち、そのルート・ノードを表示するJTreeを返します。
JTree(TreeNode root, boolean asksAllowsChildren)	ルート・ノードを表示し、ノードが葉ノードかどうかを指定された方法で決定し、指定されたTreeNodeをルートとして持つJTreeを返します。

メソッドのサマリー

修飾子と型	メソッド	説明
void	addSelectionInterval(int index0, int 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<TreePath>	getDescendantToggledPaths(TreePath parent)	parentの下位ノードであり、展開されているTreePathsのEnumerationを返します。
boolean	getDragEnabled()	自動ドラッグ処理が有効であるかどうかを返します。
final JTree.DropLocation	getDropLocation()	このコンポーネントがコンポーネントのドラッグ・アンド・ドロップ時にドロップ位置として視覚的に示す位置を返します。現在位置が表示されていない� �合はnullを返します。
final DropMode	getDropMode()	このコンポーネントのドロップ・モードを返します。
TreePath	getEditingPath()	現在編集されている要� のパスを返します。
Enumeration<TreePath>	getExpandedDescendants(TreePath parent)	現在展開されているパスparentの下位ノードから成るEnumerationを返します。
boolean	getExpandsSelectedPaths()	expandsSelectedPathsプロパティを返します。
boolean	getInvokesStopCellEditing()	編集が割り込まれたときに何をするかを示すインジケータを返します。
Object	getLastSelectedPathComponent()	選択されたパスの最後のパス・コンポーネントを返します。
TreePath	getLeadSelectionPath()	リードと識別されたパスを返します。
int	getLeadSelectionRow()	リード・パスに対応する行のインデックスを返します。
int	getMaxSelectionRow()	選択されている最大の行を返します。
int	getMinSelectionRow()	選択されている最小の行を返します。
TreeModel	getModel()	データを提供しているTreeModelを返します。
TreePath	getNextMatch(String prefix, int startingRow, Position.Bias bias)	prefixで始まる次のツリー要� へのTreePathを返します。
protected TreePath[]	getPathBetweenRows(int index0, int index1)	指定された行の間(この行を含む)のパスを返します。
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)	ブロック増分値の量を返します。この量は、orientationに基づいたvisibleRectの高さまたは幅です。
boolean	getScrollableTracksViewportHeight()	ツリーの適切な高さがビュー・ポートの高さより小さくないかぎり、falseを返して、ビュー・ポートの高さがテーブルの高さを決めないことを示します。
boolean	getScrollableTracksViewportWidth()	ツリーの適切な幅がビュー・ポートの幅より小さくないかぎり、falseを返して、ビュー・ポートの幅がテーブルの幅を決めないことを示します。
int	getScrollableUnitIncrement(Rectangle visibleRect, int orientation, int direction)	スクロール時に増分する量を返します。
boolean	getScrollsOnExpand()	scrollsOnExpandプロパティの値を返します。
int	getSelectionCount()	選択されたノードの数を返します。
TreeSelectionModel	getSelectionModel()	選択のモデルを返します。
TreePath	getSelectionPath()	選択された最初のノードのパスを返します。
TreePath[]	getSelectionPaths()	選択されたすべての値のパスを返します。
int[]	getSelectionRows()	現在選択されているすべての行を返します。
boolean	getShowsRootHandles()	showsRootHandlesプロパティの値を返します。
int	getToggleClickCount()	ノードを展開したり閉じるときに必要なマウス・クリックの回数を返します。
String	getToolTipText(MouseEvent event)	JComponentのgetToolTipTextメソッドをオーバーライドして、テキスト・セットがある� �合にレンダラのヒントを使用できるようにします。
TreeExpansionListener[]	getTreeExpansionListeners()	addTreeExpansionListener()を使用してこのJTreeに追� されたすべてのTreeExpansionListenerの配列を返します。
TreeSelectionListener[]	getTreeSelectionListeners()	addTreeSelectionListener()を使用してこのJTreeに追� されたすべてのTreeSelectionListenerの配列を返します。
TreeWillExpandListener[]	getTreeWillExpandListeners()	addTreeWillExpandListener()を使用してこのJTreeに追� されたすべてのTreeWillExpandListenerの配列を返します。
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を返します。このメソッドは、パスにある値が現在表示されていない� �合はfalseを返します。
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<TreePath> toRemove)	toRemoveにある、展開されているTreePathsの下位ノードを削除します。
void	removeSelectionInterval(int index0, int 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	setDragEnabled(boolean b)	自動ドラッグ処理をオンまたはオフにします。
final void	setDropMode(DropMode dropMode)	このコンポーネントのドロップ・モードを設定します。
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が大きなモデルを使用するかどうかを指定します。
void	setLeadSelectionPath(TreePath newPath)	リードとして識別するパスを設定します。
void	setModel(TreeModel newModel)	データを提供するTreeModelを設定します。
void	setRootVisible(boolean rootVisible)	TreeModelのルート・ノードが可視かどうかを設定します。
void	setRowHeight(int rowHeight)	各セルの高さをピクセル単位で設定します。
void	setScrollsOnExpand(boolean newValue)	scrollsOnExpandプロパティを設定します。このプロパティは、ツリーをスクロールしたときに以前は非表示� った子を表示するかどうかを示します。
void	setSelectionInterval(int index0, int 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)	ノード・ハンドルを表示するかどうかを示すshowsRootHandlesプロパティの値を設定します。
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, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

クラスjava.awt.Containerで宣言されたメソッド

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree

クラスjava.awt.Componentで宣言されたメソッド

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

クラス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に設定します。 そうしない� �合、ツリーはリストのように表示され、ユーザーは「リスト・エントリ」が実際にはツリー・ノードであることを認識できません。

関連� �目:

• 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 - aVector

関連� �目:

• DefaultTreeModel.asksAllowsChildren

JTree

public JTree(Hashtable<?,?> value)

Hashtableから生成された、ルートを表示しないJTreeを返します。 HashTableのキーと値の組の値側が新しいルート・ノードの子になります。 デフォルトでは、ツリーは葉ノードを子のない任意のノードとして定義します。

パラメータ:

value - aHashtable

関連� �目:

• 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

@ConstructorProperties("model") public JTree(TreeModel newModel)

ルート・ノードを表示するJTreeのインスタンスを返します。ツリーは、指定されたデータ・モデルを使用して生成されます。

パラメータ:

newModel - データ・モデルとして使用するTreeModel

メソッドの詳細

getDefaultTreeModel

protected static TreeModel getDefaultTreeModel()

サンプルTreeModelを生成し、それを返します。 何かを興味深く見せるために、主にBeanbuilderで使用されます。

戻り値:

デフォルトのTreeModel

createTreeModel

protected static TreeModel createTreeModel(Object value)

指定されたオブジェクトをラップするTreeModelを返します。 次のオブジェクトの� �合、

• Objectの配列、
• Hashtable、または
• Vector

新しいルート・ノードは、各オブジェクトを子として作成されます。 そうでない� �合、新しいルートは"root"の値で作成されます。

パラメータ:

value - TreeModelの基礎として使用されるObject

戻り値:

指定されたオブジェクトをラップするTreeModel

getUI

public TreeUI getUI()

このコンポーネントをレンダリングするL&Fオブジェクトを返します。

オーバーライド:

クラスJComponentのgetUI

戻り値:

このコンポーネントをレンダリングするTreeUIオブジェクト

setUI

@BeanProperty(hidden=true, visualUpdate=true, description="The UI object that implements the Component's LookAndFeel.") 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の最新バージョンに置き換えます。

オーバーライド:

updateUI、クラスJComponent

関連� �目:

• JComponent.updateUI()

getUIClassID

@BeanProperty(bound=false) public String getUIClassID()

このコンポーネントをレンダリングするL&Fクラスの名前を返します。

オーバーライド:

getUIClassID、クラスJComponent

戻り値:

文字列「TreeUI」

関連� �目:

• JComponent.getUIClassID()
• UIDefaults.getUI(javax.swing.JComponent)

getCellRenderer

public TreeCellRenderer getCellRenderer()

各セルをレンダリングしている現在のTreeCellRendererを返します。

戻り値:

各セルをレンダリングしているTreeCellRenderer

setCellRenderer

@BeanProperty(description="The TreeCellRenderer that will be used to draw each cell.") public void setCellRenderer(TreeCellRenderer x)

各セルを描画するために使用するTreeCellRendererを設定します。

これはバウンド・プロパティです。

パラメータ:

x - 各セルをレンダリングするTreeCellRenderer

setEditable

@BeanProperty(description="Whether the tree is editable.") public void setEditable(boolean flag)

ツリーが編集可能かどうかを設定します。 新しい設定が既存の設定と違う� �合はプロパティ変更イベントをトリガーします。

これはバウンド・プロパティです。

パラメータ:

flag - boolean値。ツリーが編集可能な� �合はtrue

isEditable

public boolean isEditable()

ツリーが編集可能な� �合にtrueを返します。

戻り値:

ツリーが編集可能な� �合はtrue

setCellEditor

@BeanProperty(description="The cell editor. NULL値はツリーを編集できないことを意味します。) public void setCellEditor(TreeCellEditor cellEditor) 

セル・エディタを設定します。 null値は、ツリーが編集できないことを示します。 これがcellEditorでの変更を表す� �合、propertyChangeメソッドがすべてのリスナーで呼び出されます。

これはバウンド・プロパティです。

パラメータ:

cellEditor - 使用するTreeCellEditor

getCellEditor

public TreeCellEditor getCellEditor()

ツリーのエントリを編集するために使用されるエディタを返します。

戻り値:

使用中のTreeCellEditor。ツリーが編集できない� �合はnull

getModel

public TreeModel getModel()

データを提供しているTreeModelを返します。

戻り値:

データを提供しているTreeModel

setModel

@BeanProperty(description="The TreeModel that will provide the data.") public void setModel(TreeModel newModel)

データを提供するTreeModelを設定します。

これはバウンド・プロパティです。

パラメータ:

newModel - データを提供するTreeModel

isRootVisible

public boolean isRootVisible()

ツリーのルート・ノードが表示されている� �合にtrueを返します。

戻り値:

ツリーのルート・ノードが表示されている� �合はtrue

関連� �目:

• rootVisible

setRootVisible

@BeanProperty(description="Whether or not the root node from the TreeModel is visible.") public void setRootVisible(boolean rootVisible)

TreeModelのルート・ノードが可視かどうかを設定します。

これはバウンド・プロパティです。

パラメータ:

rootVisible - ツリーのルート・ノードが表示される� �合はtrue

関連� �目:

• rootVisible

setShowsRootHandles

@BeanProperty(description="Whether the node handles are to be displayed.") public void setShowsRootHandles(boolean newValue)

ノード・ハンドルを表示するかどうかを示すshowsRootHandlesプロパティの値を設定します。 このプロパティのデフォルト値は、JTreeの作成に使用するコンストラクタによって異なります。 ルック・アンド・フィールによっては、ハンドルがサポートされていない� �合があります。その� �合、このプロパティは無視されます。

これはバウンド・プロパティです。

パラメータ:

newValue - ルート・ハンドルを表示する� �合はtrue、そうでない� �合はfalse

関連� �目:

• showsRootHandles
• getShowsRootHandles()

getShowsRootHandles

public boolean getShowsRootHandles()

showsRootHandlesプロパティの値を返します。

戻り値:

showsRootHandlesプロパティの値

関連� �目:

• showsRootHandles

setRowHeight

@BeanProperty(description="The height of each cell.") public void setRowHeight(int rowHeight)

各セルの高さをピクセル単位で設定します。 指定された値が0以下の� �合は、各行の高さについて現在のセル・レンダリングが照会されます。

これはバウンド・プロパティです。

パラメータ:

rowHeight - 各セルのピクセル単位の高さ

getRowHeight

public int getRowHeight()

各行の高さを返します。 戻り値が0以下の� �合、各行の高さはレンダリングによって決められます。

戻り値:

各行の高さ

isFixedRowHeight

@BeanProperty(bound=false) public boolean isFixedRowHeight()

各表示行の高さが固定サイズの� �合にtrueを返します。

戻り値:

各行の高さが固定サイズの� �合はtrue

setLargeModel

@BeanProperty(description="Whether the UI should use a large model.") public void setLargeModel(boolean newValue)

UIが大きなモデルを使用するかどうかを指定します。 (すべてのUIがこれを実装するわけではない)。 LARGE_MODEL_PROPERTYのプロパティ変更をトリガーします。

これはバウンド・プロパティです。

パラメータ:

newValue - UIに対して大きなモデルを提案する� �合はtrue

関連� �目:

• largeModel

isLargeModel

public boolean isLargeModel()

ツリーが大きなモデル用に設定されている� �合にtrueを返します。

戻り値:

大きなモデルが提案されている� �合はtrue

関連� �目:

• largeModel

setInvokesStopCellEditing

@BeanProperty(description="Determines what happens when editing is interrupted, selecting another node in the tree, a change in the tree's data, or some other means.") public void setInvokesStopCellEditing(boolean newValue)

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

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

パラメータ:

newValue - trueの� �合、編集が割り込まれたときstopCellEditingが呼び出され、データが保存される。falseの� �合、cancelCellEditingが呼び出され、変更は� �棄される

getInvokesStopCellEditing

public boolean getInvokesStopCellEditing()

編集が割り込まれたときに何をするかを示すインジケータを返します。

戻り値:

編集が割り込まれるとどうなるかを示すインジケータ

関連� �目:

• setInvokesStopCellEditing(boolean)

setScrollsOnExpand

@BeanProperty(description="Indicates if a node descendant should be scrolled when expanded.") public void setScrollsOnExpand(boolean newValue)

scrollsOnExpandプロパティを設定します。このプロパティは、ツリーをスクロールしたときに以前は非表示� った子を表示するかどうかを示します。 このプロパティがtrue (デフォルト)の� �合、ノードを展開すると、下位ノードができる� け多く可視状態になるようにツリーでスクロールを使用できます。 ルック・アンド・フィールによっては、ノードの展開時にスクロールを必要としない� �合があります。その� �合、このプロパティは無視されます。

これはバウンド・プロパティです。

パラメータ:

newValue - 展開時のスクロールを使用不可にする� �合はfalse、使用可能にする� �合はtrue

関連� �目:

• getScrollsOnExpand()

getScrollsOnExpand

public boolean getScrollsOnExpand()

scrollsOnExpandプロパティの値を返します。

戻り値:

scrollsOnExpandプロパティの値

setToggleClickCount

@BeanProperty(description="Number of clicks before a node will expand/collapse.") public void setToggleClickCount(int clickCount)

ノードを展開したり閉じるために必要なマウス・クリックの回数を設定します。 デフォルトは2回です。

これはバウンド・プロパティです。

パラメータ:

clickCount - ノードを拡大または閉じるためのマウス・クリック数

導入されたバージョン:

1.3

getToggleClickCount

public int getToggleClickCount()

ノードを展開したり閉じるときに必要なマウス・クリックの回数を返します。

戻り値:

ノードを展開するために必要なマウス・クリックの数

導入されたバージョン:

1.3

setExpandsSelectedPaths

@BeanProperty(description="Indicates whether changes to the selection should make the parent of the path visible.") 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)

setDragEnabled

@BeanProperty(bound=false, description="determines whether automatic drag handling is enabled") public void setDragEnabled(boolean b)

自動ドラッグ処理をオンまたはオフにします。 自動ドラッグ処理を有効にするには、このプロパティの値をtrueに設定し、ツリーのTransferHandlerの値をnon-nullにしてく� さい。 dragEnabledプロパティのデフォルト値はfalseです。

このプロパティを受け入れ、ユーザーのドラッグ・ジェスチャを認識する処理は、ルック・アンド・フィール実装(特にツリーのTreeUI)によって行われます。 自動ドラッグ処理が有効である� �合、ほとんどのルック・アンド・フィール (BasicLookAndFeelのサブクラスのルック・アンド・フィールを含む)は、ユーザーが� �目の上でマウス・ボタンを押し、マウスを数ピクセル移動すると、ドラッグ・アンド・ドロップ操作を開始します。 したがって、このプロパティをtrueに設定すると、選択の動作に微妙に影響する� �合があります。

このプロパティを無視するようなルック・アンド・フィールを使用している� �合も、ツリーのTransferHandler上でexportAsDragを呼び出すことにより、ドラッグ・アンド・ドロップ操作を開始できます。

パラメータ:

b - 自動ドラッグ処理を有効にするかどうか

スロー:

HeadlessException - bがtrueで、GraphicsEnvironment.isHeadless()がtrueを返す� �合

導入されたバージョン:

1.4

関連� �目:

• GraphicsEnvironment.isHeadless()
• getDragEnabled()
• JComponent.setTransferHandler(javax.swing.TransferHandler)
• TransferHandler

getDragEnabled

public boolean getDragEnabled()

自動ドラッグ処理が有効であるかどうかを返します。

戻り値:

dragEnabledプロパティの値

導入されたバージョン:

1.4

関連� �目:

• setDragEnabled(boolean)

setDropMode

public final void setDropMode(DropMode dropMode)

このコンポーネントのドロップ・モードを設定します。 下位互換性を確保するため、このプロパティのデフォルト値はDropMode.USE_SELECTIONになっています。 た� し、ユーザー側の操作を改善する� �合は、ほかのモードを使用することをお勧めします。 たとえば、DropMode.ONは、ツリー内の実際の選択内容に影響を及ぼすことなく、選択されたように� �目を表示する動作と似た動作を提供します。

JTreeは次のドロップ・モードをサポートしています。

• DropMode.USE_SELECTION
• DropMode.ON
• DropMode.INSERT
• DropMode.ON_OR_INSERT

このコンポーネントがドロップを受け付けるTransferHandlerを持っていなければ、ドロップ・モードの効果はありません。

パラメータ:

dropMode - 使用するドロップ・モード

スロー:

IllegalArgumentException - ドロップ・モードがサポートされていないかnullの� �合

導入されたバージョン:

1.6

関連� �目:

• getDropMode()
• getDropLocation()
• JComponent.setTransferHandler(javax.swing.TransferHandler)
• TransferHandler

getDropMode

public final DropMode getDropMode()

このコンポーネントのドロップ・モードを返します。

戻り値:

このコンポーネントのドロップ・モード

導入されたバージョン:

1.6

関連� �目:

• setDropMode(javax.swing.DropMode)

getDropLocation

@BeanProperty(bound=false) public final JTree.DropLocation getDropLocation()

このコンポーネントがコンポーネントのドラッグ・アンド・ドロップ時にドロップ位置として視覚的に示す位置を返します。現在位置が表示されていない� �合はnullを返します。

このメソッドは、TransferHandlerからドロップ位置を照会する手段にはなりません。ドロップ位置は、TransferHandlerのcanImportが返され、ドロップ位置を表示する準備ができてから設定されるためです。

このプロパティが変更されると、コンポーネントにより、プロパティ変更イベントdropLocationがトリガーされます。

戻り値:

ドロップ位置

導入されたバージョン:

1.6

関連� �目:

• setDropMode(javax.swing.DropMode)
• TransferHandler.canImport(TransferHandler.TransferSupport)

isPathEditable

public boolean isPathEditable(TreePath path)

isEditableを返します。 これは、編集を開始する前にUIから起動され、指定されたパスを編集できるようにします。 このメソッドは、新しいエディタを作成することなくフィルタ編集を追� するためのサブクラサーのエントリ・ポイントとして提供されます。

パラメータ:

path - ノードを識別するTreePath

戻り値:

すべての親ノードおよびそのノード自体が編集可能な� �合はtrue

関連� �目:

• isEditable()

getToolTipText

public String getToolTipText(MouseEvent event)

JComponentのgetToolTipTextメソッドをオーバーライドして、テキスト・セットがある� �合にレンダラのヒントを使用できるようにします。

ノート: JTreeがレンダリングのツールヒントを適切に表示できるようにするには、JTreeがToolTipManagerに登録済みのコンポーネントでなければいけません。 登録するには、ToolTipManager.sharedInstance().registerComponent(tree)を呼び出します。 これは自動的には行われません。

オーバーライド:

getToolTipText、クラスJComponent

パラメータ:

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 - ノードの表示行を指定する整数。0が最初の行

hasFocus - ノードがフォーカスを持つ� �合はtrue

戻り値:

ノードの値のString表現

getRowCount

@BeanProperty(bound=false) public int getRowCount()

表示可能ノードの数を返します。 ノードはそのすべての親が展開されている� �合に表示可能です。 ルートはisRootVisible()がtrueの� �合にのみこのカウントに含まれます。 これは、UIが設定されていない� �合は0を返します。

戻り値:

表示可能ノードの数

setSelectionPath

public void setSelectionPath(TreePath path)

指定されたパスによって識別されるノードを選択します。 ノードが折りたたまれているため、そのパスのコンポーネントが� れていて、getExpandsSelectedPathsがtrueの� �合は、表示可能になります。

パラメータ:

path - 選択するノードを指定するTreePath

setSelectionPaths

public void setSelectionPaths(TreePath[] paths)

指定されたパスの配列によって識別されるノードを選択します。 そのパスのコンポーネントが� されていて(折りたたまれたノードの下にある)、getExpandsSelectedPathsがtrueの� �合には表示可能になります。

パラメータ:

paths - 選択するノードを指定するTreePathオブジェクトの配列

setLeadSelectionPath

@BeanProperty(description="Lead selection path") public void setLeadSelectionPath(TreePath newPath)

リードとして識別するパスを設定します。 リードは選択されません。 リードはJTreeによって維持されるのではなく、UIが更新します。

これはバウンド・プロパティです。

パラメータ:

newPath - 新しいリード・パス

導入されたバージョン:

1.3

setAnchorSelectionPath

@BeanProperty(description="Anchor selection path") 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の� �合には表示可能になります。

JTreeでは、同じ親の子として同じノードを重複させることはできません。各兄弟ノードは一意のオブジェクトであることが必要です。

パラメータ:

path - 追� するTreePath

addSelectionPaths

public void addSelectionPaths(TreePath[] paths)

パスの配列の各パスを現在の選択に追� します。 そのパスのコンポーネントが表示可能ではなく、getExpandsSelectedPathsがtrueの� �合には表示可能になります。

JTreeでは、同じ親の子として同じノードを重複させることはできません。各兄弟ノードは一意のオブジェクトであることが必要です。

パラメータ:

paths - 追� するノードを指定するTreePathオブジェクトの配列

addSelectionRow

public void addSelectionRow(int row)

指定された行にあるパスを現在の選択に追� します。

パラメータ:

row - 追� するノードの行を指定するint値。0は最初の行

addSelectionRows

public void addSelectionRows(int[] rows)

指定された各行にあるパスを現在の選択に追� します。

パラメータ:

rows - 追� する行を指定するintの配列。0は最初の行を示す

getLastSelectedPathComponent

@BeanProperty(bound=false) public Object getLastSelectedPathComponent()

選択されたパスの最後のパス・コンポーネントを返します。 これはgetSelectionModel().getSelectionPath().getLastPathComponent()の簡易メソッドです。 これは、通常、選択範囲にパスが1つある� �合にしか使用しません。

戻り値:

選択されたパスの最後のパス・コンポーネント。何も選択されていない� �合は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に転送されます。 何も選択されていない� �合は、TreeSelectionModelの実装に応じて、nullまたは空の配列が返されます。

戻り値:

現在選択されているすべての行を識別するintの配列。0は最初の行

getSelectionCount

@BeanProperty(bound=false) public int getSelectionCount()

選択されたノードの数を返します。

戻り値:

選択されたノードの数

getMinSelectionRow

@BeanProperty(bound=false) public int getMinSelectionRow()

選択されている最小の行を返します。 選択範囲が空、または選択されたパスが表示可能でない� �合は、-1が返されます。

戻り値:

選択されている最小の行

getMaxSelectionRow

@BeanProperty(bound=false) public int getMaxSelectionRow()

選択されている最大の行を返します。 選択範囲が空、または選択されたパスが表示可能でない� �合は、-1が返されます。

戻り値:

選択されている最大の行

getLeadSelectionRow

@BeanProperty(bound=false) public int getLeadSelectionRow()

リード・パスに対応する行のインデックスを返します。

戻り値:

リード・パスの行のインデックスを示すint値。0は最初の行。leadPathがnullの� �合は -1

isPathSelected

public boolean isPathSelected(TreePath path)

パスによって識別される� �目が現在選択されている� �合にtrueを返します。

パラメータ:

path - ノードを識別するTreePath

戻り値:

ノードが選択されている� �合はtrue

isRowSelected

public boolean isRowSelected(int row)

行によって識別されるノードが選択されている� �合にtrueを返します。

パラメータ:

row - 表示行を指定する整数。0は最初の行

戻り値:

ノードが選択されている� �合はtrue

getExpandedDescendants

public Enumeration<TreePath> getExpandedDescendants(TreePath parent)

現在展開されているパスparentの下位ノードから成るEnumerationを返します。 parentが現在展開されていない� �合、このメソッドはnullを返します。 返されたEnumerationで繰り返している間ノードを展開するか、折りたたむと、このメソッドは展開されたすべてのパスを返すのではなく、それ以上展開されていないパスを返します。

パラメータ:

parent - 調べられるパス

戻り値:

parentの下位ノードのEnumeration。parentが現在展開されていない� �合は、null

hasBeenExpanded

public boolean hasBeenExpanded(TreePath path)

パスによって識別されるノードが今までに展開されたことがある� �合にtrueを返します。

パラメータ:

path - ノードを識別するTreePath

戻り値:

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を返します。

パラメータ:

path - ノードを識別するTreePath

戻り値:

ノードが表示可能な� �合は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)

パスにあるすべてのパス・コンポーネント(最後のパス・コンポーネントは除く)を展開し、パスによって指定されるノードが表示されるようにスクロールします。 このJTreeがJScrollPaneに含まれている� �合に� け機能します。

パラメータ:

path - 表示するノードを識別するTreePath

scrollRowToVisible

public void scrollRowToVisible(int row)

行によって識別される� �目を表示されるまでスクロールします。 行を表示するために必要な最小の量� けスクロールします。 このJTreeがJScrollPaneに含まれている� �合に� け機能します。

パラメータ:

row - スクロールする行を指定する整数。0は最初の行

getPathForRow

@BeanProperty(bound=false) public TreePath getPathForRow(int row)

指定された行のパスを返します。 rowが可視でない� �合、またはTreeUIが設定されていない� �合はnullが返されます。

パラメータ:

row - 行を指定する整数

戻り値:

指定されたノードのTreePath。row < 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 - 表示行を指定する整数。0は最初の行

collapsePath

public void collapsePath(TreePath path)

指定されたパスによって識別されるノードが収納され、表示可能になるようにします。

パラメータ:

path - ノードを識別するTreePath

collapseRow

public void collapseRow(int row)

指定された行にあるノードが折りたたまれるようにします。

rowが0よりも小さいか、getRowCount以上の� �合は何も実行されません。

パラメータ:

row - 表示行を指定する整数。0は最初の行

getPathForLocation

public TreePath getPathForLocation(int x, int y)

指定された位置にあるノードのパスを返します。

パラメータ:

x - 表示� �域の左端からの水平距離をピクセル単位で示す整数値(左マージンは除く)

y - 表示� �域の上端からの垂直距離をピクセル単位で示す整数値(上マージンは除く)

戻り値:

指定された位置にあるノードのTreePath

getRowForLocation

public int getRowForLocation(int x, int y)

指定された位置にある行を返します。

パラメータ:

x - 表示� �域の左端からの水平距離をピクセル単位で示す整数値(左マージンは除く)

y - 表示� �域の上端からの垂直距離をピクセル単位で示す整数値(上マージンは除く)

戻り値:

指定された位置に対応する行。指定された位置が表示セルの境界外にある� �合は -1

関連� �目:

• getClosestRowForLocation(int, int)

getClosestPathForLocation

public TreePath getClosestPathForLocation(int x, int y)

x、yにもっとも近いノードへのパスを返します。 現在表示可能なノードがない� �合、またはモデルがない� �合は、nullを返します。そうでない� �合は、常に有効なパスを返します。 ノードが正確にx、yの位置にあるかどうかをテストするには、ノードの境界を取得し、それを基準にx、yをテストします。

パラメータ:

x - 表示� �域の左端からの水平距離をピクセル単位で示す整数値(左マージンは除く)

y - 表示� �域の上端からの垂直距離をピクセル単位で示す整数値(上マージンは除く)

戻り値:

指定された位置にもっとも近いノードの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 - 表示� �域の左端からの水平距離をピクセル単位で示す整数値(左マージンは除く)

y - 表示� �域の上端からの垂直距離をピクセル単位で示す整数値(上マージンは除く)

戻り値:

指定された位置にもっとも近い行。表示可能なノードがないか、モデルが存在しない� �合は -1

関連� �目:

• getRowForLocation(int, int)
• getRowBounds(int)

isEditing

@BeanProperty(bound=false) 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

@BeanProperty(bound=false) public TreePath getEditingPath()

現在編集されている要� のパスを返します。

戻り値:

編集されているノードのTreePath

setSelectionModel

@BeanProperty(description="The tree's selection model.") public void setSelectionModel(TreeSelectionModel selectionModel)

ツリーの選択モデルを設定します。 null値を指定すると、空のselectionModelが使用されます。この� �合、選択は許可されません。

これはバウンド・プロパティです。

パラメータ:

selectionModel - 使用するTreeSelectionModel。選択を無効にする� �合はnull

関連� �目:

• TreeSelectionModel

getSelectionModel

public TreeSelectionModel getSelectionModel()

選択のモデルを返します。 このメソッドは、常にnull以外の値を返します。 選択を許可したくない� �合は、選択モデルをnullに設定して強制的に空の選択モデルを使用します。

戻り値:

選択のモデル

関連� �目:

• setSelectionModel(javax.swing.tree.TreeSelectionModel)

getPathBetweenRows

protected TreePath[] getPathBetweenRows(int index0, int index1)

指定された行の間(この行を含む)のパスを返します。 指定されたインデックスが表示可能な行セット内にあるか、または表示可能な行セットを制限する� �合、インデックスは表示可能な行セットによって制約されます。 指定されたインデックスが表示可能な行セット内にないか、または表示可能な行セットを制限しない� �合、空の配列が返されます。 たとえば、行数が10で、このメソッドが-1, 20で呼び出される� �合、指定されたインデックスは表示可能な行セットに制約され、0, 9で呼び出された� �合と同様に処理されます。 一方、これが-10, -1で呼び出された� �合、指定されたインデックスは表示可能な行セットを制限せず、空の配列が返されます。

パラメータは� �序に依存しません。 つまり、 getPathBetweenRows(x, y)はgetPathBetweenRows(y, x)と同等です。

行数が0、または指定されたインデックスが表示可能な行セットを制限しない� �合、空の配列が返されます。

パラメータ:

index0 - 範囲の1番目のインデックス

index1 - 範囲内の最後のインデックス

戻り値:

指定された行インデックスの間(この行を含む)のパス

setSelectionInterval

public void setSelectionInterval(int index0, int index1)

指定された範囲の行(この行を含む)を選択します。 指定されたインデックスが表示可能な行セット内にあるか、または表示可能な行セットを制限する� �合、指定された行は表示可能な行セットによって制約されます。 指定されたインデックスが表示可能な行セット内にないか、または表示可能な行セットを制限しない� �合、選択がクリアされます。 たとえば、行数が 10で、このメソッドが-1, 20で呼び出される� �合、指定されたインデックスによって表示可能な範囲が制限され、0, 9で呼び出された� �合と同様に処理されます。 一方、これが-10, -1で呼び出された� �合、指定されたインデックスは表示可能な行セットを制限せず、選択がクリアされます。

パラメータは� �序に依存しません。 つまり、 setSelectionInterval(x, y)はsetSelectionInterval(y, x)と同等です。

パラメータ:

index0 - 選択する範囲内の最初のインデックス

index1 - 選択する範囲内の最後のインデックス

addSelectionInterval

public void addSelectionInterval(int index0, int index1)

指定された行(この行を含む)を選択に追� します。 指定されたインデックスが表示可能な行セット内にあるか、または表示可能な行セットを制限する� �合、指定されたインデックスは表示可能な行セットによって制約されます。 インデックスが表示可能な行セット内にないか、または表示可能な行セットを制限しない� �合、選択は変更されません。 たとえば、行数が10で、このメソッドが-1, 20で呼び出される� �合、指定されたインデックスによって表示可能な範囲が制限され、0, 9で呼び出された� �合と同様に処理されます。 一方、これが-10, -1で呼び出された� �合、指定されたインデックスは表示可能な行セットを制限せず、選択は変更されません。

パラメータは� �序に依存しません。 つまり、 addSelectionInterval(x, y)はaddSelectionInterval(y, x)と同等です。

パラメータ:

index0 - 選択に追� する範囲内の最初のインデックス

index1 - 選択に追� する範囲内の最後のインデックス

removeSelectionInterval

public void removeSelectionInterval(int index0, int index1)

指定された行(この行を含む)を選択から削除します。 指定されたインデックスが表示可能な行セット内にあるか、または表示可能な行セットを制限する� �合、指定されたインデックスは表示可能な行セットによって制約されます。 指定されたインデックスが表示可能な行セット内にないか、または表示可能な行セットを制限しない� �合、選択は変更されません。 たとえば、行数が 10で、このメソッドが-1, 20で呼び出される� �合、指定された範囲によって表示可能な範囲が制限され、0, 9で呼び出された� �合と同様に処理されます。 一方、これが-10, -1で呼び出された� �合、指定された範囲は表示可能な行セットを制限せず、選択は変更されません。

パラメータは� �序に依存しません。 つまり、 removeSelectionInterval(x, y)はremoveSelectionInterval(y, x)と同等です。

パラメータ:

index0 - 選択から削除する最初の行

index1 - 選択から削除する最後の行

removeSelectionPath

public void removeSelectionPath(TreePath path)

指定されたパスによって識別されるノードを現在の選択から削除します。

パラメータ:

path - ノードを識別するTreePath

removeSelectionPaths

public void removeSelectionPaths(TreePath[] paths)

指定されたパスによって識別されるノードを現在の選択から削除します。

パラメータ:

paths - 削除するノードを指定するTreePathオブジェクトの配列

removeSelectionRow

public void removeSelectionRow(int row)

インデックスrowにある行を現在の選択から削除します。

パラメータ:

row - 削除する行

removeSelectionRows

public void removeSelectionRows(int[] rows)

指定された各行で選択されている行を削除します。

パラメータ:

rows - 表示行を指定する整数の配列。0が最初の行

clearSelection

public void clearSelection()

選択をクリアします。

isSelectionEmpty

@BeanProperty(bound=false) public boolean isSelectionEmpty()

選択範囲が現在空の� �合にtrueを返します。

戻り値:

選択が現在空である� �合はtrue

addTreeExpansionListener

public void addTreeExpansionListener(TreeExpansionListener tel)

TreeExpansionイベントのリスナーを追� します。

パラメータ:

tel - ツリー・ノードが展開されたとき、または折りたたまれたとき(� の展開)に通知されるTreeExpansionListener

removeTreeExpansionListener

public void removeTreeExpansionListener(TreeExpansionListener tel)

TreeExpansionイベントのリスナーを削除します。

パラメータ:

tel - 削除するTreeExpansionListener

getTreeExpansionListeners

@BeanProperty(bound=false) public TreeExpansionListener[] getTreeExpansionListeners()

addTreeExpansionListener()を使用してこのJTreeに追� されたすべてのTreeExpansionListenerの配列を返します。

戻り値:

追� されたすべてのTreeExpansionListener。リスナーが追� されていない� �合は空の配列

導入されたバージョン:

1.4

addTreeWillExpandListener

public void addTreeWillExpandListener(TreeWillExpandListener tel)

TreeWillExpandイベントのリスナーを追� します。

パラメータ:

tel - ツリー・ノードが展開されたとき、または折りたたまれたとき(� の展開)に通知されるTreeWillExpandListener

removeTreeWillExpandListener

public void removeTreeWillExpandListener(TreeWillExpandListener tel)

TreeWillExpandイベントのリスナーを削除します。

パラメータ:

tel - 削除するTreeWillExpandListener

getTreeWillExpandListeners

@BeanProperty(bound=false) public TreeWillExpandListener[] getTreeWillExpandListeners()

addTreeWillExpandListener()を使用してこのJTreeに追� されたすべてのTreeWillExpandListenerの配列を返します。

戻り値:

追� されたすべてのTreeWillExpandListener。リスナーが追� されていない� �合は空の配列

導入されたバージョン:

1.4

fireTreeExpanded

public void fireTreeExpanded(TreePath path)

このイベント・タイプの通知対象として登録されているすべてのリスナーに通知します。 イベント・インスタンスはpathパラメータで遅延生成されます。

パラメータ:

path - 展開されたノードを示すTreePath

関連� �目:

• EventListenerList

fireTreeCollapsed

public void fireTreeCollapsed(TreePath path)

このイベント・タイプの通知対象として登録されているすべてのリスナーに通知します。 イベント・インスタンスはpathパラメータで遅延生成されます。

パラメータ:

path - 折りたたまれたノードを示すTreePath

関連� �目:

• EventListenerList

fireTreeWillExpand

public void fireTreeWillExpand(TreePath path) throws ExpandVetoException

このイベント・タイプの通知対象として登録されているすべてのリスナーに通知します。 イベント・インスタンスはpathパラメータで遅延生成されます。

パラメータ:

path - 展開されたノードを示すTreePath

スロー:

ExpandVetoException - 展開が発生しない� �合

関連� �目:

• EventListenerList

fireTreeWillCollapse

public void fireTreeWillCollapse(TreePath path) throws ExpandVetoException

このイベント・タイプの通知対象として登録されているすべてのリスナーに通知します。 イベント・インスタンスはpathパラメータで遅延生成されます。

パラメータ:

path - 展開されたノードを示すTreePath

スロー:

ExpandVetoException - 折りたたみが発生しない� �合

関連� �目:

• EventListenerList

addTreeSelectionListener

public void addTreeSelectionListener(TreeSelectionListener tsl)

TreeSelectionイベントのリスナーを追� します。

パラメータ:

tsl - ノードが選択されたとき、または選択解除されたとき(� の選択)に通知されるTreeSelectionListener

removeTreeSelectionListener

public void removeTreeSelectionListener(TreeSelectionListener tsl)

TreeSelectionリスナーを削除します。

パラメータ:

tsl - 削除するTreeSelectionListener

getTreeSelectionListeners

@BeanProperty(bound=false) public TreeSelectionListener[] getTreeSelectionListeners()

addTreeSelectionListener()を使用してこのJTreeに追� されたすべてのTreeSelectionListenerの配列を返します。

戻り値:

追� されたすべてのTreeSelectionListener。リスナーが追� されていない� �合は空の配列

導入されたバージョン:

1.4

fireValueChanged

protected void fireValueChanged(TreeSelectionEvent e)

このイベント・タイプの通知対象として登録されているすべてのリスナーに通知します。

パラメータ:

e - トリガーするTreeSelectionEvent。このイベントは、ノードが選択されるか、選択を解除されるときにTreeSelectionModelによって生成される

関連� �目:

• EventListenerList

treeDidChange

public void treeDidChange()

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

setVisibleRowCount

@BeanProperty(description="The number of rows that are to be displayed.") public void setVisibleRowCount(int newCount)

表示する行数を設定します。 このメソッドは、ツリーがJScrollPaneに� �納されている� �合� け機能し、スクロール・ペインの適切なサイズを調整します。

これはバウンド・プロパティです。

パラメータ:

newCount - 表示する行数

getVisibleRowCount

public int getVisibleRowCount()

表示� �域に表示されている行数を返します。

戻り値:

表示された行数

getNextMatch

public TreePath getNextMatch(String prefix, int startingRow, Position.Bias bias)

prefixで始まる次のツリー要� へのTreePathを返します。 TreePathから文字列への変換を処理するには、convertValueToTextを使います。

パラメータ:

prefix - 一致をテストする文字列

startingRow - 検索を開始する行

bias - 検索方向。Position.Bias.Forward、またはPosition.Bias.Backward。

戻り値:

接� �辞で始まる、次のツリー要� のTreePath。そうでない� �合はnull

スロー:

IllegalArgumentException - prefixがnullの� �合、またはstartingRowが範囲外の� �合

導入されたバージョン:

1.4

getPreferredScrollableViewportSize

@BeanProperty(bound=false) public Dimension getPreferredScrollableViewportSize()

JTreeの適切な表示サイズを返します。 高さはgetVisibleRowCountによって決められ、幅は現在の適切な幅です。

定義:

getPreferredScrollableViewportSize、インタフェースScrollable

戻り値:

適切なサイズを保持するDimensionオブジェクト

関連� �目:

• JComponent.getPreferredSize()

getScrollableUnitIncrement

public int getScrollableUnitIncrement(Rectangle visibleRect, int orientation, int direction)

スクロール時に増分する量を返します。 この量は、完全に表示されていない最初に表示されている行の高さ、またはその行が完全に表示されている� �合は、スクロールする方向にある次の行の高さです。

定義:

getScrollableUnitIncrement、インタフェースScrollable

パラメータ:

visibleRect - ビュー・ポート内の可視のビュー� �域

orientation - SwingConstants.VERTICALまたはSwingConstants.HORIZONTAL

direction - 上または左にスクロールする� �合は0より小さく、下または右にスクロールする� �合は0より大きい

戻り値:

指定された方向にスクロールするための「ユニット」増分値

関連� �目:

• JScrollBar.setUnitIncrement(int)

getScrollableBlockIncrement

public int getScrollableBlockIncrement(Rectangle visibleRect, int orientation, int direction)

ブロック増分値の量を返します。この量は、orientationに基づいたvisibleRectの高さまたは幅です。

定義:

getScrollableBlockIncrement、インタフェースScrollable

パラメータ:

visibleRect - ビュー・ポート内の可視のビュー� �域

orientation - SwingConstants.VERTICALまたはSwingConstants.HORIZONTAL

direction - 上または左にスクロールする� �合は0より小さく、下または右にスクロールする� �合は0より大きい。

戻り値:

指定された方向にスクロールするための「ブロック」増分値

関連� �目:

• JScrollBar.setBlockIncrement(int)

getScrollableTracksViewportWidth

@BeanProperty(bound=false) public boolean getScrollableTracksViewportWidth()

ツリーの適切な幅がビュー・ポートの幅より小さくないかぎり、falseを返して、ビュー・ポートの幅がテーブルの幅を決めないことを示します。 つまり、ツリーがビュー・ポートより小さくならないようにします。

定義:

getScrollableTracksViewportWidth、インタフェースScrollable

戻り値:

ツリーがビュー・ポートの幅を追跡する必要があるかどうか

関連� �目:

• Scrollable.getScrollableTracksViewportWidth()

getScrollableTracksViewportHeight

@BeanProperty(bound=false) public boolean getScrollableTracksViewportHeight()

ツリーの適切な高さがビュー・ポートの高さより小さくないかぎり、falseを返して、ビュー・ポートの高さがテーブルの高さを決めないことを示します。 つまり、ツリーがビュー・ポートより小さくならないようにします。

定義:

getScrollableTracksViewportHeight、インタフェースScrollable

戻り値:

ツリーがビュー・ポートの高さを追跡する必要があるかどうか

関連� �目:

• Scrollable.getScrollableTracksViewportHeight()

setExpandedState

protected void setExpandedState(TreePath path, boolean state)

このJTreeの展開状態を設定します。 stateがtrueの� �合、pathのすべての親およびパスに展開のマークが付けられます。 stateがfalseの� �合、pathのすべての親はEXPANDEDで示されますが、path自体は折りたたまれていることが示されます。

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

パラメータ:

path - ノードを識別するTreePath

state - trueの� �合、pathおよびパスのすべての親が展開済としてマークされます。 それ以外の� �合、pathのすべての親はEXPANDEDとマークされますが、path自体は縮小とマークされます。

getDescendantToggledPaths

protected Enumeration<TreePath> getDescendantToggledPaths(TreePath parent)

parentの下位ノードであり、展開されているTreePathsのEnumerationを返します。

パラメータ:

parent - パス

戻り値:

TreePathsのEnumeration

removeDescendantToggledPaths

protected void removeDescendantToggledPaths(Enumeration<TreePath> toRemove)

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

パラメータ:

toRemove - 削除するパスの列挙。nullの値は無視される

スロー:

ClassCastException - toRemoveにTreePathでない要� が� �納されている� �合。nullの値は無視される

clearToggledPaths

protected void clearToggledPaths()

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

createTreeModelListener

protected TreeModelListener createTreeModelListener()

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

拡張状態の意味の詳細は、前述のJTree descriptionを参照してく� さい。

戻り値:

TreeModelHandlerのインスタンス

removeDescendantSelectedPaths

protected boolean removeDescendantSelectedPaths(TreePath path, boolean includePath)

pathの下位ノードである選択されたすべてのパスを削除します。 includePathがtrueでpathが選択されている� �合は、選択から削除されます。

パラメータ:

path - パス

includePath - trueで、pathが選択されると、選択から削除されます。

戻り値:

下位ノードが選択された� �合はtrue

導入されたバージョン:

1.3

paramString

protected String paramString()

このJTreeの文字列表現を返します。 このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なる可能性があります。 返される文字列は空でもかまいませんが、nullにはできません。

オーバーライド:

paramString、クラスJComponent

戻り値:

このJTreeを表す文字列表現。

getAccessibleContext

@BeanProperty(bound=false) public AccessibleContext getAccessibleContext()

このJTreeに関連付けられたAccessibleContextを取得します。 JTreeの� �合、AccessibleContextはAccessibleJTreeの形式を取ります。 必要に応じて新規のAccessibleJTreeインスタンスが作成されます。

定義:

getAccessibleContext、インタフェースAccessible

オーバーライド:

getAccessibleContext、クラスComponent

戻り値:

このJTreeのAccessibleContextとして機能するAccessibleJTree