如何编写组件监听器

组件监听器是用于接收组件事件的监听器接口。组件是具有可以在屏幕上显示和与用户进行交互的图形表示的对象。一些组件的例子是典型图形用户界面中的按钮、复选框和滚动条。

对组件事件感兴趣的类要么实现这个接口及其包含的所有方法，要么扩展抽象的ComponentAdapter类并只覆盖感兴趣的方法。从该类创建的监听器对象然后使用组件的addComponentListener方法注册到组件中。当组件的大小、位置或可见性发生变化时，监听器对象中的相关方法被调用，并将ComponentEvent传递给它。

一个或多个组件事件会由Component对象在组件被隐藏、显示、移动或调整大小之后触发。

组件隐藏和组件显示事件仅作为调用Component的setVisible方法的结果发生。例如，一个窗口可能被缩小成图标（iconified），而不会触发组件隐藏事件。

要编写一个简单的组件监听器程序，请按照以下步骤：

• 声明一个实现Component监听器的类。例如：

  public class ComponentEventDemo ... implements ComponentListener
  

• 识别您希望捕获事件的组件。例如：pane、label、check box等。
• 将组件监听器添加到已识别的组件上。例如：

  ....
  label.addComponentListener(this);
  .....
  checkbox.addComponentListener(this);
  ....
  panel.addComponentListener(this);
  ...
  frame.addComponentListener(this);
  

• 最后，使用Component监听器的四个方法来捕获这些组件的不同事件，如下所示：

  public void componentHidden(ComponentEvent e) {
          displayMessage(e.getComponent().getClass().getName() + " --- Hidden");
      }
  
      public void componentMoved(ComponentEvent e) {
          displayMessage(e.getComponent().getClass().getName() + " --- Moved");
      }
  
      public void componentResized(ComponentEvent e) {
          displayMessage(e.getComponent().getClass().getName() + " --- Resized ");            
      }
  
      public void componentShown(ComponentEvent e) {
          displayMessage(e.getComponent().getClass().getName() + " --- Shown");
  
      }
  

以下示例演示了组件事件。窗口包含一个带有标签和复选框的面板。复选框控制标签是否可见。文本区域每次窗口、面板、标签或复选框触发组件事件时显示一条消息。

您可以在ComponentEventDemo.java中找到演示代码。以下是处理组件事件的代码：

public class ComponentEventDemo ... implements ComponentListener {
    static JFrame frame;
    JLabel label;
    ...
    public ComponentEventDemo() {
        ...
        JPanel panel = new JPanel(new BorderLayout());
        label = new JLabel("这是一个标签", JLabel.CENTER);
        label.addComponentListener(this);
        panel.add(label, BorderLayout.CENTER);

        JCheckBox checkbox = new JCheckBox("标签可见", true);
        checkbox.addComponentListener(this);
        panel.add(checkbox, BorderLayout.PAGE_END);
        panel.addComponentListener(this);
        ...
        frame.addComponentListener(this);
    }
    ...
     public void componentHidden(ComponentEvent e) {
        displayMessage(e.getComponent().getClass().getName() + " --- 隐藏");
    }

    public void componentMoved(ComponentEvent e) {
        displayMessage(e.getComponent().getClass().getName() + " --- 移动");
    }

    public void componentResized(ComponentEvent e) {
        displayMessage(e.getComponent().getClass().getName() + " --- 调整大小");            
    }

    public void componentShown(ComponentEvent e) {
        displayMessage(e.getComponent().getClass().getName() + " --- 显示");

    }

    public static void main(String[] args) {
        ...
        // 创建并设置窗口。
        frame = new JFrame("ComponentEventDemo");
        ...
        JComponent newContentPane = new ComponentEventDemo();
        frame.setContentPane(newContentPane);
        ...
    }
}

组件监听器 API

组件监听器接口

所有这些方法也在适配器类ComponentAdapter中。

组件事件类

使用组件监听器的示例