モジュール java.desktop

パッケージ 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に適しています。 1.4では、すべてのJavaBeansの長期ストレージのサポートがjava.beansパッケージに追加されました。 XMLEncoderを参照してください。

関連項目:

• JTree

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

ネストされたクラス

修飾子と型	クラス	説明
class	DefaultTreeCellEditor.DefaultTextField	エディタが提供されない場合に使用されるTextField。
class	DefaultTreeCellEditor.EditorContainer	editingComponentを配置するコンテナ。

フィールドのサマリー

フィールド

修飾子と型	フィールド	説明
protected Color	borderSelectionColor	ボーダー選択色が描画される場合にtrueを返します。
protected boolean	canEdit	Java 2プラットフォーム1.4では、このフィールドは使われなくなりました。
protected Component	editingComponent	editingContainerから取得され、編集で使用されるコンポーネントです。
protected Container	editingContainer	編集コンテナ、editorComponentを含みます。
protected Icon	editingIcon	編集時に使うアイコンです。
protected Font	font	ペイントに使用するフォントです。nullは、レンダラのフォントを使うことを示します。
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()	メッセージとしてcancelCellEditingをrealEditorに送り、このインスタンスから削除します。
protected boolean	canEditImmediately(EventObject event)	eventがnullの場合、trueを返します。クリック数が2より大きいMouseEventでinHitRegionを持つ場合にも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)	eventがMouseEventで、クリック数が1の場合にtrueを返します。
protected void	startEditingTimer()	編集タイマーを起動します。
boolean	stopCellEditing()	realEditorが編集の停止を許可する場合、realEditorは削除され、trueが返されます。そうでない場合は、falseが返されます。
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プラットフォーム1.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に渡されます。

定義:

getTreeCellEditorComponent、インタフェースTreeCellEditor

パラメータ:

tree - エディタに編集を要求しているJTree。このパラメータはnullも可

value - 編集されるセル値

isSelected - セルをハイライトで描画する場合はtrue

expanded - ノードが展開されている場合はtrue

leaf - ノードが葉ノードの場合はtrue

row - 編集中のノードの行インデックス

戻り値:

編集のためのコンポーネント

getCellEditorValue

public Object getCellEditorValue()

現在編集中の値を返します。

定義:

getCellEditorValue、インタフェースCellEditor

戻り値:

現在編集中の値

isCellEditable

public boolean isCellEditable(EventObject event)

realEditorがこのメッセージにtrueを返すと、prepareForEditingがメッセージとして送られ、trueが返されます。

定義:

isCellEditable、インタフェースCellEditor

パラメータ:

event - エディタが編集を始めるかどうかを検討するのに使うイベント

戻り値:

編集を開始できる場合はtrue

関連項目:

• CellEditor.shouldSelectCell(java.util.EventObject)

shouldSelectCell

public boolean shouldSelectCell(EventObject event)

戻り値のrealEditorをメッセージとして送ります。

定義:

shouldSelectCell、インタフェースCellEditor

パラメータ:

event - エディタが編集を始めるために使うイベント

戻り値:

エディタが編集セルの選択を望む場合はtrue、そうでない場合はfalse

関連項目:

• CellEditor.isCellEditable(java.util.EventObject)

stopCellEditing

public boolean stopCellEditing()

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

定義:

stopCellEditing、インタフェースCellEditor

戻り値:

編集が停止された場合はtrue、そうでない場合はfalse

cancelCellEditing

public void cancelCellEditing()

メッセージとしてcancelCellEditingをrealEditorに送り、このインスタンスから削除します。

定義:

cancelCellEditing、インタフェースCellEditor

addCellEditorListener

public void addCellEditorListener(CellEditorListener l)

CellEditorListenerを追加します。

定義:

addCellEditorListener、インタフェースCellEditor

パラメータ:

l - 追加されるリスナー

removeCellEditorListener

public void removeCellEditorListener(CellEditorListener l)

以前に追加されたCellEditorListenerを削除します。

定義:

removeCellEditorListener、インタフェースCellEditor

パラメータ:

l - 削除されるリスナー

getCellEditorListeners

public CellEditorListener[] getCellEditorListeners()

addCellEditorListener()でこのDefaultTreeCellEditorに追加されたすべてのCellEditorListenerの配列を返します。

戻り値:

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

導入されたバージョン:

1.4

valueChanged

public void valueChanged(TreeSelectionEvent e)

lastPathをリセットします。

定義:

valueChanged、インタフェースTreeSelectionListener

パラメータ:

e - 変更を記述するイベント。

actionPerformed

public void actionPerformed(ActionEvent e)

タイマーがトリガーされるとメッセージが送られ、編集中セッションが開始されます。

定義:

actionPerformed、インタフェースActionListener

パラメータ:

e - 処理されるイベント

setTree

protected void setTree(JTree newTree)

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

パラメータ:

newTree - 編集する新しいツリー

shouldStartEditingTimer

protected boolean shouldStartEditingTimer(EventObject event)

eventがMouseEventで、クリック数が1の場合にtrueを返します。

パラメータ:

event - 調査中のイベント

戻り値:

eventが編集タイマーを開始するかどうか

startEditingTimer

protected void startEditingTimer()

編集タイマーを起動します。

canEditImmediately

protected boolean canEditImmediately(EventObject event)

eventがnullの場合、trueを返します。クリック数が2より大きいMouseEventでinHitRegionを持つ場合にもtrueを返します。

パラメータ:

event - 調査中のイベント

戻り値:

指定された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)

オフセットを決定します。

パラメータ:

tree - JTreeオブジェクト

value - 値

isSelected - 選択ステータス

expanded - 拡張ステータス

leaf - 葉のステータス

row - 現在の行

prepareForEditing

protected void prepareForEditing()

編集が開始される直前に呼び出されます。 editingComponentがeditingContainerに追加されます。

createContainer

protected Container createContainer()

editingComponentの配置を管理するコンテナを作成します。

戻り値:

新しいContainerオブジェクト

createTreeCellEditor

protected TreeCellEditor createTreeCellEditor()

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

戻り値:

新しいTextFieldエディタ