全パッケージ  クラス階層  このパッケージ  前項目  次項目  インデックス

クラス java.beans.PropertyEditorSupport

java.lang.Object
   |
   +----java.beans.PropertyEditorSupport

public class PropertyEditorSupport

extends Object

implements PropertyEditor

PropertyEditorSupport()

派生 PropertyEditor クラスが使う構築子。

PropertyEditorSupport(Object)

PropertyEditor の機能時に使う構築子。

addPropertyChangeListener(PropertyChangeListener)

PropertyChange イベントのリスナを登録する。

firePropertyChange()

関心のあるリスナに変更されたことをリポートする。

getAsText()

getCustomEditor()

PropertyEditor は、プロパティ値を編集する完全なカスタムコンポーネントの使用を選択できる。

getJavaInitializationString()

このメソッドは、Java コードを生成してプロパティ値を設定するときに使う。

getTags()

プロパティ値が認識されるタグ付き値のセットの 1 つでなければならない場合に、このメソッドがタグ付き値を返す。

getValue()

isPaintable()

paintValue(Graphics, Rectangle)

値表示を画面の実際の所定領域にペイントする。

removePropertyChangeListener(PropertyChangeListener)

PropertyChange イベントのリスナを削除する。

setAsText(String)

指定の String を解析して、プロパティ値を設定する。

setValue(Object)

編集するオブジェクトを設定 (変更) する。

supportsCustomEditor()

  protected PropertyEditorSupport()

派生 PropertyEditor クラスが使う構築子です。

  protected PropertyEditorSupport(Object source)

PropertyEditor の機能時に使う構築子です。

パラメータ:

source - ユーザが出す任意のイベント用に使うソース

  public void setValue(Object value)

編集するオブジェクトを設定 (変更) します。

パラメータ:

value - 編集対象の新しいターゲット。このオブジェクトは PropertyEditor を使って変更するのではなく、PropertyEditor で新しいオブジェクトを生成してから変更した値をこの中に入れる。

  public Object getValue()

返り値:

プロパティの値

  public boolean isPaintable()

返り値:

クラスが paintValue メソッドを受け取る場合は true

  public void paintValue(Graphics gfx,
                         Rectangle box)

値表示を画面の実際の所定領域にペイントします。propertyEditor は独自のクリッピングを行って所定の矩形内に収まります。

PropertyEditor がペイント要求を受け取らない場合 (isPaintable を参照) は、このメソッドは機能しません。

パラメータ:

gfx - ペイント先のグラフィックオブジェクト

box - ペイント先のグラフィックオブジェクト内の矩形

  public String getJavaInitializationString()

このメソッドは、Java コードを生成してプロパティ値を設定するときに使います。現在のプロパティ値を持つ変数の初期化に使える Java コード断片を返します。

結果例として 「2」、「new Color(127,127,34)」、「Color.orange」 などがあります。

返り値:

現在値の初期化子を表す Java コードの断片。

  public String getAsText()

返り値:

ユーザが編集できる文字列のプロパティ値

編集可能文字列として値を表せない場合は null を返します。

null 以外の値が返ると、PropertyEditor はその文字列を解析して setAsText() に戻します。

  public void setAsText(String text) throws IllegalArgumentException

所定の String を解析してプロパティ値を設定します。String のフォーマットが不良な場合やプロパティをテキスト表示できない場合は、java.lang.IllegalArgumentException が出されます。

パラメータ:

text - 解析する文字列

  public String[] getTags()

プロパティ値が認識されるタグ付きの値セットの 1 つでなければならない場合に、このメソッドがタグの配列を返します。例えば、これを使って可算値を表示できます。PropertyEditor がタグをサポートする場合、値設定の方法としてタグ付きの値を持つ setAsText を使うことができます。

返り値:

このプロパティのタグ付きの値です。このプロパティをタグ付きの値として表示できない場合は、null を返す。

  public Component getCustomEditor()

PropertyEditor は、プロパティ値を編集する完全なカスタムコンポーネントの使用を選択できます。PropertyEditor は エディタのコンポーネントと連携し、PropertyChange イベントを出してプロパティ値の変更をレポートします。

getCustomEditor を呼び出す高レベルなコードは、コンポーネントをより大きなプロパティシートに埋め込んだり、独自のダイアログに入れたりできます。

返り値:

ユーザが現在のプロパティ値を直接編集できるようにする、java.awt.Component。サポートされない場合は null 。

  public boolean supportsCustomEditor()

返り値:

propertyEditor がカスタムエディタをサポートできる場合は true

  public synchronized void addPropertyChangeListener(PropertyChangeListener listener)

PropertyChange イベントのリスナを登録します。値の更新ごとに、クラスは PropertyChange 値を出します。

パラメータ:

listener - PropertyChange イベントが出されるときに呼び出されるオブジェクト

  public synchronized void removePropertyChangeListener(PropertyChangeListener listener)

PropertyChange イベントのリスナを削除します。

パラメータ:

listener - 削除する PropertyChange リスナ

  public void firePropertyChange()

関心のあるリスナに変更されたことをレポートします。

パラメータ:

source - イベントを出した PropertyEditor

全パッケージ  クラス階層  このパッケージ  前項目  次項目  インデックス