-
- 既知のすべてのサブインタフェース:
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
-
-