- java.lang.Object
- 
- java.beans.PropertyEditorSupport
 
- 
- すべての実装されたインタフェース:
- PropertyEditor
 
 public class PropertyEditorSupport extends Object implements PropertyEditor プロパティ・エディタを構築するためのサポート・クラスです。基底クラスまたは委譲として使用できます。 - 導入されたバージョン:
- 1.1
 
- 
- 
コンストラクタのサマリーコンストラクタ コンストラクタ 説明 PropertyEditorSupport()PropertyEditorSupportオブジェクトを構築します。PropertyEditorSupport(Object source)PropertyEditorSupportオブジェクトを構築します。
 - 
メソッドのサマリー修飾子と型 メソッド 説明 voidaddPropertyChangeListener(PropertyChangeListener listener)値変更のリスナーを追加します。voidfirePropertyChange()関連するすべてのリスナーを変更したことを報告します。StringgetAsText()編集するユーザーへの表示に適した文字列として、プロパティ値を取得します。ComponentgetCustomEditor()PropertyEditorは、プロパティ値を編集する完全なカスタム・コンポーネントを提供することができます。StringgetJavaInitializationString()Javaコードを生成してプロパティの値を設定するときに使います。ObjectgetSource()イベントのソースとして使用されるBeanを返します。String[]getTags()プロパティ値が既知のタグ付きの値セットの1つでなければならない場合に、タグ付きの値の配列を返します。ObjectgetValue()プロパティの値を取得します。booleanisPaintable()クラスがpaintValueメソッドを受け取るかどうかを判定します。voidpaintValue(Graphics gfx, Rectangle box)値の表現を画面の指定された領域に描画します。voidremovePropertyChangeListener(PropertyChangeListener listener)値変更のリスナーを削除します。voidsetAsText(String text)指定されたString (文字列)を解析してプロパティ値を設定します。voidsetSource(Object source)ソースBeanを設定します。voidsetValue(Object value)編集するオブジェクトを設定または変更します。booleansupportsCustomEditor()propertyEditorがカスタム・エディタをサポートできるかどうかを判定します。
 
- 
- 
- 
コンストラクタの詳細- 
PropertyEditorSupportpublic PropertyEditorSupport() PropertyEditorSupportオブジェクトを構築します。- 導入されたバージョン:
- 1.5
 
 - 
PropertyEditorSupportpublic PropertyEditorSupport(Object source) PropertyEditorSupportオブジェクトを構築します。- パラメータ:
- source- イベントをトリガーするために使用されるソース
- 導入されたバージョン:
- 1.5
 
 
- 
 - 
メソッドの詳細- 
getSourcepublic Object getSource() イベントのソースとして使用されるBeanを返します。 ソースが明示的に設定されていない場合、PropertyEditorSupportのインスタンスが返されます。- 戻り値:
- ソース・オブジェクトまたはこのインスタンス
- 導入されたバージョン:
- 1.5
 
 - 
setSourcepublic void setSource(Object source) ソースBeanを設定します。ソースBeanは、プロパティ変更のイベントのソースとして使用されます。 このソースは、情報を提供する目的のみで使用し、PropertyEditorで変更しないでください。 - パラメータ:
- source- イベントに使用されるソース・オブジェクト
- 導入されたバージョン:
- 1.5
 
 - 
setValuepublic void setValue(Object value) 編集するオブジェクトを設定または変更します。- 定義:
- setValue、インタフェース:- PropertyEditor
- パラメータ:
- value- 編集対象の新しいターゲット・オブジェクト。 このオブジェクトはPropertyEditorで変更するのではなく、PropertyEditorで新しいオブジェクトを作成して変更された値を保存する。
 
 - 
getValuepublic Object getValue() プロパティの値を取得します。- 定義:
- getValue、インタフェース:- PropertyEditor
- 戻り値:
- プロパティの値。
 
 - 
isPaintablepublic boolean isPaintable() クラスがpaintValueメソッドを受け取るかどうかを判定します。- 定義:
- isPaintable、インタフェース:- PropertyEditor
- 戻り値:
- クラスがpaintValueメソッドを受け取る場合はtrue。
 
 - 
paintValuepublic void paintValue(Graphics gfx, Rectangle box) 値の表現を画面の指定された領域に描画します。 propertyEditorは、独自のクリッピングを行い、指定された矩形内に収めます。PropertyEditorが描画要求を受け取らない場合(isPaintableを参照)、このメソッドは何も行いません。 - 定義:
- paintValue、インタフェース:- PropertyEditor
- パラメータ:
- gfx- 描画するグラフィックス・オブジェクト。
- box- 描画するべきグラフィックス・オブジェクト内の矩形。
 
 - 
getJavaInitializationStringpublic String getJavaInitializationString() Javaコードを生成してプロパティの値を設定するときに使います。 現在のプロパティ値を持つ変数の初期化に使えるJavaコードのフラグメントを返します。結果例として「2」、「new Color(127,127,34)」、「Color.orange」などがあります。 - 定義:
- getJavaInitializationString、インタフェース:- PropertyEditor
- 戻り値:
- 現在値の初期化子を表すJavaコードのフラグメント。
 
 - 
getAsTextpublic String getAsText() 編集するユーザーへの表示に適した文字列として、プロパティ値を取得します。- 定義:
- getAsText、インタフェース:- PropertyEditor
- 戻り値:
- 編集するユーザーへの表示に適した文字列としてのプロパティ値。
 文字列として値を表現できない場合はnullを返します。 null以外の値が返されると、PropertyEditorはその文字列を解析してsetAsText()に戻す。 
 
 - 
setAsTextpublic void setAsText(String text) throws IllegalArgumentException 指定されたString (文字列)を解析してプロパティ値を設定します。 Stringの書式が不正な場合、あるいはプロパティをテキスト表示できない場合は、java.lang.IllegalArgumentExceptionがスローされます。- 定義:
- setAsText、インタフェース:- PropertyEditor
- パラメータ:
- text- 解析される文字列。
- 例外:
- IllegalArgumentException
 
 - 
getTagspublic String[] getTags() プロパティ値が既知のタグ付きの値セットの1つでなければならない場合に、タグ付きの値の配列を返します。 たとえば、これを使って列挙値を表示できます。 PropertyEditorでタグをサポートする場合は、値を設定する方法として、タグ付きの値をsetAsTextで使用できるようにしてください。- 定義:
- getTags、インタフェース:- PropertyEditor
- 戻り値:
- このプロパティのタグ付きの値。 このプロパティをタグ付きの値として表示できない場合はnull。
 
 - 
getCustomEditorpublic Component getCustomEditor() PropertyEditorは、プロパティ値を編集する完全なカスタム・コンポーネントを提供することができます。 PropertyEditorは、エディタのコンポーネントと連携し、PropertyChangeイベントをトリガーしてプロパティ値の変更を通知します。getCustomEditorを呼び出す高レベルなコードでは、コンポーネントをより大きなプロパティ・シートに組み込んだり、独自のダイアログに配置したりすることができます。 - 定義:
- getCustomEditor、インタフェース:- PropertyEditor
- 戻り値:
- ユーザーが現在のプロパティ値を直接編集できるようにするjava.awt.Component。 サポートされない場合はnull。
 
 - 
supportsCustomEditorpublic boolean supportsCustomEditor() propertyEditorがカスタム・エディタをサポートできるかどうかを判定します。- 定義:
- supportsCustomEditor、インタフェース:- PropertyEditor
- 戻り値:
- propertyEditorがカスタム・エディタをサポートできる場合はtrue。
 
 - 
addPropertyChangeListenerpublic void addPropertyChangeListener(PropertyChangeListener listener) 値変更のリスナーを追加します。 プロパティ・エディタが値を変更する場合は、プロパティ名にnull値を指定して、登録されているすべてのPropertyChangeListenerに対してPropertyChangeEventをトリガーする必要があります。 ソース・プロパティが設定されている場合は、イベントのソースとして使用してください。同じリスナー・オブジェクトを複数回追加でき、追加した回数だけリスナー・オブジェクトが呼び出されます。 listenerがnullの場合、例外はスローされず、何も処理は行われません。- 定義:
- addPropertyChangeListener、インタフェース:- PropertyEditor
- パラメータ:
- listener- 追加する- PropertyChangeListener
 
 - 
removePropertyChangeListenerpublic void removePropertyChangeListener(PropertyChangeListener listener) 値変更のリスナーを削除します。同じリスナーが2回以上追加された場合は、削除されたあとに1回少ない通知が行われます。 listenerがnullの場合、または追加されなかった場合、例外はスローされず、何も処理は行われません。- 定義:
- removePropertyChangeListener、インタフェース:- PropertyEditor
- パラメータ:
- listener- 削除する- PropertyChangeListener
 
 - 
firePropertyChangepublic void firePropertyChange() 関連するすべてのリスナーを変更したことを報告します。
 
- 
 
-