JavaTM 2 Platform
Standard Ed. 5.0

javax.swing.tree
クラス DefaultTreeCellEditor

java.lang.Object
  上位を拡張 javax.swing.tree.DefaultTreeCellEditor
すべての実装されたインタフェース:
ActionListener, EventListener, CellEditor, TreeSelectionListener, TreeCellEditor

public class DefaultTreeCellEditor
extends Object
implements ActionListener, TreeCellEditor, TreeSelectionListener

TreeCellEditor です。DefaultTreeCellRenderer のインスタンスを指定して、アイコンを取得できるようにする必要があります。DefaultTreeCellRenderer のアイコンに従って配置される TreeCellEditor をオプションで指定できます。TreeCellEditor を指定しないと、TextField が使用されます。編集を開始するには、マウスをトリプルクリックするか、マウスクリックを休止をはさんで 2 回行なって 1200 ミリ秒待ちます。

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

関連項目:
JTree

入れ子のクラスの概要
 class DefaultTreeCellEditor.DefaultTextField
          エディタが提供されない場合に使用する TextField です。
 class DefaultTreeCellEditor.EditorContainer
          editingComponent の配置を扱うコンテナです。
 
フィールドの概要
protected  Color borderSelectionColor
          ボーダ選択色が描画される場合に true を返します。
protected  boolean canEdit
          Java 2 プラットフォーム v1.4 では、このフィールドは使われなくなりました。
protected  Component editingComponent
          編集で使用されるコンポーネントです。
protected  Container editingContainer
          編集コンテナで、editorComponent を格納します。
protected  Icon editingIcon
          編集時に使うアイコンです。
protected  Font font
          ペイントするフォントです。
protected  TreePath lastPath
          選択された最後のパスです。
protected  int lastRow
          getTreeCellEditorComponent に最後に渡された行です。
protected  int offset
          編集に使用します。
protected  TreeCellEditor realEditor
          編集を処理するエディタです。
protected  DefaultTreeCellRenderer renderer
          ボーダとオフセットの取得に使用されるレンダリングです。
protected  Timer timer
          編集セッションの開始前に使用されます。
protected  JTree tree
          待機も行なっている JTree のインスタンスです。
 
コンストラクタの概要
DefaultTreeCellEditor(JTree tree, DefaultTreeCellRenderer renderer)
          指定されたレンダリングとデフォルトのエディタを使用して、JTree 用の DefaultTreeCellEditor オブジェクトを構築します (通常の編集にはこのコンストラクタを使用)。
DefaultTreeCellEditor(JTree tree, DefaultTreeCellRenderer renderer, TreeCellEditor editor)
          指定されたレンダリングと指定されたエディタを使用して、JTree 用の DefaultTreeCellEditor オブジェクトを構築します (特殊な編集にはこのコンストラクタを使用)。
 
メソッドの概要
 void actionPerformed(ActionEvent e)
          タイマーがトリガされると、メッセージとして送られ、編集セッションを開始します。
 void addCellEditorListener(CellEditorListener l)
          CellEditorListener を追加します。
 void cancelCellEditing()
          メッセージとして cancelCellEditingrealEditor に送り、このインスタンスから削除します。
protected  boolean canEditImmediately(EventObject event)
          eventnull の場合、true を返します。
protected  Container createContainer()
          editingComponent の配置を管理するコンテナを作成します。
protected  TreeCellEditor createTreeCellEditor()
          TreeCellEditor がコンストラクタ内に指定されない場合に呼び出されます。
protected  void determineOffset(JTree tree, Object value, boolean isSelected, boolean expanded, boolean leaf, int row)
           
 Color getBorderSelectionColor()
          ボーダを描画する色を返します。
 CellEditorListener[] getCellEditorListeners()
          addCellEditorListener() を使用してこの DefaultTreeCellEditor に追加されたすべての CellEditorListener からなる配列を返します。
 Object getCellEditorValue()
          現在編集中の値を返します。
 Font getFont()
          編集に使用するフォントを返します。
 Component getTreeCellEditorComponent(JTree tree, Object value, boolean isSelected, boolean expanded, boolean leaf, int row)
          エディタを設定します。
protected  boolean inHitRegion(int x, int y)
          渡された位置が編集を開始するのに有効なマウス位置の場合、true を返します。
 boolean isCellEditable(EventObject event)
          realEditor が true をこのメッセージに返すと、prepareForEditing がメッセージとして送られ、true が返されます。
protected  void prepareForEditing()
          編集が開始される直前に呼び出されます。
 void removeCellEditorListener(CellEditorListener l)
          直前に追加済みの CellEditorListener を削除します。
 void setBorderSelectionColor(Color newColor)
          ボーダに使う色を設定します。
 void setFont(Font font)
          編集用のフォントを設定します。
protected  void setTree(JTree newTree)
          現在編集対象のツリーを設定します。
 boolean shouldSelectCell(EventObject event)
          戻り値の realEditor をメッセージとして送ります。
protected  boolean shouldStartEditingTimer(EventObject event)
          eventMouseEvent で、クリック数が 1 の場合に true を返します。
protected  void startEditingTimer()
          編集タイマーを起動します。
 boolean stopCellEditing()
          realEditor が編集の停止を許可する場合、realEditor は削除され、true が返されます。
 void valueChanged(TreeSelectionEvent e)
          lastPath をリセットします。
 
クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

フィールドの詳細

realEditor

protected TreeCellEditor realEditor
編集を処理するエディタです。


renderer

protected DefaultTreeCellRenderer renderer
ボーダとオフセットの取得に使用されるレンダリングです。


editingContainer

protected Container editingContainer
編集コンテナで、editorComponent を格納します。


editingComponent

protected transient Component editingComponent
編集で使用されるコンポーネントです。editingContainer から取得されます。


canEdit

protected boolean canEdit
Java 2 プラットフォーム v1.4 では、このフィールドは使われなくなりました。類似の動作を必要とする場合は、isCellEditable を直接オーバーライドしてください。


offset

protected transient int offset
編集に使用します。editingComponent を配置する x 座標を示します。


tree

protected transient JTree tree
待機も行なっている JTree のインスタンスです。


lastPath

protected transient TreePath lastPath
選択された最後のパスです。


timer

protected transient Timer timer
編集セッションの開始前に使用されます。


lastRow

protected transient int lastRow
getTreeCellEditorComponent に最後に渡された行です。


borderSelectionColor

protected Color borderSelectionColor
ボーダ選択色が描画される場合に true を返します。


editingIcon

protected transient Icon editingIcon
編集時に使うアイコンです。


font

protected Font font
ペイントするフォントです。null は、レンダリングのフォントを使うことを示します。

コンストラクタの詳細

DefaultTreeCellEditor

public DefaultTreeCellEditor(JTree tree,
                             DefaultTreeCellRenderer renderer)
指定されたレンダリングとデフォルトのエディタを使用して、JTree 用の DefaultTreeCellEditor オブジェクトを構築します (通常の編集にはこのコンストラクタを使用)。

パラメータ:
tree - JTree オブジェクト
renderer - DefaultTreeCellRenderer オブジェクト

DefaultTreeCellEditor

public DefaultTreeCellEditor(JTree tree,
                             DefaultTreeCellRenderer renderer,
                             TreeCellEditor editor)
指定されたレンダリングと指定されたエディタを使用して、JTree 用の DefaultTreeCellEditor オブジェクトを構築します (特殊な編集にはこのコンストラクタを使用)。

パラメータ:
tree - JTree オブジェクト
renderer - DefaultTreeCellRenderer オブジェクト
editor - TreeCellEditor オブジェクト
メソッドの詳細

setBorderSelectionColor

public void setBorderSelectionColor(Color newColor)
ボーダに使う色を設定します。

パラメータ:
newColor - 新しいボーダ色

getBorderSelectionColor

public Color getBorderSelectionColor()
ボーダを描画する色を返します。

戻り値:
ボーダ選択の色

setFont

public void setFont(Font font)
編集用のフォントを設定します。null は、レンダリングのフォントを使うことを示します。これは、レシーバのインスタンスを生成するのに使ったエディタに設定したフォントがあっても、オーバーライドすることはありません。エディタの null が渡されると、このフォントを選択するデフォルトエディタが作成されます。

パラメータ:
font - 編集用の Font
関連項目:
getFont()

getFont

public Font getFont()
編集に使用するフォントを返します。

戻り値:
編集用の Font
関連項目:
setFont(java.awt.Font)

getTreeCellEditorComponent

public Component getTreeCellEditorComponent(JTree tree,
                                            Object value,
                                            boolean isSelected,
                                            boolean expanded,
                                            boolean leaf,
                                            int row)
エディタを設定します。realEditor に渡されます。

定義:
インタフェース TreeCellEditor 内の getTreeCellEditorComponent
パラメータ:
tree - エディタに編集を要求している JTree。このパラメータは null も可
value - 編集されるセル値
isSelected - セルがレンダリングとなり選択部がハイライトされている場合は true
expanded - ノードが展開されている場合は true
leaf - ノードが葉ノードの場合は true
row - 編集中のノードの行インデックス
戻り値:
編集のためのコンポーネント

getCellEditorValue

public Object getCellEditorValue()
現在編集中の値を返します。

定義:
インタフェース CellEditor 内の getCellEditorValue
戻り値:
現在編集中の値

isCellEditable

public boolean isCellEditable(EventObject event)
realEditor が true をこのメッセージに返すと、prepareForEditing がメッセージとして送られ、true が返されます。

定義:
インタフェース CellEditor 内の isCellEditable
パラメータ:
event - エディタが編集を始めるかどうかを検討するのに使うイベント
戻り値:
編集を開始できる場合は true
関連項目:
CellEditor.shouldSelectCell(java.util.EventObject)

shouldSelectCell

public boolean shouldSelectCell(EventObject event)
戻り値の realEditor をメッセージとして送ります。

定義:
インタフェース CellEditor 内の shouldSelectCell
パラメータ:
event - エディタが編集を始めるために使うイベント
戻り値:
編集セル選択をエディタ側で要求する場合は true、そうでない場合は false
関連項目:
CellEditor.isCellEditable(java.util.EventObject)

stopCellEditing

public boolean stopCellEditing()
realEditor が編集の停止を許可する場合、realEditor は削除され、true が返されます。そうでない場合は、false が返されます。

定義:
インタフェース CellEditor 内の stopCellEditing
戻り値:
編集が停止された場合は true、そうでない場合は false

cancelCellEditing

public void cancelCellEditing()
メッセージとして cancelCellEditingrealEditor に送り、このインスタンスから削除します。

定義:
インタフェース CellEditor 内の cancelCellEditing

addCellEditorListener

public void addCellEditorListener(CellEditorListener l)
CellEditorListener を追加します。

定義:
インタフェース CellEditor 内の addCellEditorListener
パラメータ:
l - 追加されるリスナー

removeCellEditorListener

public void removeCellEditorListener(CellEditorListener l)
直前に追加済みの CellEditorListener を削除します。

定義:
インタフェース CellEditor 内の removeCellEditorListener
パラメータ:
l - 削除されるリスナー

getCellEditorListeners

public CellEditorListener[] getCellEditorListeners()
addCellEditorListener() を使用してこの DefaultTreeCellEditor に追加されたすべての CellEditorListener からなる配列を返します。

戻り値:
追加されたすべての CellEditorListener。リスナーが追加されていない場合は空の配列
導入されたバージョン:
1.4

valueChanged

public void valueChanged(TreeSelectionEvent e)
lastPath をリセットします。

定義:
インタフェース TreeSelectionListener 内の valueChanged
パラメータ:
e - 変更を記述するイベント

actionPerformed

public void actionPerformed(ActionEvent e)
タイマーがトリガされると、メッセージとして送られ、編集セッションを開始します。

定義:
インタフェース ActionListener 内の actionPerformed

setTree

protected void setTree(JTree newTree)
現在編集対象のツリーを設定します。選択リスナーを追加するのに必要です。

パラメータ:
newTree - 編集する新しいツリー

shouldStartEditingTimer

protected boolean shouldStartEditingTimer(EventObject event)
eventMouseEvent で、クリック数が 1 の場合に true を返します。

パラメータ:
event - 調査中のイベント

startEditingTimer

protected void startEditingTimer()
編集タイマーを起動します。


canEditImmediately

protected boolean canEditImmediately(EventObject event)
eventnull の場合、true を返します。クリック数が 2 より大きい MouseEventinHitRegion を持つ場合にも true を返します。

パラメータ:
event - 調査中のイベント

inHitRegion

protected boolean inHitRegion(int x,
                              int y)
渡された位置が編集を開始するのに有効なマウス位置の場合、true を返します。x がレンダリングによって表示されるアイコンとアイコンギャップの幅以下の場合に、false を返せるようにこのメソッドは実装されています。つまり、レンダリングで表示されたテキスト部分の上でユーザがクリックする場合は true、そうでない場合に false を返します。

パラメータ:
x - 点の x 座標
y - 点の y 座標
戻り値:
渡された位置が有効なマウスの位置である場合は true

determineOffset

protected void determineOffset(JTree tree,
                               Object value,
                               boolean isSelected,
                               boolean expanded,
                               boolean leaf,
                               int row)

prepareForEditing

protected void prepareForEditing()
編集が開始される直前に呼び出されます。editingComponenteditingContainer に追加されます。


createContainer

protected Container createContainer()
editingComponent の配置を管理するコンテナを作成します。


createTreeCellEditor

protected TreeCellEditor createTreeCellEditor()
TreeCellEditor がコンストラクタ内に指定されない場合に呼び出されます。TextField エディタを返します。

戻り値:
新しい TextField エディタ

JavaTM 2 Platform
Standard Ed. 5.0

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java 2 SDK SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。