如何编写属性更改监听器

每当一个绑定属性的值对于一个符合JavaBeans™规范的bean（即一个组件）发生变化时，就会触发属性更改事件。你可以从Java教程的JavaBeansJavaBeans部分了解更多关于beans的信息。所有的Swing组件也都是beans。

JavaBeans属性通过其get和set方法来访问。例如，JComponent具有属性font，可以通过getFont和setFont方法来访问。

除了get和set方法之外，当绑定属性的值发生变化时，会触发属性更改事件。更多信息，请参见JavaBeans教程中的Bound Properties页面。

常见需要属性更改监听器的一些场景包括：

• 你已经实现了一个格式化文本字段，并且需要检测用户何时输入了一个新值。你可以在格式化文本字段上注册一个属性更改监听器来监听value属性的变化。在如何使用格式化文本字段中的FormattedTextFieldDemo示例中可以看到这个用法。
• 你已经实现了一个对话框，并且需要知道用户何时点击了对话框的按钮或者在对话框中改变了选择。在如何创建对话框中的DialogDemo示例中可以看到在选项面板上注册属性更改监听器来监听value属性的变化。此外，你还可以在如何使用文件选择器中的FileChooserDemo2示例中了解如何注册属性更改监听器来监听directoryChanged和selectedFileChanged属性的变化。
• 你需要在具有焦点的组件发生变化时收到通知。你可以在键盘焦点管理器上注册一个属性更改监听器来监听focusOwner属性的变化。在如何使用焦点子系统中的TrackFocusDemo和DragPictureDemo示例中可以看到这个用法。

虽然这些是一些常见使用属性更改监听器的场景，但你可以在符合JavaBeans规范的任何组件的绑定属性上注册一个属性更改监听器。

有两种方法可以注册属性更改监听器。第一种方法是使用addPropertyChangeListener(PropertyChangeListener)方法。当以这种方式注册监听器时，你将收到该对象的每个绑定属性的每个更改的通知。在propertyChange方法中，你可以使用PropertyChangeEvent的getPropertyName方法获取已更改的属性的名称，如下代码片段所示：

KeyboardFocusManager focusManager =
   KeyboardFocusManager.getCurrentKeyboardFocusManager();
focusManager.addPropertyChangeListener(new FocusManagerListener());
...
public FocusManagerListener implements PropertyChangeListener {
    public void propertyChange(PropertyChangeEvent e) {
        String propertyName = e.getPropertyName();
        if ("focusOwner".equals(propertyName) {
            ...
        } else if ("focusedWindow".equals(propertyName) {
            ...
        }
    }
    ...
}

第二种注册属性更改监听器的方法使用了addPropertyChangeListener(String, PropertyChangeListener)方法。其中String参数是属性的名称。使用这种方法意味着只有当该特定属性发生更改时，才会收到通知。例如，如果像下面这样注册一个属性更改监听器：

aComponent.addPropertyChangeListener("font",
                                     new FontListener());

FontListener只有在组件的font属性的值发生变化时才会收到通知。它不会在transferHandler、opaque、border或任何其他属性的值发生变化时收到通知。

下面的示例演示了如何使用addPropertyChangeListener的两个参数版本，在格式化文本字段的value属性上注册属性更改监听器：

//...初始化时的代码：
double amount;
JFormattedTextField amountField;
...
amountField.addPropertyChangeListener("value",
                                      new FormattedTextFieldListener());
...
class FormattedTextFieldListener implements PropertyChangeListener {
    public void propertyChanged(PropertyChangeEvent e) {
        Object source = e.getSource();
        if (source == amountField) {
            amount = ((Number)amountField.getValue()).doubleValue();
            ...
        }
        ...//重新计算付款并更新字段...
    }
}

属性更改监听器API

注册属性更改监听器

PropertyChangeListener接口

因为PropertyChangeListener只有一个方法，所以它没有相应的适配器类。

PropertyChangeEvent类

使用属性更改监听器的示例

下表列出了使用属性更改监听器的示例。