PropertyEditor (Java Platform SE 8 )

所有已知实现类：

PropertyEditorSupport
```
public interface PropertyEditor
```
一个属性类提供了图形用户界面，要允许用户编辑一个给定类型的属性值的支持。
属性支持多种不同的显示和更新属性值的方法。最propertyeditors只需要支持此API中可用的不同选项子集。

简单的propertyeditors可能只支持getastext和setAsText方法不需要支持（说）paintvalue或getcustomeditor。更复杂的类型可能无法支持getastext和setAsText而是支持paintvalue和getcustomeditor。

每个属性必须支持一个或一个以上的三个简单的显示风格。因此它可以（1）或（2）的支持ispaintable都返回一个非空的字符串[ ]从gettags()返回getastext非空值或（3）从getastext()只是返回一个非空字符串。

每一个属性编辑器必须支持调用setValue参数对象的类型时，这是相应的属性。此外，每个属性必须支持自定义编辑器，或支持setAsText。

每个属性都应该有一个空的构造函数。

方法摘要

所有方法接口方法抽象方法
Modifier and Type	Method and Description
`void`	`addPropertyChangeListener(PropertyChangeListener listener)` 添加一个侦听器的值更改。
`String`	`getAsText()` 获取文本的属性值。
`Component`	`getCustomEditor()` 一个属性可以提供一个全面的自定义组件的编辑其属性值。
`String`	`getJavaInitializationString()` 返回一个片段的java代码，可以用来设置一个属性匹配编辑当前状态。
`String[]`	`getTags()` 如果属性值必须是一个已知的标记值的集合之一，那么该方法应该返回一个标签数组。
`Object`	`getValue()` 获取属性值。
`boolean`	`isPaintable()` 确定此属性编辑器可。
`void`	`paintValue(Graphics gfx, Rectangle box)` 画一个代表性的价值进入一个给定的屏幕面积的屏幕房地产。
`void`	`removePropertyChangeListener(PropertyChangeListener listener)` 移除值更改的侦听器。
`void`	`setAsText(String text)` 通过解析一个给定的字符串来设置属性值。
`void`	`setValue(Object value)` 设置（或更改）要编辑的对象。
`boolean`	`supportsCustomEditor()` 确定此属性编辑器是否支持自定义编辑器。

- 方法详细信息
  - setValue
```
void setValue(Object value)
```
    设置（或更改）要编辑的对象。原始数据类型例如“int”必须用相应的对象类型，如“java。lang.integer”。
    
    参数
    
    value -新的目标对象进行编辑。注意，这个对象不应该由属性修改的属性，而应创造一个新的对象持有任何修正值。
  - getValue
```
Object getValue()
```
    获取属性值。
    
    结果
    
    属性的值。原始数据类型例如“int”将被作为相应的对象类型如“java。lang.integer”。
  - isPaintable
```
boolean isPaintable()
```
    确定此属性编辑器可。
    
    结果
    
    如果类将荣誉paintvalue方法。
  - paintValue
```
void paintValue(Graphics gfx,
                Rectangle box)
```
    画一个代表性的价值进入一个给定的屏幕面积的屏幕房地产。请注意，该属性是负责做自己的剪裁使它适合给定的矩形。
    如果属性不荣誉的涂料的要求（见ispaintable）这种方法应该是一个沉默的空。
    
    给定的图形对象将具有父容器的默认字体、颜色等。该属性可以改变图形的属性，如字体、颜色和不需要恢复旧的价值观。
    
    参数
    
    gfx图形对象来画。
    
    box矩形内的图形对象，我们应该画。
  - getJavaInitializationString
```
String getJavaInitializationString()
```
    返回一个片段的java代码，可以用来设置一个属性匹配编辑当前状态。这种方法的目的是用于生成java代码时反映通过属性编辑器的变化。
    这段代码应该是上下文无关的，必须是一个合法的JLS指定java表达。
    
    具体来说，如果表达式表示一个计算，那么所有的类和静态成员都应该完全合格。此规则适用于构造函数、静态方法和非原始参数。
    
    评估时应使用警告，因为它可能抛出异常。特别地，代码生成器必须确保生成的代码在一个可以抛出检查异常的表达式的存在下编译通过。
    
    实例结果是：
    - 原始的表达：2
    - 类的构造函数：new java.awt.Color(127,127,34)
    - 静电场：java.awt.Color.orange
    - 静态方法：javax.swing.Box.createRigidArea(new java.awt.Dimension(0, 5))
    结果
    
    一段java代码表示的当前值初始化。它不应该包含分号（' ;”）结束的表达。
  - getAsText
```
String getAsText()
```
    获取文本的属性值。
    
    结果
    
    属性值为人编辑的字符串。
    如果该值不能被表示为一个可编辑的字符串返回null。
    
    如果一个非空的值返回，那么属性应该准备回setastext()字符串解析。
  - setAsText
```
void setAsText(String text)
        throws IllegalArgumentException
```
    通过解析一个给定的字符串来设置属性值。可如果字符串的格式不正确或如果这种财产不能表示为提高java.lang.illegalargumentexception文本。
    
    参数
    
    text -被解析的字符串。
    
    异常
    
    IllegalArgumentException
  - getTags
```
String[] getTags()
```
    如果属性值必须是一个已知的标记值的集合之一，那么该方法应该返回一个标签数组。这可以用来表示（例如）枚举值。如果一个属性支持标签，那么它应该与标签值的一种方式，设置和getastext识别当前价值使用价值支持setAsText使用。
    
    结果
    
    此属性的标记值。如果这个属性不能被表示为一个标记值，可能是无效的。
  - getCustomEditor
```
Component getCustomEditor()
```
    一个属性可以提供一个全面的自定义组件的编辑其属性值。它的属性责任挂钩本身到编辑器组件本身和发射的一propertychange事件报告的属性值的变化。
    更高级别的代码调用getcustomeditor可以嵌入在一些较大的属性表的组成部分，也可以把它放在自己的个人对话，或…
    
    结果
    
    一个java.awt.component将允许人类直接编辑当前属性值。可能是无效的，如果这是不支持。
  - supportsCustomEditor
```
boolean supportsCustomEditor()
```
    确定此属性编辑器是否支持自定义编辑器。
    
    结果
    
    如果真的可以提供一个自定义属性编辑器。
  - addPropertyChangeListener
```
void addPropertyChangeListener(PropertyChangeListener listener)
```
    添加一个侦听器的值更改。在属性编辑器中更改其值应在所有注册 PropertyChangeListeners火一 PropertyChangeEvent，指定属性名称的 null价值本身作为源。
    
    参数
    
    listener - PropertyChangeListener添加
  - removePropertyChangeListener
```
void removePropertyChangeListener(PropertyChangeListener listener)
```
    移除值更改的侦听器。
    
    参数
    
    listener - PropertyChangeListener删除

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Interface PropertyEditor

方法摘要

方法详细信息

setValue

getValue

isPaintable

paintValue

getJavaInitializationString

getAsText

setAsText

getTags

getCustomEditor

supportsCustomEditor

addPropertyChangeListener

removePropertyChangeListener