|
JavaTM 2 Platform Std. Ed. v1.3 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object | +--java.awt.Component | +--java.awt.Container | +--javax.swing.JComponent | +--javax.swing.JTree
階層データのセットをアウトラインで表示するコントロールです。タスク指向のマニュアルおよびツリーの使用例については、「The Java Tutorial」 のセクション 「How to Use Trees」を参照してください。
ツリーの特定のノードは、ノードおよびすべての上位ノードをカプセル化するオブジェクトである TreePath
または、表示領域の各行が 1 つのノードを表示する表示行により識別されます。「展開された」ノードはその子を表示します。「収納された」 ノードは子を隠します。「隠された」ノードは収納された親の下にあります。すべての「表示可能」ノードの親は展開されますが表示される場合とされない場合があります。「表示」ノードは表示可能であり、表示領域にあります。
次の 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
を関連付け、指定した条件でアクションを実行できます。
標準の Look & Feel (L&F) 表現でこのコンポーネントが使用するキーボードのキーについては、JTree のキーの割り当てを参照してください。
警告: このクラスの直列化されたオブジェクトは、今後の Swing リリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の運用や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。今後の Swing リリースでは、長期間の持続性をサポートする予定です。
内部クラスの概要 | |
protected class |
JTree.AccessibleJTree
このクラスは JTree クラス用のユーザ補助機能のサポートを実装しています。 |
static class |
JTree.DynamicUtilTreeNode
DynamicUtilTreeNode は、ベクタ、ハッシュテーブル、配列、および文字列をラップし、必要に応じて適切な子ツリーノードを作成できます。 |
protected static class |
JTree.EmptySelectionModel
EmptySelectionModel は、何の選択も許可しない TreeSelectionModel です。
|
protected class |
JTree.TreeModelHandler
モデルを監視し、ノードが削除または変更された場合にそれに応じて expandedState を更新します。 |
protected class |
JTree.TreeSelectionRedirector
JTree をソースとして新しい TreeSelectionEvent を生成し、それをすべてのリスナーに転送します。
|
クラス javax.swing.JComponent から継承した内部クラス |
JComponent.AccessibleJComponent |
クラス java.awt.Container から継承した内部クラス |
Container.AccessibleAWTContainer |
クラス java.awt.Component から継承した内部クラス |
Component.AccessibleAWTComponent |
フィールドの概要 | |
static String |
ANCHOR_SELECTION_PATH_PROPERTY
アンカー選択パスのバウンドプロパティ名です。 |
static String |
CELL_EDITOR_PROPERTY
cellEditor のバウンドプロパティ名です。 |
static String |
CELL_RENDERER_PROPERTY
cellRenderer のバウンドプロパティ名です。 |
protected TreeCellEditor |
cellEditor
エントリのエディタです。 |
protected TreeCellRenderer |
cellRenderer
ノードを描画するために使用されるセルです。 |
protected boolean |
editable
ツリーが編集できるかどうかを示します。 |
static String |
EDITABLE_PROPERTY
editable のバウンドプロパティ名です。 |
static String |
EXPANDS_SELECTED_PATHS_PROPERTY
選択パスのプロパティを展開するバウンドプロパティ名です。 |
static String |
INVOKES_STOP_CELL_EDITING_PROPERTY
messagesStopCellEditing のバウンドプロパティ名です。 |
protected boolean |
invokesStopCellEditing
true の場合、選択の変更、ツリー内のデータの変更、またはほかの手段によって編集が停止されたときに、 stopCellEditing が呼び出され、変更が保存されます。 |
static String |
LARGE_MODEL_PROPERTY
largeModel のバウンドプロパティ名です。 |
protected boolean |
largeModel
このツリーが大きなモデルかどうかを示します。 |
static String |
LEAD_SELECTION_PATH_PROPERTY
leadSelectionPath のバウンドプロパティ名です。 |
static String |
ROOT_VISIBLE_PROPERTY
rootVisible のバウンドプロパティ名です。 |
protected boolean |
rootVisible
ルートノードが表示されている場合は true、その子が最上位の可視ノードである場合は false です。 |
static String |
ROW_HEIGHT_PROPERTY
rowHeight のバウンドプロパティ名です。 |
protected int |
rowHeight
各表示行に使用する高さです。 |
static String |
SCROLLS_ON_EXPAND_PROPERTY
scrollsOnExpand のバウンドプロパティ名です。 |
protected boolean |
scrollsOnExpand
true の場合、ノードが展開されると、そのすべての下位ノードが可視になるようにスクロールされます。 |
static String |
SELECTION_MODEL_PROPERTY
selectionModel のバウンドプロパティ名です。 |
protected TreeSelectionModel |
selectionModel
このツリー内の選択されたノードのセットをモデル化します。 |
protected JTree.TreeSelectionRedirector |
selectionRedirector
新しいイベントを生成し、それを selectionListeners に渡します。 |
static String |
SHOWS_ROOT_HANDLES_PROPERTY
showsRootHandles のバウンドプロパティ名です。 |
protected boolean |
showsRootHandles
ハンドルがツリーの最上位レベルに表示されている場合は true です。 |
static String |
TOGGLE_CLICK_COUNT_PROPERTY
toggleClickCount のバウンドプロパティ名です。 |
protected int |
toggleClickCount
ノードを展開するために必要なマウスクリックの数です。 |
static String |
TREE_MODEL_PROPERTY
treeModel のバウンドプロパティ名です。 |
protected TreeModel |
treeModel
このオブジェクトによって表示されるツリーを定義するモデルです。 |
protected TreeModelListener |
treeModelListener
expandedState を更新します。 |
static String |
VISIBLE_ROW_COUNT_PROPERTY
visibleRowCount のバウンドプロパティ名です。 |
protected int |
visibleRowCount
一度に可視にする行数です。 |
クラス javax.swing.JComponent から継承したフィールド |
accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW |
クラス java.awt.Component から継承したフィールド |
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT |
インタフェース java.awt.image.ImageObserver から継承したフィールド |
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH |
コンストラクタの概要 | |
JTree()
サンプルモデルを持つ JTree を返します。 |
|
JTree(Hashtable value)
Hashtable から生成された、ルートを表示しない JTree を返します。 |
|
JTree(Object[] value)
指定された配列の各要素を、表示されていない新しいルートノードの子として持つ JTree を返します。 |
|
JTree(TreeModel newModel)
ルートノードを表示する JTree のインスタンスを返します。 |
|
JTree(TreeNode root)
指定された TreeNode をルートに持つ、ルートノードを表示する JTree を返します。 |
|
JTree(TreeNode root,
boolean asksAllowsChildren)
ルートノードを表示し、ノードが葉ノードかどうかを指定された方法で決める、指定された TreeNode をルートとして持つ JTree を返します。 |
|
JTree(Vector value)
指定された Vector の各要素を、表示されていない新しいルートノードの子として持つ JTree を返します。 |
メソッドの概要 | |
void |
addSelectionInterval(int index0,
int index1)
index0 から index1 までのパスを選択に追加します。 |
void |
addSelectionPath(TreePath path)
指定された TreePath によって識別されるノードを現在の選択に追加します。 |
void |
addSelectionPaths(TreePath[] paths)
パスの配列の各パスを現在の選択に追加します。 |
void |
addSelectionRow(int row)
指定された行にあるパスを現在の選択に追加します。 |
void |
addSelectionRows(int[] rows)
指定された各行にあるパスを現在の選択に追加します。 |
void |
addTreeExpansionListener(TreeExpansionListener tel)
TreeExpansion イベントのリスナーを追加します。 |
void |
addTreeSelectionListener(TreeSelectionListener tsl)
TreeSelection イベントのリスナーを追加します。 |
void |
addTreeWillExpandListener(TreeWillExpandListener tel)
TreeWillExpand イベントのリスナーを追加します。 |
void |
cancelEditing()
現在の編集セッションを取り消します。 |
void |
clearSelection()
選択をクリアします。 |
protected void |
clearToggledPaths()
切り替えられたツリーパスのキャッシュをクリアします。 |
void |
collapsePath(TreePath path)
指定されたパスによって識別されるノードが収納され、表示可能になるようにします。 |
void |
collapseRow(int row)
指定された行にあるノードが収納されているようにします。 |
String |
convertValueToText(Object value,
boolean selected,
boolean expanded,
boolean leaf,
int row,
boolean hasFocus)
レンダリングによって呼び出され、指定された値をテキストに変換します。 |
protected static TreeModel |
createTreeModel(Object value)
指定されたオブジェクトをラップする TreeModel を返します。 |
protected TreeModelListener |
createTreeModelListener()
TreeModelHandler のインスタンスを生成して返します。 |
void |
expandPath(TreePath path)
指定されたパスによって識別されるノードが展開され、表示可能になるようにします。 |
void |
expandRow(int row)
指定された行にあるノードが展開され、表示可能になるようにします。 |
void |
fireTreeCollapsed(TreePath path)
このイベントタイプの通知を受けるように登録されたすべてのリスナーに通知します。 |
void |
fireTreeExpanded(TreePath path)
このイベントタイプへの通知を配信対象に登録しているリスナーすべてに通知します。 |
void |
fireTreeWillCollapse(TreePath path)
このイベントタイプの通知を受けるように登録されたすべてのリスナーに通知します。 |
void |
fireTreeWillExpand(TreePath path)
このイベントタイプの通知を受けるように登録されたすべてのリスナーに通知します。 |
protected void |
fireValueChanged(TreeSelectionEvent e)
このイベントタイプの通知を配信対象として登録しているリスナーすべてに通知します。 |
AccessibleContext |
getAccessibleContext()
この JTree に関連した AccessibleContext を返します。 |
TreePath |
getAnchorSelectionPath()
アンカーと識別されたパスを返します。 |
TreeCellEditor |
getCellEditor()
ツリーのエントリを編集するために使用されるエディタを返します。 |
TreeCellRenderer |
getCellRenderer()
各セルを描画している現在の TreeCellRenderer を返します。 |
TreePath |
getClosestPathForLocation(int x,
int y)
x、y にもっとも近いノードのパスを返します。 |
int |
getClosestRowForLocation(int x,
int y)
x、y にもっとも近いノードの行を返します。 |
protected static TreeModel |
getDefaultTreeModel()
サンプル TreeModel を生成し、それを返します。 |
protected Enumeration |
getDescendantToggledPaths(TreePath parent)
parent の下位ノードであり、展開されている TreePaths の Enumeration を返します。 |
TreePath |
getEditingPath()
現在編集されている要素のパスを返します。 |
Enumeration |
getExpandedDescendants(TreePath parent)
現在展開されているパス parent の下位ノードから成る Enumeration を返します。 |
boolean |
getExpandsSelectedPaths()
expandsSelectedPaths プロパティを返します。 |
boolean |
getInvokesStopCellEditing()
編集が割り込まれたときに何をするかを示すインジケータを返します。 |
Object |
getLastSelectedPathComponent()
現在の選択の最初のノードにある最後のパスコンポーネントを返します。 |
TreePath |
getLeadSelectionPath()
リードと識別されたパスを返します。 |
int |
getLeadSelectionRow()
リードパスに対応する行のインデックスを返します。 |
int |
getMaxSelectionRow()
選択されている最後の行を返します。 |
int |
getMinSelectionRow()
選択されている最初の行を返します。 |
TreeModel |
getModel()
データを提供している TreeModel を返します。 |
protected TreePath[] |
getPathBetweenRows(int index0,
int index1)
index0 から index1 までのパスを表す JTreePath のインスタンスを返します。 |
Rectangle |
getPathBounds(TreePath path)
指定されたノードが描画される Rectangle を返します。 |
TreePath |
getPathForLocation(int x,
int y)
指定された位置にあるノードのパスを返します。 |
TreePath |
getPathForRow(int row)
指定された行のパスを返します。 |
Dimension |
getPreferredScrollableViewportSize()
JTree の適切な表示サイズを返します。 |
Rectangle |
getRowBounds(int row)
指定された行にあるノードが描画される Rectangle を返します。 |
int |
getRowCount()
現在表示されている行数を返します。 |
int |
getRowForLocation(int x,
int y)
指定された位置にある行を返します。 |
int |
getRowForPath(TreePath path)
指定されたパスによって識別されるノードを表示する行を返します。 |
int |
getRowHeight()
各行の高さを返します。 |
int |
getScrollableBlockIncrement(Rectangle visibleRect,
int orientation,
int direction)
「ブロック」増分値の量を返します。 |
boolean |
getScrollableTracksViewportHeight()
ツリーの適切な高さがビューポートの高さより小さくない限り、false を返して、ビューポートの高さがテーブルの高さを決めないことを示します。 |
boolean |
getScrollableTracksViewportWidth()
ツリーの適切な幅がビューポートの幅より小さくない限り、false を返して、ビューポートの幅がテーブルの幅を決めないことを示します。 |
int |
getScrollableUnitIncrement(Rectangle visibleRect,
int orientation,
int direction)
スクロール時に増分する量を返します。 |
boolean |
getScrollsOnExpand()
隠れていた子を表示するためにツリーをスクロールする場合に true を返します。 |
int |
getSelectionCount()
選択されたノードの数を返します。 |
TreeSelectionModel |
getSelectionModel()
選択のモデルを返します。 |
TreePath |
getSelectionPath()
選択された最初のノードのパスを返します。 |
TreePath[] |
getSelectionPaths()
選択されたすべての値のパスを返します。 |
int[] |
getSelectionRows()
現在選択されているすべての行を返します。 |
boolean |
getShowsRootHandles()
ルートノードのハンドルが表示されている場合に true を返します。 |
int |
getToggleClickCount()
ノードを展開したり閉じるときに必要なマウスクリックの回数を返します。 |
String |
getToolTipText(MouseEvent event)
JComponent の getToolTipText メソッドをオーバーライドして、レンダリングのヒント (テキストセットがある場合) を使用できるようにします。
|
TreeUI |
getUI()
このコンポーネントを描画する L&F オブジェクトを返します。 |
String |
getUIClassID()
このコンポーネントを描画する L&F クラスの名前を返します。 |
int |
getVisibleRowCount()
表示領域に表示されている行数を返します。 |
boolean |
hasBeenExpanded(TreePath path)
パスによって識別されるノードが今までに展開されたことがある場合に true を返します。 |
boolean |
isCollapsed(int row)
指定された表示行にあるノードが収納されている場合に true を返します。 |
boolean |
isCollapsed(TreePath path)
パスによって識別される値が現在収納されている場合に true を返します。 |
boolean |
isEditable()
ツリーが編集可能な場合に true を返します。 |
boolean |
isEditing()
ツリーが編集されている場合に true を返します。 |
boolean |
isExpanded(int row)
指定された表示行にあるノードが現在展開されている場合に true を返します。 |
boolean |
isExpanded(TreePath path)
パスによって識別されるノードが現在展開されている場合に true を返します。 |
boolean |
isFixedRowHeight()
各表示行の高さが固定サイズの場合に true を返します。 |
boolean |
isLargeModel()
ツリーが大きなモデル用に設定されている場合に true を返します。 |
boolean |
isPathEditable(TreePath path)
isEditable を返します。 |
boolean |
isPathSelected(TreePath path)
パスによって識別される項目が現在選択されている場合に true を返します。 |
boolean |
isRootVisible()
ツリーのルートノードが表示されている場合に true を返します。 |
boolean |
isRowSelected(int row)
行によって識別されるノードが選択されている場合に true を返します。 |
boolean |
isSelectionEmpty()
選択範囲が現在空の場合に true を返します。 |
boolean |
isVisible(TreePath path)
パスによって識別される値が現在表示可能である場合、つまりそれがルートであるか、そのすべての親が展開されている場合に true を返します。 |
void |
makeVisible(TreePath path)
パスによって識別されるノードが現在表示可能であるようにします。 |
protected String |
paramString()
この JTree の文字列表現を返します。 |
protected boolean |
removeDescendantSelectedPaths(TreePath path,
boolean includePath)
path の下位ノードである選択されたすべてのパスを削除します。 |
protected void |
removeDescendantToggledPaths(Enumeration toRemove)
toRemove にある、展開されている TreePaths の下位ノードを削除します。 |
void |
removeSelectionInterval(int index0,
int index1)
index0 から index1 までのノードを選択から削除します。 |
void |
removeSelectionPath(TreePath path)
指定されたパスによって識別されるノードを現在の選択から削除します。 |
void |
removeSelectionPaths(TreePath[] paths)
指定されたパスによって識別されるノードを現在の選択から削除します。 |
void |
removeSelectionRow(int row)
インデックス row にあるパスを現在の選択から削除します。 |
void |
removeSelectionRows(int[] rows)
指定された各行で選択されているパスを削除します。 |
void |
removeTreeExpansionListener(TreeExpansionListener tel)
TreeExpansion イベントのリスナーを削除します。 |
void |
removeTreeSelectionListener(TreeSelectionListener tsl)
TreeSelection リスナーを削除します。 |
void |
removeTreeWillExpandListener(TreeWillExpandListener tel)
TreeWillExpand イベントのリスナーを削除します。 |
void |
scrollPathToVisible(TreePath path)
パスにあるすべてのパスコンポーネント (最後のパスコンポーネントは除く) を展開し、パスによって指定されるノードが表示されるようにスクロールします。 |
void |
scrollRowToVisible(int row)
行によって識別される項目を表示されるまでスクロールします。 |
void |
setAnchorSelectionPath(TreePath newPath)
アンカーとして識別するパスを設定します。 |
void |
setCellEditor(TreeCellEditor cellEditor)
セルエディタを設定します。 |
void |
setCellRenderer(TreeCellRenderer x)
各セルを描画するために使用される TreeCellRenderer を設定します。 |
void |
setEditable(boolean flag)
ツリーが編集可能かどうかを設定します。 |
protected void |
setExpandedState(TreePath path,
boolean state)
この JTree の展開状態を設定します。 |
void |
setExpandsSelectedPaths(boolean newValue)
expandsSelectedPaths プロパティを設定します。 |
void |
setInvokesStopCellEditing(boolean newValue)
ツリーの別のノードの選択、ツリーのデータの変更、またはほかの手段によって編集が割り込まれたときに何をするかを設定します。 |
void |
setLargeModel(boolean newValue)
UI が大きなモデルを使用するかどうかを設定します (すべての UI がこれを実装するわけではない)。 |
void |
setLeadSelectionPath(TreePath newPath)
リードとして識別するパスを設定します。 |
void |
setModel(TreeModel newModel)
データを提供する TreeModel を設定します。 |
void |
setRootVisible(boolean rootVisible)
TreeModel のルートノードが可視かどうかを判定します。 |
void |
setRowHeight(int rowHeight)
各セルの高さをピクセル単位で設定します。 |
void |
setScrollsOnExpand(boolean newValue)
ノードが展開されたときに、できるだけ多くの下位ノードがビューポート内にスクロールされるかどうかを設定します。 |
void |
setSelectionInterval(int index0,
int index1)
index0 から index1 までのノードを選択します。 |
void |
setSelectionModel(TreeSelectionModel selectionModel)
ツリーの選択モデルを設定します。 |
void |
setSelectionPath(TreePath path)
指定されたパスで識別されるノードを選択します。 |
void |
setSelectionPaths(TreePath[] paths)
指定されたパスの配列によって識別されるノードを選択します。 |
void |
setSelectionRow(int row)
指定された表示行にあるノードを選択します。 |
void |
setSelectionRows(int[] rows)
指定された各表示行に対応するノードを選択します。 |
void |
setShowsRootHandles(boolean newValue)
ノードのハンドルが表示されるかどうかを決めます。 |
void |
setToggleClickCount(int clickCount)
ノードを展開したり閉じるために必要なマウスクリックの回数を設定します。 |
void |
setUI(TreeUI ui)
このコンポーネントを描画する L&F オブジェクトを設定します。 |
void |
setVisibleRowCount(int newCount)
表示する行数を設定します。 |
void |
startEditingAtPath(TreePath path)
指定されたパスによって識別されるノードを選択し、編集を開始します。 |
boolean |
stopEditing()
現在の編集セッションを終了します。 |
void |
treeDidChange()
ツリーの変更が、境界をサイズ変更する必要があるほど大きいが、展開されたノードセットを削除するほどではない場合に送られます (たとえば、ノードが展開されるか、収納されたとき、またはノードがツリーに挿入されたとき)。 |
void |
updateUI()
L&F が変更されたという UIManager からの通知です。 |
クラス java.lang.Object から継承したメソッド |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
フィールドの詳細 |
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
selectionModel
のバウンドプロパティ名です。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 static final String EXPANDS_SELECTED_PATHS_PROPERTY
コンストラクタの詳細 |
public JTree()
JTree
を返します。ツリーが使用するデフォルトモデルは、葉ノードを子のない任意ノードとして定義します。DefaultTreeModel.asksAllowsChildren
public JTree(Object[] value)
JTree
を返します。デフォルトでは、ツリーは葉ノードを子のない任意ノードとして定義します。value
- Object
の配列DefaultTreeModel.asksAllowsChildren
public JTree(Vector value)
Vector
の各要素を、表示されていない新しいルートノードの子として持つ JTree
を返します。デフォルトでは、ツリーは葉ノードを子のない任意ノードとして定義します。value
- Vector
DefaultTreeModel.asksAllowsChildren
public JTree(Hashtable value)
Hashtable
から生成された、ルートを表示しない JTree
を返します。HashTable
のキーと値の組の値側が新しいルートノードの子になります。デフォルトでは、ツリーは葉ノードを子のない任意のノードとして定義します。value
- Hashtable
DefaultTreeModel.asksAllowsChildren
public JTree(TreeNode root)
JTree
を返します。デフォルトでは、ツリーは葉ノードを子のない任意のノードとして定義します。root
- TreeNode
オブジェクトDefaultTreeModel.asksAllowsChildren
public JTree(TreeNode root, boolean asksAllowsChildren)
TreeNode
をルートとして持つ JTree
を返します。root
- TreeNode
オブジェクトasksAllowsChildren
- false の場合、子を持たないすべてのノードが葉ノード。true の場合、子を許可しないノードだけが葉ノードDefaultTreeModel.asksAllowsChildren
public JTree(TreeModel newModel)
JTree
のインスタンスを返します。ツリーは、指定されたデータモデルを使用して生成されます。newModel
- データモデルとして使用する TreeModel
メソッドの詳細 |
protected static TreeModel getDefaultTreeModel()
TreeModel
を生成し、それを返します。何かを興味深く見せるために、主に Beanbuilder で使用されます。TreeModel
protected static TreeModel createTreeModel(Object value)
TreeModel
を返します。オブジェクトが次のどれかの場合です。
Object
の配列
Hashtable
Vector
value
- TreeModel
の基礎として使用される Object
TreeModel
public TreeUI getUI()
public void setUI(TreeUI ui)
ui
- TreeUI の L&F オブジェクトUIDefaults.getUI(javax.swing.JComponent)
public void updateUI()
UIManager
からの通知です。現在の UI オブジェクトを UIManager
からの最新バージョンに置き換えます。JComponent
内の updateUI
JComponent.updateUI()
public String getUIClassID()
JComponent
内の getUIClassID
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)
newValue
- ルートのハンドルが表示される場合は trueshowsRootHandles
public boolean getShowsRootHandles()
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)
public boolean getScrollsOnExpand()
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 boolean isPathEditable(TreePath path)
isEditable
を返します。このメソッドは編集が始まる前に UI から呼び出され、指定されたパスを編集できるようにします。このメソッドは、新しいエディタを作成することなくフィルタ編集を追加するためのサブクラサのエントリポイントとして提供されます。isEditable()
public String getToolTipText(MouseEvent event)
JComponent
の getToolTipText
メソッドをオーバーライドして、レンダリングのヒント (テキストセットがある場合) を使用できるようにします。
注: JTree
がレンダリングのツールヒントを正しく表示するためには、JTree
がコンポーネントとして ToolTipManager
に登録されている必要があります。登録するには、ToolTipManager.sharedInstance().registerComponent(tree)
を呼び出します。これは自動的には行われません。
JComponent
内の getToolTipText
event
- ToolTip
の表示を起動した MouseEvent
event
が null の場合は null
public String convertValueToText(Object value, boolean selected, boolean expanded, boolean leaf, int row, boolean hasFocus)
value.toString
を返し、ほかのすべての引数を無視します。変換を制御するには、このメソッドをサブクラス化し、必要な任意の引数を使用します。value
- テキストに変換する Object
selected
- ノードが選択されている場合は trueexpanded
- ノードが展開されている場合は trueleaf
- ノードが葉ノードの場合は truerow
- ノードの表示行を指定する int 値。0 は最初の行hasFocus
- ノードがフォーカスを持つ場合は trueString
表現public int getRowCount()
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 の場合には表示可能になります。path
- 追加する TreePath
public void addSelectionPaths(TreePath[] paths)
getExpandsSelectedPaths
が true の場合には表示可能になります。paths
- 追加するノードを指定する TreePath
オブジェクトの配列public void addSelectionRow(int row)
row
- 追加するノードの行を指定する int 値。0 は最初の行public void addSelectionRows(int[] rows)
rows
- 追加する行を指定する int の配列。0 は最初の行を示すpublic Object getLastSelectedPathComponent()
TreePath
にある最後の Object
。何も選択されていない場合は 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()
public int getMaxSelectionRow()
public int getLeadSelectionRow()
leadPath
が null
の場合は -1public boolean isPathSelected(TreePath path)
path
- ノードを識別する TreePath
public boolean isRowSelected(int row)
row
- 表示行を指定する int 値。0 は最初の行public Enumeration 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
- スクロールする行を指定する int 値。0 は最初の行public TreePath getPathForRow(int row)
row
が可視でない場合は、null
が返されます。row
- 行を指定する int 値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
- 表示行を指定する int 値。0 は最初の行public void collapsePath(TreePath path)
path
- ノードを識別する TreePath
public void collapseRow(int row)
row
が < 0 または >= getRowCount
の場合、このメソッドは何もしません。
row
- 表示行を指定する int 値。0 は最初の行public TreePath getPathForLocation(int x, int y)
x
- 表示領域 (左マージンは除く) の左端からの水平距離を示す int 値 (ピクセル単位)y
- 表示領域 (上マージンは除く) の上端からの垂直距離を示す int 値 (ピクセル単位)TreePath
public int getRowForLocation(int x, int y)
x
- 表示領域 (左マージンは除く) の左端からの水平距離を示す int 値 (ピクセル単位)y
- 表示領域 (上マージンは除く) の上端からの垂直距離を示す int 値 (ピクセル単位)getClosestRowForLocation(int, int)
public TreePath getClosestPathForLocation(int x, int y)
null
が返されます。そうでない場合、このメソッドは常に有効なパスを返します。ノードが正確に x、y の位置にあるかどうかをテストするには、ノードの境界を取得し、それを基準に x、y をテストします。x
- 表示領域 (左マージンは除く) の左端からの水平距離を示す int 値 (ピクセル単位)y
- 表示領域 (上マージンは除く) の上端からの垂直距離を示す int 値 (ピクセル単位)TreePath
。表示可能なノードがない場合、またはモデルがない場合は null
getPathForLocation(int, int)
,
getPathBounds(javax.swing.tree.TreePath)
public int getClosestRowForLocation(int x, int y)
x
- 表示領域 (左マージンは除く) の左端からの水平距離を示す int 値 (ピクセル単位)y
- 表示領域 (上マージンは除く) の上端からの垂直距離を示す int 値 (ピクセル単位)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
に設定して強制的に空の選択モデルを使用します。TreeSelectionModel
setSelectionModel(javax.swing.tree.TreeSelectionModel)
protected TreePath[] getPathBetweenRows(int index0, int index1)
JTreePath
のインスタンスを返します。ツリーがない場合は null
を返します。index0
- 表示行を指定する int 値。0 は最初の行index1
- 2 番目の行を指定する int 値TreePath
オブジェクト (index0 から index1 までの各ノードに 1 つ) の配列。ツリーがない場合は、null
public void setSelectionInterval(int index0, int index1)
index0
- 表示行を指定する int 値。0 は最初の行index1
- 2 番目の行を指定する int 値public void addSelectionInterval(int index0, int index1)
index0
- 表示行を指定する int 値。0 は最初の行index1
- 2 番目の行を指定する int 値public void removeSelectionInterval(int index0, int index1)
index0
- 表示行を指定する int 値。0 は最初の行index1
- 2 番目の行を指定する int 値public void removeSelectionPath(TreePath path)
path
- ノードを識別する TreePath
public void removeSelectionPaths(TreePath[] paths)
paths
- 削除するノードを指定する TreePath
オブジェクトの配列public void removeSelectionRow(int row)
row
にあるパスを現在の選択から削除します。path
- 削除するノードを識別する TreePathpublic void removeSelectionRows(int[] rows)
row
- 表示行を指定する int の配列。0 は最初の行public void clearSelection()
public boolean isSelectionEmpty()
public void addTreeExpansionListener(TreeExpansionListener tel)
TreeExpansion
イベントのリスナーを追加します。tel
- ツリーノードが展開されたとき、または収納されたとき (負の展開) に通知される TreeExpansionListenerpublic void removeTreeExpansionListener(TreeExpansionListener tel)
TreeExpansion
イベントのリスナーを削除します。tel
- 削除する TreeExpansionListener
public void addTreeWillExpandListener(TreeWillExpandListener tel)
TreeWillExpand
イベントのリスナーを追加します。tel
- ツリーノードが展開されるとき、または収納されるとき (負の展開) に通知される TreeWillExpandListener
public void removeTreeWillExpandListener(TreeWillExpandListener tel)
TreeWillExpand
イベントのリスナーを削除します。tel
- 削除する TreeWillExpandListener
public void fireTreeExpanded(TreePath path)
path
- 展開されたノードを示す TreePath
EventListenerList
public void fireTreeCollapsed(TreePath path)
path
- 収納されたノードを示す TreePath
EventListenerList
public void fireTreeWillExpand(TreePath path) throws ExpandVetoException
path
- 展開されたノードを示す TreePath
EventListenerList
public void fireTreeWillCollapse(TreePath path) throws ExpandVetoException
path
- 展開されたノードを示す TreePath
EventListenerList
public void addTreeSelectionListener(TreeSelectionListener tsl)
TreeSelection
イベントのリスナーを追加します。tsl
- ノードが選択されたとき、または選択を解除されたとき (負の選択) に通知される TreeSelectionListener
public void removeTreeSelectionListener(TreeSelectionListener tsl)
TreeSelection
リスナーを削除します。tsl
- 削除する TreeSelectionListener
protected void fireValueChanged(TreeSelectionEvent e)
e
- ノードが選択されるか、選択を解除されるときに TreeSelectionModel
によって生成される TreeSelectionEvent
EventListenerList
public void treeDidChange()
public void setVisibleRowCount(int newCount)
JScrollPane
に格納されている場合だけ機能し、スクロールペインの適切なサイズを調整します。newCount
- 表示する行数public int getVisibleRowCount()
public Dimension getPreferredScrollableViewportSize()
JTree
の適切な表示サイズを返します。高さは getVisibleRowCount
から決められ、幅は現在の適切な幅です。Scrollable
内の getPreferredScrollableViewportSize
Dimension
オブジェクトpublic int getScrollableUnitIncrement(Rectangle visibleRect, int orientation, int direction)
Scrollable
内の getScrollableUnitIncrement
visibleRect
- ビューポート内の可視のビュー領域orientation
- SwingConstants.VERTICAL
または SwingConstants.HORIZONTAL
direction
- 上または左にスクロールする場合は 0 より小さく、下または右にスクロールする場合は 0 より大きいJScrollBar.setUnitIncrement(int)
public int getScrollableBlockIncrement(Rectangle visibleRect, int orientation, int direction)
orientation
に基づいた visibleRect
の高さまたは幅です。Scrollable
内の getScrollableBlockIncrement
visibleRect
- ビューポート内の可視のビュー領域orientation
- SwingConstants.VERTICAL
または SwingConstants.HORIZONTAL
direction
- 上または左にスクロールする場合は 0 より小さく、下または右にスクロールする場合は 0 より大きいJScrollBar.setBlockIncrement(int)
public boolean getScrollableTracksViewportWidth()
Scrollable
内の getScrollableTracksViewportWidth
Scrollable.getScrollableTracksViewportWidth()
public boolean getScrollableTracksViewportHeight()
Scrollable
内の getScrollableTracksViewportHeight
Scrollable.getScrollableTracksViewportHeight()
protected void setExpandedState(TreePath path, boolean state)
JTree
の展開状態を設定します。state
が true の場合、path
のすべての親およびパスに展開のマークが付けられます。state
が false の場合、path
のすべての親は EXPANDED で示されますが、path
自体は収納されていることが示されます。
これは、TreeWillExpandListener
に拒否される場合は失敗します。
protected Enumeration getDescendantToggledPaths(TreePath parent)
parent
の下位ノードであり、展開されている TreePaths
の Enumeration
を返します。protected void removeDescendantToggledPaths(Enumeration toRemove)
toRemove
にある、展開されている TreePaths
の下位ノードを削除します。protected void clearToggledPaths()
TreeExpansionListener
イベントを送出しません。protected TreeModelListener createTreeModelListener()
TreeModelHandler
のインスタンスを生成して返します。返されたオブジェクトは、TreeModel
が変更されたときに展開状態を更新します。
展開状態の詳細は上記の、JTree description を参照してください。
protected boolean removeDescendantSelectedPaths(TreePath path, boolean includePath)
path
の下位ノードである選択されたすべてのパスを削除します。includePath
が true で path
が選択されている場合は、選択から削除されます。protected String paramString()
JTree
の文字列表現を返します。このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なります。返される文字列は空の場合がありますが、null
にはなりません。JComponent
内の paramString
JTree
の文字列表現public AccessibleContext getAccessibleContext()
Accessible
内の getAccessibleContext
JComponent
内の getAccessibleContext
|
JavaTM 2 Platform Std. Ed. v1.3 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Java、Java 2D、JDBC は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.