模块 java.desktop
包 java.beans

类 PropertyEditorSupport

java.lang.Object
java.beans.PropertyEditorSupport
所有已实现的接口：
PropertyEditor
public class PropertyEditorSupport extends Object implements PropertyEditor
这是一个帮助构建属性编辑器的支持类。

它可以用作基类或委托。

自从：
1.1

  • 构造方法详细信息

    • 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 方法，则为真。

    • paintValue

      public void paintValue(Graphics  gfx, Rectangle  box)
      将值的表示绘制到屏幕空间的给定区域中。请注意，propertyEditor 负责进行自己的裁剪，以使其适合给定的矩形。

      如果 PropertyEditor 不接受绘画请求（请参阅 isPaintable），则此方法应该是静默的 noop。

      指定者：
      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。

      如果返回非空值，则 PropertyEditor 应准备好在 setAsText() 中解析该字符串。

    • setAsText

      public void setAsText(String  text) throws IllegalArgumentException
      通过解析给定的字符串设置属性值。如果 String 格式错误或此类属性不能表示为文本，则可能引发 java.lang.IllegalArgumentException。
      指定者：
      setAsText 在接口 PropertyEditor 中
      参数：
      text - 要解析的字符串。
      抛出：
      IllegalArgumentException

    • getTags

      public String [] getTags()
      如果属性值必须是一组已知标记值中的一个，则此方法应返回一个标记值数组。这可用于表示（例如）枚举值。如果 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 可以提供自定义编辑器，则为真。

    • addPropertyChangeListener

      public void addPropertyChangeListener(PropertyChangeListener  listener)
      添加值更改的监听器。当属性编辑器更改其值时，它应该在所有已注册的 PropertyChangeListener 上触发 PropertyChangeEvent ，为属性名称指定 null 值。如果设置了 source 属性，则应将其用作事件的源。

      同一个监听器对象可能被添加多次，添加多少次就会被调用多少次。如果 listener 是 null ，则不会抛出异常并且不会采取任何操作。

      指定者：
      addPropertyChangeListener 在接口 PropertyEditor 中
      参数：
      listener - 要添加的 PropertyChangeListener

    • removePropertyChangeListener

      public void removePropertyChangeListener(PropertyChangeListener  listener)
      删除值更改的监听。

      如果同一个监听器被添加了不止一次，它在被移除后会少收到一次通知。如果 listener 是 null ，或者从未添加过，则不会抛出异常并且不会采取任何操作。

      指定者：
      removePropertyChangeListener 在接口 PropertyEditor 中
      参数：
      listener - 要删除的 PropertyChangeListener

    • firePropertyChange

      public void firePropertyChange()
      报告我们已经修改给任何感兴趣的听众。