public class JTree extends JComponent implements Scrollable, Accessible
ツリーの特定のノードは、ノードおよびすべての上位ノードをカプセル化するオブジェクトである 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 以降、すべての JavaBeansTM 用の長期間の格納サポートが java.beans
パッケージに追加されています。XMLEncoder
を参照してください。
修飾子と型 | クラスと説明 |
---|---|
protected class |
JTree.AccessibleJTree
このクラスは
JTree クラスのアクセシビリティーサポートを実装しています。 |
static 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 を生成し、それをすべてのリスナーに転送します。 |
JComponent.AccessibleJComponent
Container.AccessibleAWTContainer
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
修飾子と型 | フィールドと説明 |
---|---|
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
ツリーが編集できるかどうかを示します。デフォルトは false です。
|
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
一度に可視にする行数です。
|
accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
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)
指定された行 (この行を含む) を選択に追加します。
|
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()
自動ドラッグ処理が有効であるかどうかを返します。
|
JTree.DropLocation |
getDropLocation()
このコンポーネントがコンポーネントのドラッグ&ドロップ時にドロップ位置として視覚的に示す位置を返します。現在位置が表示されていない場合は
null を返します。 |
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)
自動ドラッグ処理をオンまたはオフにします。
|
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 からの通知です。 |
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, 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
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
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, 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, getPeer, 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, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle
protected transient TreeModel treeModel
protected transient TreeSelectionModel selectionModel
protected boolean rootVisible
protected transient TreeCellRenderer cellRenderer
null
の場合、UI はデフォルトの cellRenderer
を使用します。protected int rowHeight
protected boolean showsRootHandles
ハンドルとはノードの横に表示される小さなアイコンであり、ユーザーがクリックするとノードが展開されるか、折りたたまれます。共通のインタフェースは、展開できるノードでプラス符号 (+) を表示し、折りたためるノードではマイナス符号 (-) を表示します。ハンドルは、最上位レベルより下のノードで常に表示されます。
rootVisible
の設定がルートノードの表示を指定する場合は、それが最上位レベルの唯一のノードです。ルートノードが表示されない場合、そのすべての子がツリーの最上位レベルにあります。ハンドルは、最上位以外のノードで常に表示されます。
ルートノードが可視ではない場合、通常はこの値を true に設定します。true に設定しないと、ツリーはリストのように表示され、ユーザーは「リストエントリ」が実際にはツリーノードであることを認識できません。
rootVisible
protected transient JTree.TreeSelectionRedirector selectionRedirector
selectionListeners
に渡します。protected transient TreeCellEditor cellEditor
null
(ツリーは編集できない) です。protected boolean editable
protected boolean largeModel
この値は、UI への単なる提案です。すべての UI がこの値を利用するわけではありません。デフォルト値は false です。
protected int visibleRowCount
Scrollable
インタフェースで使用されます。この値は、表示領域の適切なサイズを決めます。protected boolean invokesStopCellEditing
stopCellEditing
が呼び出され、変更が保存されます。false の場合、cancelCellEditing
が呼び出され、変更は破棄されます。デフォルトは false です。protected boolean scrollsOnExpand
protected int toggleClickCount
protected transient TreeModelListener treeModelListener
expandedState
を更新します。public static final String CELL_RENDERER_PROPERTY
cellRenderer
のバウンドプロパティー名です。public static final String TREE_MODEL_PROPERTY
treeModel
のバウンドプロパティー名です。public static final String ROOT_VISIBLE_PROPERTY
rootVisible
のバウンドプロパティー名です。public static final String SHOWS_ROOT_HANDLES_PROPERTY
showsRootHandles
のバウンドプロパティー名です。public static final String ROW_HEIGHT_PROPERTY
rowHeight
のバウンドプロパティー名です。public static final String CELL_EDITOR_PROPERTY
cellEditor
のバウンドプロパティー名です。public static final String EDITABLE_PROPERTY
editable
のバウンドプロパティー名です。public static final String LARGE_MODEL_PROPERTY
largeModel
のバウンドプロパティー名です。public static final String SELECTION_MODEL_PROPERTY
public static final String VISIBLE_ROW_COUNT_PROPERTY
visibleRowCount
のバウンドプロパティー名です。public static final String INVOKES_STOP_CELL_EDITING_PROPERTY
messagesStopCellEditing
のバウンドプロパティー名です。public static final String SCROLLS_ON_EXPAND_PROPERTY
scrollsOnExpand
のバウンドプロパティー名です。public static final String TOGGLE_CLICK_COUNT_PROPERTY
toggleClickCount
のバウンドプロパティー名です。public static final String LEAD_SELECTION_PATH_PROPERTY
leadSelectionPath
のバウンドプロパティー名です。public static final String ANCHOR_SELECTION_PATH_PROPERTY
public JTree()
JTree
を返します。ツリーが使用するデフォルトモデルは、葉ノードを子のない任意ノードとして定義します。public JTree(Object[] value)
JTree
を返します。デフォルトでは、ツリーは葉ノードを子のない任意のノードとして定義します。value
- Object
の配列DefaultTreeModel.asksAllowsChildren
public JTree(Vector<?> value)
Vector
の各要素を、表示されていない新しいルートノードの子として持つ JTree
を返します。デフォルトでは、ツリーは葉ノードを子のない任意のノードとして定義します。value
- aVector
DefaultTreeModel.asksAllowsChildren
public JTree(Hashtable<?,?> value)
Hashtable
から生成された、ルートを表示しない JTree
を返します。HashTable
のキーと値の組の値側が新しいルートノードの子になります。デフォルトでは、ツリーは葉ノードを子のない任意のノードとして定義します。value
- aHashtable
DefaultTreeModel.asksAllowsChildren
public JTree(TreeNode root)
TreeNode
をルートに持ち、そのルートノードを表示する JTree
を返します。デフォルトでは、ツリーは葉ノードを子のない任意のノードとして定義します。root
- TreeNode
オブジェクトDefaultTreeModel.asksAllowsChildren
public JTree(TreeNode root, boolean asksAllowsChildren)
TreeNode
をルートとして持つ JTree
を返します。root
- TreeNode
オブジェクトasksAllowsChildren
- false の場合、子を持たないすべてのノードが葉ノード。true の場合、子を許可しないノードだけが葉ノードDefaultTreeModel.asksAllowsChildren
@ConstructorProperties(value="model") public JTree(TreeModel newModel)
JTree
のインスタンスを返します。ツリーは、指定されたデータモデルを使用して生成されます。newModel
- データモデルとして使用する TreeModel
protected static TreeModel getDefaultTreeModel()
TreeModel
を生成し、それを返します。何かを興味深く見せるために、主に Beanbuilder で使用されます。TreeModel
protected static TreeModel createTreeModel(Object value)
TreeModel
を返します。次のオブジェクトの場合、Object
の配列、
Hashtable
、または
Vector
"root"
の値で作成されます。value
- TreeModel
の基礎として使用される Object
TreeModel
public TreeUI getUI()
TreeUI
オブジェクトpublic void setUI(TreeUI ui)
これはバウンドプロパティーです。
ui
- TreeUI
L&F オブジェクトUIDefaults.getUI(javax.swing.JComponent)
public void updateUI()
UIManager
からの通知です。現在の UI オブジェクトを UIManager
の最新バージョンに置き換えます。updateUI
、クラス: JComponent
JComponent.updateUI()
public String getUIClassID()
getUIClassID
、クラス: JComponent
JComponent.getUIClassID()
, UIDefaults.getUI(javax.swing.JComponent)
public TreeCellRenderer getCellRenderer()
TreeCellRenderer
を返します。TreeCellRenderer
public void setCellRenderer(TreeCellRenderer x)
TreeCellRenderer
を設定します。
これはバウンドプロパティーです。
x
- 各セルをレンダリングする TreeCellRenderer
public void setEditable(boolean flag)
これはバウンドプロパティーです。
flag
- boolean 値。ツリーが編集可能な場合は truepublic boolean isEditable()
public void setCellEditor(TreeCellEditor cellEditor)
null
値は、ツリーが編集できないことを示します。これが cellEditor
での変更を表す場合、propertyChange
メソッドがすべてのリスナーで呼び出されます。
これはバウンドプロパティーです。
cellEditor
- 使用する TreeCellEditor
public TreeCellEditor getCellEditor()
TreeCellEditor
。ツリーが編集できない場合は null
public TreeModel getModel()
TreeModel
を返します。TreeModel
public void setModel(TreeModel newModel)
TreeModel
を設定します。
これはバウンドプロパティーです。
newModel
- データを提供する TreeModel
public boolean isRootVisible()
rootVisible
public void setRootVisible(boolean rootVisible)
TreeModel
のルートノードが可視かどうかを設定します。
これはバウンドプロパティーです。
rootVisible
- ツリーのルートノードが表示される場合は truerootVisible
public void setShowsRootHandles(boolean newValue)
showsRootHandles
プロパティーの値を設定します。このプロパティーのデフォルト値は、JTree
の作成に使用するコンストラクタによって異なります。一部の Look & Feel ではハンドルがサポートされていない場合があります。その場合、このプロパティーは無視されます。
これはバウンドプロパティーです。
newValue
- ルートハンドルを表示しない場合は true
、そうでない場合は false
showsRootHandles
, getShowsRootHandles()
public boolean getShowsRootHandles()
showsRootHandles
プロパティーの値を返します。showsRootHandles
プロパティーの値showsRootHandles
public void setRowHeight(int rowHeight)
これはバウンドプロパティーです。
rowHeight
- 各セルのピクセル単位の高さpublic int getRowHeight()
public boolean isFixedRowHeight()
public void setLargeModel(boolean newValue)
これはバウンドプロパティーです。
newValue
- UI に対して大きなモデルを提案する場合は truelargeModel
public boolean isLargeModel()
largeModel
public void setInvokesStopCellEditing(boolean newValue)
true
に設定すると、編集が割り込まれたときに変更が自動的に保存されます。
INVOKES_STOP_CELL_EDITING_PROPERTY のプロパティー変更をトリガーします。
newValue
- true の場合、編集が割り込まれたとき stopCellEditing
が呼び出され、データが保存される。false の場合、cancelCellEditing
が呼び出され、変更は破棄されるpublic boolean getInvokesStopCellEditing()
setInvokesStopCellEditing(boolean)
public void setScrollsOnExpand(boolean newValue)
scrollsOnExpand
プロパティーを設定します。このプロパティーは、ツリーをスクロールしたときに以前は非表示だった子を表示するかどうかを示します。このプロパティーは、ツリーをスクロールしたときに、隠されていた子を表示するかどうかを示します。true
(デフォルト) の場合、ノードを展開すると、下位ノードができるだけ多く可視状態になるようにツリーがスクロールされます。一部の Look & Feel では、ノードの展開時にスクロールを必要としないため、このプロパティーは無視されます。
これはバウンドプロパティーです。
newValue
- 展開時のスクロールを使用不可にする場合は false
、使用可能にする場合は true
getScrollsOnExpand()
public boolean getScrollsOnExpand()
scrollsOnExpand
プロパティーの値を返します。scrollsOnExpand
プロパティーの値public void setToggleClickCount(int clickCount)
これはバウンドプロパティーです。
public int getToggleClickCount()
public void setExpandsSelectedPaths(boolean newValue)
expandsSelectedPaths
プロパティーを設定します。true の場合には、TreeSelectionModel
または JTree
が提供するカバーメソッドによりいつでも選択を変更でき、TreePath
の親が展開され可視になります。可視とは、JTree
の可視矩形にかぎらず親パスが展開されている状態を意味します。false の場合、ノード選択を変更すると親はすべて展開されても可視にはなりません。選択モデルのパスを、すべての親を展開し常に非表示にする場合には便利です。
これはバウンドプロパティーです。
newValue
- expandsSelectedPaths
の新規の値public boolean getExpandsSelectedPaths()
expandsSelectedPaths
プロパティーを返します。setExpandsSelectedPaths(boolean)
public void setDragEnabled(boolean b)
true
に設定し、ツリーの TransferHandler
の値を non-null
にしてください。dragEnabled
プロパティーのデフォルト値は false
です。
このプロパティーを受け入れ、ユーザーのドラッグジェスチャーを認識する処理は、Look & Feel 実装 (特にツリーの TreeUI
) によって行われます。自動ドラッグ処理が有効である場合、ほとんどの Look & Feel (BasicLookAndFeel
のサブクラスの Look & Feel を含む) は、ユーザーが項目の上でマウスボタンを押し、マウスを数ピクセル移動すると、ドラッグ&ドロップ操作を開始します。したがって、このプロパティーを true
に設定すると、選択の動作に微妙に影響する場合があります。
このプロパティーを無視するような Look & Feel を使用している場合も、ツリーの TransferHandler
上で exportAsDrag
を呼び出すことにより、ドラッグ&ドロップ操作を開始できます。
b
- 自動ドラッグ処理を有効にするかどうかHeadlessException
- b
が true
で、GraphicsEnvironment.isHeadless()
が true
を返す場合GraphicsEnvironment.isHeadless()
, getDragEnabled()
, JComponent.setTransferHandler(javax.swing.TransferHandler)
, TransferHandler
public boolean getDragEnabled()
dragEnabled
プロパティーの値setDragEnabled(boolean)
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
の場合getDropMode()
, getDropLocation()
, JComponent.setTransferHandler(javax.swing.TransferHandler)
, TransferHandler
public final DropMode getDropMode()
setDropMode(javax.swing.DropMode)
public final JTree.DropLocation getDropLocation()
null
を返します。
このメソッドは、TransferHandler
からドロップ位置を照会する手段にはなりません。ドロップ位置は、TransferHandler
の canImport
が返され、ドロップ位置を表示する準備ができてから設定されるためです。
このプロパティーが変更されると、コンポーネントにより、プロパティー変更イベント dropLocation がトリガーされます。
setDropMode(javax.swing.DropMode)
, TransferHandler.canImport(TransferHandler.TransferSupport)
public boolean isPathEditable(TreePath path)
isEditable
を返します。このメソッドは編集が始まる前に UI から呼び出され、指定されたパスを編集できるようにします。このメソッドは、新しいエディタを作成することなくフィルタ編集を追加するためのサブクラサのエントリポイントとして提供されます。isEditable()
public String getToolTipText(MouseEvent event)
JComponent
の getToolTipText
メソッドをオーバーライドして、テキストセットがある場合にレンダラのヒントを使用できるようにします。
注:JTree
がレンダリングのツールヒントを適切に表示できるようにするには、JTree
が ToolTipManager
に登録済みのコンポーネントでなければいけません。登録するには、ToolTipManager.sharedInstance().registerComponent(tree)
を呼び出します。これは自動的には行われません。
getToolTipText
、クラス: JComponent
event
- ToolTip
の表示を開始した MouseEvent
event
が null
の場合は nullpublic String convertValueToText(Object value, boolean selected, boolean expanded, boolean leaf, int row, boolean hasFocus)
value.toString
を返し、ほかのすべての引数を無視します。変換を制御するには、このメソッドをサブクラス化し、必要な任意の引数を使用します。value
- テキストに変換する Object
selected
- ノードが選択されている場合は trueexpanded
- ノードが展開されている場合は trueleaf
- ノードが葉ノードの場合は truerow
- ノードの表示行を指定する整数。0 が最初の行hasFocus
- ノードがフォーカスを持つ場合は trueString
表現public int getRowCount()
isRootVisible()
が true
の場合にのみこのカウントに含まれます。これは、UI が設定されていない場合は 0
を返します。public void setSelectionPath(TreePath path)
getExpandsSelectedPaths
が true の場合は、表示可能になります。path
- 選択するノードを指定する TreePath
public void setSelectionPaths(TreePath[] paths)
getExpandsSelectedPaths
が true の場合には表示可能になります。paths
- 選択するノードを指定する TreePath
オブジェクトの配列public void setLeadSelectionPath(TreePath newPath)
JTree
によって維持されるのではなく、UI が更新します。
これはバウンドプロパティーです。
newPath
- 新しいリードパスpublic void setAnchorSelectionPath(TreePath newPath)
JTree
によって維持されるのではなく、UI が更新します。
これはバウンドプロパティーです。
newPath
- 新しいアンカーパスpublic void setSelectionRow(int row)
row
- 選択する行。0 は最初の行public void setSelectionRows(int[] rows)
rows
の特定の要素が 0 よりも小さいか、getRowCount
以上の場合、その要素は無視されます。rows
のすべての要素が無効な行である場合、選択はクリアされます。つまり、clearSelection
が呼び出された場合と同じです。rows
- 選択する行を指定する int の配列。0 は最初の行を示すpublic void addSelectionPath(TreePath path)
TreePath
によって識別されるノードを現在の選択に追加します。そのパスのコンポーネントが表示可能ではなく、getExpandsSelectedPaths
が true の場合には表示可能になります。
JTree
では、同じ親の子として同じノードを重複させることはできません。各兄弟ノードは一意のオブジェクトであることが必要です。
path
- 追加する TreePath
public void addSelectionPaths(TreePath[] paths)
getExpandsSelectedPaths
が true の場合には表示可能になります。
JTree
では、同じ親の子として同じノードを重複させることはできません。各兄弟ノードは一意のオブジェクトであることが必要です。
paths
- 追加するノードを指定する TreePath
オブジェクトの配列public void addSelectionRow(int row)
row
- 追加するノードの行を指定する int 値。0 は最初の行public void addSelectionRows(int[] rows)
rows
- 追加する行を指定する int の配列。0 は最初の行を示すpublic Object getLastSelectedPathComponent()
getSelectionModel().getSelectionPath().getLastPathComponent()
の簡易メソッドです。これは、通常、選択範囲にパスが 1 つある場合にしか使用しません。null
TreePath.getLastPathComponent()
public TreePath getLeadSelectionPath()
public TreePath getAnchorSelectionPath()
public TreePath getSelectionPath()
TreePath
。現在何も選択されていない場合は null
public TreePath[] getSelectionPaths()
TreePath
オブジェクトの配列。現在何も選択されていない場合は null
public int[] getSelectionRows()
TreeSelectionModel
に転送されます。何も選択されていない場合は、null
または空の配列が返されます。どちらが返されるかは、TreeSelectionModel
の実装によって異なります。public int getSelectionCount()
public int getMinSelectionRow()
-1
が返されます。public int getMaxSelectionRow()
-1
が返されます。public int getLeadSelectionRow()
leadPath
が null
の場合は -1public boolean isPathSelected(TreePath path)
path
- ノードを識別する TreePath
public boolean isRowSelected(int row)
row
- 表示行を指定する整数。0 は最初の行public Enumeration<TreePath> getExpandedDescendants(TreePath parent)
parent
の下位ノードから成る Enumeration
を返します。parent
が現在展開されていない場合、このメソッドは null
を返します。返された Enumeration
で繰り返している間ノードを展開するか、折りたたむと、このメソッドは展開されたすべてのパスを返すのではなく、それ以上展開されていないパスを返します。parent
- 調べられるパスparent
の下位ノードの Enumeration
。parent
が現在展開されていない場合は、null
public boolean hasBeenExpanded(TreePath path)
path
が今までに展開された場合は truepublic boolean isExpanded(TreePath path)
path
- 調べるノードを指定する TreePath
public boolean isExpanded(int row)
row
- 調べる行。0 は最初の行public boolean isCollapsed(TreePath path)
path
- チェックする TreePath
public boolean isCollapsed(int row)
row
- 調べる行。0 は最初の行public void makeVisible(TreePath path)
path
- 可視にする TreePath
public boolean isVisible(TreePath path)
public Rectangle getPathBounds(TreePath path)
Rectangle
を返します。パスにあるコンポーネントが隠れている (折りたたまれた親の下にある) 場合は null
を返します。
注:
このメソッドは、指定されたノードが現在表示されていない場合でも有効な矩形を返します。
path
- ノードを識別する TreePath
Rectangle
または null
public Rectangle getRowBounds(int row)
Rectangle
を返します。row
- 描画される行。0 は最初の行Rectangle
public void scrollPathToVisible(TreePath path)
JTree
が JScrollPane
に含まれている場合にだけ機能します。path
- 表示するノードを識別する TreePath
public void scrollRowToVisible(int row)
JTree
が JScrollPane
に含まれている場合にだけ機能します。row
- スクロールする行を指定する整数。0 は最初の行public TreePath getPathForRow(int row)
row
が可視でない場合、または TreeUI
が設定されていない場合は null
が返されます。row
- 行を指定する整数TreePath
。row < 0
または row >= getRowCount()
の場合は null
public int getRowForPath(TreePath path)
path
- ノードを識別する TreePath
public void expandPath(TreePath path)
path
- ノードを識別する TreePath
public void expandRow(int row)
row
が 0 よりも小さいか、getRowCount
以上の場合は何もしません。
row
- 表示行を指定する整数。0 は最初の行public void collapsePath(TreePath path)
path
- ノードを識別する TreePath
public void collapseRow(int row)
row
が 0 よりも小さいか、getRowCount
以上の場合は何もしません。
row
- 表示行を指定する整数。0 は最初の行public TreePath getPathForLocation(int x, int y)
x
- 表示領域の左端からの水平距離をピクセル単位で示す整数値 (左マージンは除く)y
- 表示領域の上端からの垂直距離をピクセル単位で示す整数値 (上マージンは除く)TreePath
public int getRowForLocation(int x, int y)
x
- 表示領域の左端からの水平距離をピクセル単位で示す整数値 (左マージンは除く)y
- 表示領域の上端からの垂直距離をピクセル単位で示す整数値 (上マージンは除く)getClosestRowForLocation(int, int)
public TreePath getClosestPathForLocation(int x, int y)
null
が返されます。そうでない場合、このメソッドは常に有効なパスを返します。ノードが正確に x、y の位置にあるかどうかをテストするには、ノードの境界を取得し、それを基準に x、y をテストします。x
- 表示領域の左端からの水平距離をピクセル単位で示す整数値 (左マージンは除く)y
- 表示領域の上端からの垂直距離をピクセル単位で示す整数値 (上マージンは除く)TreePath
。表示可能なノードがない場合、またはモデルがない場合は null
getPathForLocation(int, int)
, getPathBounds(javax.swing.tree.TreePath)
public int getClosestRowForLocation(int x, int y)
x
- 表示領域の左端からの水平距離をピクセル単位で示す整数値 (左マージンは除く)y
- 表示領域の上端からの垂直距離をピクセル単位で示す整数値 (上マージンは除く)getRowForLocation(int, int)
, getRowBounds(int)
public boolean isEditing()
getSelectionPath
を使用して取得できます。getSelectionPath()
public boolean stopEditing()
DefaultTreeCellEditor
オブジェクトは、セル上で進行中の編集をすべて保存します。ほかの実装は異なる動作をする場合があります。ツリーが編集されてない場合は何もしません。
注:
ユーザーがツリー内で移動したときに自動的に編集を保存するには、setInvokesStopCellEditing(boolean)
を使用します。
public void cancelEditing()
public void startEditingAtPath(TreePath path)
CellEditor
が指定された項目の編集を許可しない場合、編集の試みは失敗します。path
- ノードを識別する TreePath
public TreePath getEditingPath()
TreePath
public void setSelectionModel(TreeSelectionModel selectionModel)
null
値を指定すると空の selectionModel
が使用されます。この場合、選択は許可されません。
これはバウンドプロパティーです。
selectionModel
- 使用する TreeSelectionModel
。選択を無効にする場合は null
TreeSelectionModel
public TreeSelectionModel getSelectionModel()
null
以外の値を返します。選択を許可したくない場合は、選択モデルを null
に設定して強制的に空の選択モデルを使用します。protected TreePath[] getPathBetweenRows(int index0, int index1)
10
で、このメソッドが -1, 20
で呼び出される場合、指定されたインデックスは表示可能な行セットに制約され、0, 9
で呼び出された場合と同様に処理されます。一方、これが -10, -1
で呼び出された場合、指定されたインデックスは表示可能な行セットを制限せず、空の配列が返されます。
パラメータは順序に依存しません。つまり、getPathBetweenRows(x, y)
は getPathBetweenRows(y, x)
と同等です。
行数が 0
、または指定されたインデックスが表示可能な行セットを制限しない場合、空の配列が返されます。
index0
- 範囲の 1 番目のインデックスindex1
- 範囲内の最後のインデックスpublic void setSelectionInterval(int index0, int index1)
10
で、このメソッドが -1, 20
で呼び出される場合、指定されたインデックスによって表示可能な範囲が制限され、0, 9
で呼び出された場合と同様に処理されます。一方、これが -10, -1
で呼び出された場合、指定されたインデックスは表示可能な行セットを制限せず、選択がクリアされます。
パラメータは順序に依存しません。つまり、setSelectionInterval(x, y)
は setSelectionInterval(y, x)
と同等です。
index0
- 選択する範囲内の最初のインデックスindex1
- 選択する範囲内の最後のインデックスpublic void addSelectionInterval(int index0, int index1)
10
で、このメソッドが -1, 20
で呼び出される場合、指定されたインデックスによって表示可能な範囲が制限され、0, 9
で呼び出された場合と同様に処理されます。一方、これが -10, -1
で呼び出された場合、指定されたインデックスは表示可能な行セットを制限せず、選択は変更されません。
パラメータは順序に依存しません。つまり、addSelectionInterval(x, y)
は addSelectionInterval(y, x)
と同等です。
index0
- 選択に追加する範囲内の最初のインデックスindex1
- 選択に追加する範囲内の最後のインデックスpublic void removeSelectionInterval(int index0, int index1)
10
で、このメソッドが -1, 20
で呼び出される場合、指定された範囲によって表示可能な範囲が制限され、0, 9
で呼び出された場合と同様に処理されます。一方、これが -10, -1
で呼び出された場合、指定された範囲は表示可能な行セットを制限せず、選択は変更されません。
パラメータは順序に依存しません。つまり、removeSelectionInterval(x, y)
は removeSelectionInterval(y, x)
と同等です。
index0
- 選択から削除する最初の行index1
- 選択から削除する最後の行public void removeSelectionPath(TreePath path)
path
- ノードを識別する TreePath
public void removeSelectionPaths(TreePath[] paths)
paths
- 削除するノードを指定する TreePath
オブジェクトの配列public void removeSelectionRow(int row)
row
にある行を現在の選択から削除します。row
- 削除する行public void removeSelectionRows(int[] rows)
rows
- 表示行を指定する整数の配列。0 が最初の行public void clearSelection()
public boolean isSelectionEmpty()
public void addTreeExpansionListener(TreeExpansionListener tel)
TreeExpansion
イベントのリスナーを追加します。tel
- ツリーノードが展開されたとき、または折りたたまれたとき (負の展開) に通知される TreeExpansionListenerpublic void removeTreeExpansionListener(TreeExpansionListener tel)
TreeExpansion
イベントのリスナーを削除します。tel
- 削除する TreeExpansionListener
public TreeExpansionListener[] getTreeExpansionListeners()
TreeExpansionListener
の配列を返します。TreeExpansionListener
。リスナーが追加されていない場合は空の配列public void addTreeWillExpandListener(TreeWillExpandListener tel)
TreeWillExpand
イベントのリスナーを追加します。tel
- ツリーノードが展開されたとき、または折りたたまれたとき (負の展開) に通知される TreeWillExpandListener
public void removeTreeWillExpandListener(TreeWillExpandListener tel)
TreeWillExpand
イベントのリスナーを削除します。tel
- 削除する TreeWillExpandListener
public TreeWillExpandListener[] getTreeWillExpandListeners()
TreeWillExpandListener
の配列を返します。TreeWillExpandListener
。リスナーが追加されていない場合は空の配列public void fireTreeExpanded(TreePath path)
path
パラメータで遅延生成されます。path
- 展開されたノードを示す TreePath
EventListenerList
public void fireTreeCollapsed(TreePath path)
path
パラメータで遅延生成されます。path
- 折りたたまれたノードを示す TreePath
EventListenerList
public void fireTreeWillExpand(TreePath path) throws ExpandVetoException
path
パラメータで遅延生成されます。path
- 展開されたノードを示す TreePath
ExpandVetoException
EventListenerList
public void fireTreeWillCollapse(TreePath path) throws ExpandVetoException
path
パラメータで遅延生成されます。path
- 展開されたノードを示す TreePath
ExpandVetoException
EventListenerList
public void addTreeSelectionListener(TreeSelectionListener tsl)
TreeSelection
イベントのリスナーを追加します。tsl
- ノードが選択されたとき、または選択解除されたとき (負の選択) に通知される TreeSelectionListener
public void removeTreeSelectionListener(TreeSelectionListener tsl)
TreeSelection
リスナーを削除します。tsl
- 削除する TreeSelectionListener
public TreeSelectionListener[] getTreeSelectionListeners()
TreeSelectionListener
の配列を返します。TreeSelectionListener
。リスナーが追加されていない場合は空の配列protected void fireValueChanged(TreeSelectionEvent e)
e
- トリガーする TreeSelectionEvent
。このイベントは、ノードが選択されるか、選択を解除されるときに TreeSelectionModel
によって生成されるEventListenerList
public void treeDidChange()
public void setVisibleRowCount(int newCount)
JScrollPane
に格納されている場合だけ機能し、スクロールペインの適切なサイズを調整します。
これはバウンドプロパティーです。
newCount
- 表示する行数public int getVisibleRowCount()
public TreePath getNextMatch(String prefix, int startingRow, Position.Bias bias)
TreePath
から文字列への変換を処理するには、convertValueToText
を使います。prefix
- 一致をテストする文字列startingRow
- 検索を開始する行bias
- 検索方向。Position.Bias.Forward、または Position.Bias.Backward。IllegalArgumentException
- prefix が null の場合、または startingRow が範囲外の場合public Dimension getPreferredScrollableViewportSize()
JTree
の適切な表示サイズを返します。高さは getVisibleRowCount
によって決められ、幅は現在の適切な幅です。getPreferredScrollableViewportSize
、インタフェース: Scrollable
Dimension
オブジェクトJComponent.getPreferredSize()
public int getScrollableUnitIncrement(Rectangle visibleRect, int orientation, int direction)
getScrollableUnitIncrement
、インタフェース: Scrollable
visibleRect
- ビューポート内の可視のビュー領域orientation
- SwingConstants.VERTICAL
または SwingConstants.HORIZONTAL
direction
- 上または左にスクロールする場合は 0 より小さく、下または右にスクロールする場合は 0 より大きいJScrollBar.setUnitIncrement(int)
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)
public boolean getScrollableTracksViewportWidth()
getScrollableTracksViewportWidth
、インタフェース: Scrollable
Scrollable.getScrollableTracksViewportWidth()
public boolean getScrollableTracksViewportHeight()
getScrollableTracksViewportHeight
、インタフェース: Scrollable
Scrollable.getScrollableTracksViewportHeight()
protected void setExpandedState(TreePath path, boolean state)
JTree
の展開状態を設定します。state
が true の場合、path
のすべての親およびパスに展開のマークが付けられます。state
が false の場合、path
のすべての親は EXPANDED で示されますが、path
自体は折りたたまれていることが示されます。
これは、TreeWillExpandListener
に拒否される場合は失敗します。
protected Enumeration<TreePath> getDescendantToggledPaths(TreePath parent)
parent
の下位ノードであり、展開されている TreePaths
の Enumeration
を返します。protected void removeDescendantToggledPaths(Enumeration<TreePath> toRemove)
toRemove
にある、展開されている TreePaths
の下位ノードを削除します。toRemove
- 削除するパスの列挙。null
の値は無視されるClassCastException
- toRemove
に TreePath
でない要素が格納されている場合。null
の値は無視されるprotected void clearToggledPaths()
TreeExpansionListener
イベントを送出しません。protected TreeModelListener createTreeModelListener()
TreeModelHandler
のインスタンスを生成し、それを返します。返されたオブジェクトは、TreeModel
が変更されたときに展開状態を更新します。
展開状態の詳細は上記の JTree の説明を参照してください。
protected boolean removeDescendantSelectedPaths(TreePath path, boolean includePath)
path
の下位ノードである選択されたすべてのパスを削除します。includePath
が true で path
が選択されている場合は、選択から削除されます。protected String paramString()
JTree
の文字列表現を返します。このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なります。返される文字列は空の場合がありますが、null
にはなりません。paramString
、クラス: JComponent
JTree
を表す文字列表現。public AccessibleContext getAccessibleContext()
getAccessibleContext
、インタフェース: Accessible
getAccessibleContext
、クラス: JComponent
バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.