|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
public interface PropertyEditor
PropertyEditor クラスは、ユーザが指定の型のプロパティ値を編集するための GUI のサポートを提供します。
PropertyEditor は、プロパティ値の表示や更新についてさまざまな方法をサポートします。大部分の PropertyEditor では、この API で使える各種オプションのサブセットをサポートするだけで十分です。
単純な PropertyEditors がサポートするのは getAsText と setAsText メソッドだけで、paintValue や getCustomEditor のサポートは不要です。より複雑なものでは、getAsText や setAsText はサポートできませんが、代わりに paintValue と getCustomEditor をサポートします。
各 propertyEditor は、次の 3 つの表示スタイルのうち 1 つ以上を必ずサポートする必要があります。つまり、(1) isPaintable のサポート、(2) getTags() から null でない String[] を返し、かつ getAsText から null でない値を返す、または (3) 単に getAsText() から null でない String を返す、の 3 つです。
各プロパティエディタは、引数オブジェクトが対応する propertyEditor の型である場合に、setValue の呼び出しをサポートする必要があります。さらに各プロパティエディタは、カスタムエディタまたは setAsText のどちらかをサポートする必要があります。
各 PropertyEditor は、null コンストラクタを持たなければなりません。
メソッドの概要 | |
---|---|
void |
addPropertyChangeListener(PropertyChangeListener listener)
PropertyChange イベントのリスナーを登録します。 |
String |
getAsText()
プロパティ値をテキストとして取得します。 |
Component |
getCustomEditor()
PropertyEditor は、プロパティ値を編集する完全なカスタムコンポーネントを使用できます。 |
String |
getJavaInitializationString()
Java コードの断片を返します。 |
String[] |
getTags()
プロパティ値が既知のタグ付きの値セットの 1 つでなければならない場合に、タグの配列を返します。 |
Object |
getValue()
プロパティ値を取得します。 |
boolean |
isPaintable()
このプロパティエディタがペイント可能かどうかを判定します。 |
void |
paintValue(Graphics gfx,
Rectangle box)
値の表現を画面の指定された領域に描画します。 |
void |
removePropertyChangeListener(PropertyChangeListener listener)
PropertyChange イベントのリスナーを削除します。 |
void |
setAsText(String text)
指定された String (文字列) を解析してプロパティ値を設定します。 |
void |
setValue(Object value)
編集されるオブジェクトを設定 (または変更) します。 |
boolean |
supportsCustomEditor()
このプロパティエディタがカスタムエディタをサポートするかどうかを判定します。 |
メソッドの詳細 |
---|
void setValue(Object value)
value
- 編集対象の新しいターゲットオブジェクト。このオブジェクトは PropertyEditor で変更するのではなく、PropertyEditor で新しいオブジェクトを作成して変更値を保存するObject getValue()
boolean isPaintable()
void paintValue(Graphics gfx, Rectangle box)
PropertyEditor が描画要求を受け取らない場合 (isPaintable を参照)、このメソッドは何も行いません。
指定された Graphics オブジェクトは、親コンテナのデフォルトのフォントや色などを持つことになります。PropertyEditor は、フォントや色などのグラフィックス属性を変更することがあり、古い値を復元する必要はありません。
gfx
- 描画されるグラフィックスオブジェクトbox
- グラフィックスオブジェクトを描画する矩形String getJavaInitializationString()
コードの断片は、コンテキストに依存しない、JLS 指定の Java 正規表現とします。
特に、この表現 (式) が計算式の場合、すべてのクラスおよび static メンバを完全修飾名で指定する必要があります。この規則は、コンストラクタ、static メソッド、および非プリミティブ引数に適用されます。
この表現 (式) を評価するときは、例外がスローされる可能性に注意してください。特に、コードの作成者は、確認済み例外をスローするかもしれない表現がある場合に、生成されたコードが確実にコンパイルされるように注意してください。
結果例を示します。
2
new java.awt.Color(127,127,34)
java.awt.Color.orange
javax.swing.Box.createRigidArea(new java.awt.Dimension(0, 5))
;
」) を使用してはならないString getAsText()
編集可能な文字列として値を表現できない場合は null
null 以外の値が返されると、PropertyEditor はその文字列を解析して setAsText() に戻す
void setAsText(String text) throws IllegalArgumentException
text
- 解析される文字列
IllegalArgumentException
String[] getTags()
Component getCustomEditor()
getCustomEditor を呼び出す高レベルなコードでは、コンポーネントをより大きなプロパティシートに組み込んだり、独自のダイアログに配置したりすることができます。
boolean supportsCustomEditor()
void addPropertyChangeListener(PropertyChangeListener listener)
listener
- PropertyChange イベントがトリガされたときに呼び出されるオブジェクトvoid removePropertyChangeListener(PropertyChangeListener listener)
listener
- 削除される PropertyChange リスナー
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。