PropertyEditorSupport (Java Platform SE 7)

java.lang.Object
- java.beans.PropertyEditorSupport

すべての実装されたインタフェース:

PropertyEditor
```
public class PropertyEditorSupport
extends Object
implements PropertyEditor
```
プロパティーエディタを構築するためのサポートクラスです。
基底クラスまたは委譲元として使用できます。

コンストラクタのサマリー

コンストラクタ
コンストラクタと説明
`PropertyEditorSupport()` `PropertyEditorSupport` オブジェクトを構築します。
`PropertyEditorSupport(Object source)` `PropertyEditorSupport` オブジェクトを構築します。

メソッドのサマリー

メソッド
修飾子と型	メソッドと説明
`void`	`addPropertyChangeListener(PropertyChangeListener listener)` 値変更のリスナーを追加します。
`void`	`firePropertyChange()` 関連するすべてのリスナーを変更したことを報告します。
`String`	`getAsText()` 編集するユーザーへの表示に適した文字列として、プロパティー値を取得します。
`Component`	`getCustomEditor()` PropertyEditor は、プロパティー値を編集する完全なカスタムコンポーネントを提供することができます。
`String`	`getJavaInitializationString()` Java コードを生成してプロパティーの値を設定するときに使います。
`Object`	`getSource()` イベントのソースとして使用される Bean を返します。
`String[]`	`getTags()` プロパティー値が既知のタグ付きの値セットの 1 つでなければならない場合に、タグ付きの値の配列を返します。
`Object`	`getValue()` プロパティーの値を取得します。
`boolean`	`isPaintable()` クラスが paintValue メソッドを受け取るかどうかを判定します。
`void`	`paintValue(Graphics gfx, Rectangle box)` 値の表現を画面の指定された領域に描画します。
`void`	`removePropertyChangeListener(PropertyChangeListener listener)` 値変更のリスナーを削除します。
`void`	`setAsText(String text)` 指定された String (文字列) を解析してプロパティー値を設定します。
`void`	`setSource(Object source)` ソース Bean を設定します。
`void`	`setValue(Object value)` 編集するオブジェクトを設定または変更します。
`boolean`	`supportsCustomEditor()` propertyEditor がカスタムエディタをサポートできるかどうかを判定します。

クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

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

バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.

クラス PropertyEditorSupport

コンストラクタのサマリー

メソッドのサマリー

クラス java.lang.Object から継承されたメソッド

コンストラクタの詳細

PropertyEditorSupport

PropertyEditorSupport

メソッドの詳細

getSource

setSource

setValue

getValue

isPaintable

paintValue

getJavaInitializationString

getAsText

setAsText

getTags

getCustomEditor

supportsCustomEditor

addPropertyChangeListener

removePropertyChangeListener

firePropertyChange