javax.swing

インタフェース CellEditor

既知のすべてのサブインタフェース:

TableCellEditor, TreeCellEditor

既知のすべての実装クラス:

AbstractCellEditor, DefaultCellEditor, DefaultTreeCellEditor

public interface CellEditor

すべての汎用エディタが実装可能なメソッドを定義します。

このインタフェースを使用すると、JTree、JTable などの複合コンポーネント (エディタのクライアント) では、汎用エディタを使用してテーブルセルやツリーセルの値を編集できるようになります。この汎用エディタインタフェースがない場合、JTable は JTextField、JCheckBox、JComboBox などの特定のエディタを認識する必要があります。さらに、このインタフェースがないと、JTable などのエディタのクライアントは、今後ユーザーやサードパーティーの ISV (独立系ソフトウェアベンダー) が開発するエディタでは使用できなくなります。

このインタフェースを使うために、新しいエディタを作成する開発者は、その新しいコンポーネントにこのインタフェースを実装できます。または、ラッパーに基づくアプローチを選択し、CellEditor インタフェースを実装するコンパニオンオブジェクトを提供することもできます。例については、JCellEditor を参照してください。ラッパーアプローチは、ユーザーが JTable でサードパーティーの ISV のエディタを使うことを希望しているが、CellEditor インタフェースが実装されていない場合に特に便利です。ユーザーは、サードパーティーの ISV によるエディタオブジェクトのインスタンスが格納されているオブジェクトを作成し、CellEditor API をそのサードパーティーエディタの API に変換するだけでオブジェクトを生成できます。

関連項目:

CellEditorListener

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
void	addCellEditorListener(CellEditorListener l) エディタが編集の停止、または取り消しを行うときに通知を受けるリスナーをリストに追加します。
void	cancelCellEditing() 編集を取り消して一部編集済みの値を受け付けないようにエディタに通知します。
Object	getCellEditorValue() エディタに保持された値を返します。
boolean	isCellEditable(EventObject anEvent) anEvent を使って編集を始められるかどうかをエディタに問い合わせます。
void	removeCellEditorListener(CellEditorListener l) 通知を受けるリスナーをリストから削除します。
boolean	shouldSelectCell(EventObject anEvent) 編集セルが選択される場合は true、そうでない場合は false。
boolean	stopCellEditing() 編集を停止して一部編集済みの値をエディタの値として受け付けるように、エディタに通知します。

メソッドの詳細

getCellEditorValue

Object getCellEditorValue()

エディタに保持された値を返します。

戻り値:

エディタに保持された値

isCellEditable

boolean isCellEditable(EventObject anEvent)

anEvent を使って編集を始められるかどうかをエディタに問い合わせます。anEvent は呼び出し側コンポーネント座標系にあります。エディタは、getCellEditorComponent によって返される Component がインストールされていると想定できません。このメソッドは、編集が可能でない場合に、エディタコンポーネントの設定とインストールの手間を避けるために、クライアント側で使うことを目的としています。編集を開始できる場合、このメソッドは true を返します。

パラメータ:

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

戻り値:

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

関連項目:

shouldSelectCell(java.util.EventObject)

shouldSelectCell

boolean shouldSelectCell(EventObject anEvent)

編集セルが選択される場合は true、そうでない場合は false。編集セルはほとんどの場合に選択されるので、通常は戻り値は true です。ただし、選択領域を特定の種類の編集による変更から保護するには false を返すとよいでしょう。たとえば、チェックボックスの列を保持するテーブルでは、ユーザーは選択領域の変更なしにそれらのチェックボックスの変更を要求する場合があります。この例については、Netscape Communicator を参照してください。戻り値を使うかどうかはエディタのクライアント次第であり、必要がなければ使わなくてもかまいません。

パラメータ:

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

戻り値:

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

関連項目:

isCellEditable(java.util.EventObject)

stopCellEditing

boolean stopCellEditing()

編集を停止して一部編集済みの値をエディタの値として受け付けるように、エディタに通知します。編集が停止されなかった場合、エディタは false を返します。これは、エントリの検証を行ない、無効なエントリであれば受け付けることができないエディタに有効です。

戻り値:

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

cancelCellEditing

void cancelCellEditing()

編集を取り消して一部編集済みの値を受け付けないようにエディタに通知します。

addCellEditorListener

void addCellEditorListener(CellEditorListener l)

エディタが編集の停止、または取り消しを行うときに通知を受けるリスナーをリストに追加します。

パラメータ:

l - CellEditorListener

removeCellEditorListener

void removeCellEditorListener(CellEditorListener l)

通知を受けるリスナーをリストから削除します。

パラメータ:

l - CellEditorListener