java.beans
類別 PropertyEditorSupport

java.lang.Object
  java.beans.PropertyEditorSupport

所有已實作的介面：

PropertyEditor

public class PropertyEditorSupport
extends Object
implements PropertyEditor

這是一個說明建構屬性編輯器的支持類別。

可以將該類別用作一個基礎類別或是一個代理。

建構子摘要

PropertyEditorSupport()
建構一個 PropertyEditorSupport 物件。

PropertyEditorSupport(Object source)
建構一個 PropertyEditorSupport 物件。

方法摘要

void	addPropertyChangeListener(PropertyChangeListener listener) 註冊一個用於 PropertyChange 事件的偵聽器。
void	firePropertyChange() 報告已經修改所有感興趣的偵聽器。
String	getAsText() 獲得人類別可編輯的適當字元串表示形式的屬性值。
Component	getCustomEditor() PropertyEditor 可以選擇使用完全自定義的 Component 來編輯自己的屬性值。
String	getJavaInitializationString() 產生 Java 程式碼來設置屬性值時使用此方法。
Object	getSource() 返回用作事件源的 bean。
String[]	getTags() 如果屬性值必須是一組已知的加標記值之一，則此方法應該返回一個標記值陣列。
Object	getValue() 獲得屬性值。
boolean	isPaintable() 確定該類別是否支持 paintValue 方法。
void	paintValue(Graphics gfx, Rectangle box) 在螢幕實際狀態給定區域中繪製值的表示形式。
void	removePropertyChangeListener(PropertyChangeListener listener) 移除一個用於 PropertyChange 事件的偵聽器。
void	setAsText(String text) 通過解析給定字元串設置屬性值。
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)

設置（或更改）將被編輯的物件。

指定者：

介面 PropertyEditor 中的 setValue

參數：

value - 要編輯的新目標物件。注意，不應由 PropertyEditor 修改此物件，相反 PropertyEditor 應該創建一個新物件來保存所有修改值。

getValue

public Object getValue()

獲得屬性值。

指定者：

介面 PropertyEditor 中的 getValue

返回：

屬性值。

isPaintable

public boolean isPaintable()

確定該類別是否支持 paintValue 方法。

指定者：

介面 PropertyEditor 中的 isPaintable

返回：

如果該類別支持 paintValue 方法，則返回 true。

paintValue

public void paintValue(Graphics gfx,
                       Rectangle box)

在螢幕實際狀態給定區域中繪製值的表示形式。注意，propertyEditor 負責裁剪自身，以適應給定的矩形。

如果 PropertyEditor 不支持繪製請求（參見 isPaintable），則此方法應該是一個靜寂的無操作。

指定者：

介面 PropertyEditor 中的 paintValue

參數：

gfx - 要繪製的 Graphics 物件。

box - 應該在其中繪製圖形物件的矩形。

getJavaInitializationString

public String getJavaInitializationString()

產生 Java 程式碼來設置屬性值時使用此方法。它應該返回一段可以用來利用當前屬性值初始化變數的 Java 程式碼。

範例結果是 "2"、"new Color(127,127,34)"、"Color.orange" 等等。

指定者：

介面 PropertyEditor 中的 getJavaInitializationString

返回：

表示用於當前值的 initializer 的 Java 程式碼片段。

getAsText

public String getAsText()

獲得人類別可編輯的適當字元串表示形式的屬性值。

指定者：

介面 PropertyEditor 中的 getAsText

返回：

人類別可編輯的適當字元串表示形式的屬性值。

如果無法將該值表示為字元串，則返回 "null"。

如果返回的是一個非 null 值，則應該準備好 PropertyEditor，以便回到 setAsText() 解析該字元串。

setAsText

public void setAsText(String text)
               throws IllegalArgumentException

通過解析給定字元串設置屬性值。如果該 String 格式出錯或者無法將此類別屬性表示為文本，則可能引發 java.lang.IllegalArgumentException。

指定者：

介面 PropertyEditor 中的 setAsText

參數：

text - 要解析的字元串。

拋出：

IllegalArgumentException

getTags

public String[] getTags()

如果屬性值必須是一組已知的加標記值之一，則此方法應該返回一個標記值陣列。可以用此方法來表示（例如）列舉值。如果 PropertyEditor 支持標記，則它應該支持使用 setAsText（同時使用標記值）作為設置值的一種方式。

指定者：

介面 PropertyEditor 中的 getTags

返回：

此屬性的標記值。如果無法將此屬性表示為加標記的值，則返回 null。

getCustomEditor

public Component getCustomEditor()

PropertyEditor 可以選擇使用完全自定義的 Component 來編輯自己的屬性值。PropertyEditor 負責將其自身與其編輯器 Component 聯繫起來，並報告由於觸發 PropertyChange 事件而造成的屬性值更改。

調用 getCustomEditor 的更高層級別的程式碼可以將 Component 嵌入一些較大的屬性表，或者將它們放入自己的對話框，或者……

指定者：

介面 PropertyEditor 中的 getCustomEditor

返回：

允許使用者直接編輯當前屬性值的 java.awt.Component。如果這不受支持，則返回 null。

supportsCustomEditor

public boolean supportsCustomEditor()

確定 propertyEditor 是否可以提供自定義編輯器。

指定者：

介面 PropertyEditor 中的 supportsCustomEditor

返回：

如果 propertyEditor 可以提供一個自定義編輯器，則返回 true。

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener listener)

註冊一個用於 PropertyChange 事件的偵聽器。只要更新該值，該類別就會觸發一個 PropertyChange 值。

指定者：

介面 PropertyEditor 中的 addPropertyChangeListener

參數：

listener - 觸發 PropertyChange 事件時要調用的物件。

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener listener)

移除一個用於 PropertyChange 事件的偵聽器。

指定者：

介面 PropertyEditor 中的 removePropertyChangeListener

參數：

listener - 要移除的 PropertyChange 偵聽器。

firePropertyChange

public void firePropertyChange()

報告已經修改所有感興趣的偵聽器。