モジュール java.desktop

パッケージ javax.swing

インタフェースCellEditor

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

TableCellEditor, TreeCellEditor

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

AbstractCellEditor, DefaultCellEditor, DefaultTreeCellEditor

public interface CellEditor

このインタフェースは、どの汎用エディタでも実装できるメソッドを定義します。

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

このインタフェースを使用するには、新しいエディタを作成する開発者は、インタフェースを実装する新しいコンポーネントを使用できます。 または開発者はラッパー・ベースのアプローチを選択して、CellEditorインタフェースを実装するコンパニオン・オブジェクトを提供できます(DefaultCellEditorなどを参照)。 ラッパー・アプローチは、ユーザーがJTableでサード・パーティのISVエディタを使用したいが、ISVではCellEditorインタフェースを実装していない場合に特に役立ちます。 ユーザーは単にサード・パーティ・エディタ・オブジェクトのインスタンスを格納するオブジェクトを作成して、CellEditor APIをサード・パーティ・エディタのAPIに「変換」するだけです。

導入されたバージョン:

1.2

関連項目:

• 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