JButton添加ActionListener/MouseListener无法设置JPanel绘图颜色求助

AI 小北

2026-8-9

问题：Java模拟Win95 Paint时调色板按钮无法切换画笔颜色

我正在开发一款模拟Windows 95版Microsoft Paint的Java程序，程序底部设有调色板，点击调色板中的颜色按钮可更改画笔等绘图工具的颜色。尝试通过Graphics2D根据点击的颜色按钮设置绘图工具的颜色，先后为代表颜色按钮的JButton添加ActionListener和MouseListener，但两种方式均无法生效。怀疑问题源于监听器被嵌套在循环及MouseMotionListener中，寻求可行的代码改写方案。

原代码片段：

paintOpen = new JFrame();
paintCanvasPanel = new JPanel() {
  private static final long serialVersionUID = 1L;
  public void paintComponent(Graphics g) {
    this.addMouseMotionListener(new MouseMotionListener() {
      public void mouseDragged(MouseEvent e) {
        if (SwingUtilities.isLeftMouseButton(e)) {
          Graphics2D g = (Graphics2D) getGraphics();
          g.drawLine(e.getX(), e.getY(), e.getXOnScreen(), e.getYOnScreen());
          g.setRenderingHint(RenderingHints.KEY_ANTIALIASING, RenderingHints.VALUE_ANTIALIAS_ON);
          g.setStroke(new BasicStroke(WIDTH, BasicStroke.CAP_SQUARE, BasicStroke.JOIN_BEVEL));
          for (int i = 0; i < 28; i++) {
            //Neither ActionListener nor MouseListener works
            paintColorButton[i].addMouseListener(new MouseAdapter() {
              public void mousePressed(MouseEvent e) {
                for (int j = 0; j < 28; j++) {
                  g.setColor(paintPaletteColor[j]);
                }
              }

            });
          }
        }
      }
      public void mouseMoved(MouseEvent e) {

      }
    });

  }
};
paintScrollPane = new JScrollPane(paintCanvasPanel);
paintScrollPane.setBackground(white);
paintScrollPane.setHorizontalScrollBarPolicy(JScrollPane.HORIZONTAL_SCROLLBAR_ALWAYS);
paintScrollPane.setVerticalScrollBarPolicy(JScrollPane.VERTICAL_SCROLLBAR_ALWAYS);
paintOpen.getContentPane().add(paintScrollPane);
paintOpen.getContentPane().setBackground(white);
paintOpen.setAlwaysOnTop(true);
paintOpen.setBounds(200, 0, 420, 600);
paintOpen.setExtendedState(JFrame.MAXIMIZED_BOTH);
paintOpen.setIconImage(paintIcon.getImage());
paintOpen.setTitle("untitled - Paint");
paintPalettePanel = new JPanel();
paintColorButton = new JButton[28];
for (int i = 0; i < 28; i++) {
  paintColorButton[i] = new JButton();
  paintColorButton[i].setBackground(paintPaletteColor[i]);
  paintPalettePanel.add(paintColorButton[i]);
}
paintOpen.add(paintPalettePanel, BorderLayout.SOUTH);
}

尝试替换为ActionListener后的无效代码：

for (int i = 0; i < 28; i++) {
              paintColorButton[i].addActionListener(new ActionListener() {
                public void actionPerformed(ActionEvent e) {
                  for (int j = 0; j < 28; j++) {
                    g.setColor(paintPaletteColor[j]);
                  }
                }

              });
            }

问题根源

监听器嵌套位置错误：将颜色按钮的监听器放在paintComponent内的mouseDragged方法中，导致只有拖拽鼠标时才会重复给按钮绑定监听器，且监听器内的g是临时获取的失效Graphics对象。
颜色逻辑完全错误：监听器内循环遍历所有颜色，最终画笔颜色只会被设为最后一个调色板颜色，完全未对应点击的按钮。
错误获取绘图上下文：用getGraphics()获取的Graphics是临时对象，组件重绘后立即失效，不符合Swing绘图规范。
paintComponent方法滥用：该方法仅用于组件绘制，不应在此添加鼠标监听器，监听器应在组件初始化时仅绑定一次。

修正后的完整代码

import javax.swing.*;
import java.awt.*;
import java.awt.event.*;
import java.util.ArrayList;
import java.util.List;

public class Win95Paint extends JFrame {
    private JPanel paintCanvasPanel;
    private JPanel paintPalettePanel;
    private JButton[] paintColorButton;
    // 全局存储当前画笔颜色，默认黑色
    private Color currentBrushColor = Color.BLACK;
    private static final int BRUSH_WIDTH = 2;
    // Win95风格调色板颜色示例
    private Color[] paintPaletteColor = {
        Color.BLACK, Color.WHITE, Color.GRAY, Color.LIGHT_GRAY,
        Color.RED, Color.PINK, Color.ORANGE, Color.YELLOW,
        Color.GREEN, Color.MAGENTA, Color.CYAN, Color.BLUE,
        new Color(0x800000), new Color(0xFF00FF), new Color(0x808000), new Color(0xFFFF00),
        new Color(0x008000), new Color(0x00FF00), new Color(0x008080), new Color(0x00FFFF),
        new Color(0x000080), new Color(0x0000FF), new Color(0x800080), new Color(0xFF00FF),
        new Color(0xC0C0C0), new Color(0x808080), new Color(0x800000), new Color(0xFF0000)
    };

    public Win95Paint() {
        initUI();
    }

    private void initUI() {
        setTitle("untitled - Paint");
        setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        setExtendedState(JFrame.MAXIMIZED_BOTH);
        setBackground(Color.WHITE);

        // 初始化画布面板
        paintCanvasPanel = new JPanel() {
            private static final long serialVersionUID = 1L;
            // 存储所有绘制的线条，避免重绘丢失内容
            private List<Line> drawnLines = new ArrayList<>();

            @Override
            protected void paintComponent(Graphics g) {
                super.paintComponent(g);
                Graphics2D g2d = (Graphics2D) g;
                // 配置画笔样式
                g2d.setRenderingHint(RenderingHints.KEY_ANTIALIASING, RenderingHints.VALUE_ANTIALIAS_ON);
                g2d.setStroke(new BasicStroke(BRUSH_WIDTH, BasicStroke.CAP_SQUARE, BasicStroke.JOIN_BEVEL));
                // 绘制所有存储的线条
                for (Line line : drawnLines) {
                    g2d.setColor(line.color);
                    g2d.drawLine(line.x1, line.y1, line.x2, line.y2);
                }
            }

            public List<Line> getDrawnLines() {
                return drawnLines;
            }
        };
        paintCanvasPanel.setBackground(Color.WHITE);

        // 为画布添加鼠标拖拽监听器（仅绑定一次）
        paintCanvasPanel.addMouseMotionListener(new MouseMotionAdapter() {
            private int lastX, lastY;

            @Override
            public void mousePressed(MouseEvent e) {
                if (SwingUtilities.isLeftMouseButton(e)) {
                    lastX = e.getX();
                    lastY = e.getY();
                }
            }

            @Override
            public void mouseDragged(MouseEvent e) {
                if (SwingUtilities.isLeftMouseButton(e)) {
                    int currX = e.getX();
                    int currY = e.getY();
                    // 添加新线条到存储列表
                    ((Win95PaintCanvas) paintCanvasPanel).getDrawnLines().add(
                            new Line(lastX, lastY, currX, currY, currentBrushColor)
                    );
                    // 触发重绘
                    paintCanvasPanel.repaint();
                    // 更新上一次坐标
                    lastX = currX;
                    lastY = currY;
                }
            }
        });

        // 画布添加到滚动面板
        JScrollPane paintScrollPane = new JScrollPane(paintCanvasPanel);
        paintScrollPane.setBackground(Color.WHITE);
        paintScrollPane.setHorizontalScrollBarPolicy(JScrollPane.HORIZONTAL_SCROLLBAR_ALWAYS);
        paintScrollPane.setVerticalScrollBarPolicy(JScrollPane.VERTICAL_SCROLLBAR_ALWAYS);
        add(paintScrollPane, BorderLayout.CENTER);

        // 初始化调色板面板
        paintPalettePanel = new JPanel();
        paintColorButton = new JButton[28];
        for (int i = 0; i < 28; i++) {
            paintColorButton[i] = new JButton();
            paintColorButton[i].setBackground(paintPaletteColor[i]);
            paintColorButton[i].setPreferredSize(new Dimension(30, 30));
            // 绑定按钮点击事件（仅绑定一次）
            final int colorIndex = i;
            paintColorButton[i].addActionListener(e -> {
                currentBrushColor = paintPaletteColor[colorIndex];
            });
            paintPalettePanel.add(paintColorButton[i]);
        }
        add(paintPalettePanel, BorderLayout.SOUTH);

        pack();
        setVisible(true);
    }

    // 内部类：存储单条线条的坐标与颜色
    private static class Line {
        int x1, y1, x2, y2;
        Color color;

        Line(int x1, int y1, int x2, int y2, Color color) {
            this.x1 = x1;
            this.y1 = y1;
            this.x2 = x2;
            this.y2 = y2;
            this.color = color;
        }
    }

    // 内部接口：用于获取画布的线条列表
    private interface Win95PaintCanvas {
        List<Line> getDrawnLines();
    }

    public static void main(String[] args) {
        SwingUtilities.invokeLater(Win95Paint::new);
    }
}

关键修正说明

全局颜色变量：新增currentBrushColor存储当前画笔颜色，点击调色板按钮时直接修改该变量，绘图时统一使用它。
监听器位置调整：所有监听器均在组件初始化阶段绑定，避免重复绑定及无效上下文问题。
标准绘图逻辑：用Line类存储所有绘制内容，在paintComponent中统一绘制，彻底解决重绘丢失内容的问题。
修复颜色绑定逻辑：点击调色板按钮时，直接获取当前按钮对应的颜色，不再循环遍历所有颜色。
移除临时Graphics对象：所有绘图操作均在paintComponent内完成，符合Swing绘图规范，保证绘图持久性。

内容的提问来源于stack exchange，提问作者Javaeur

JButton添加ActionListener/MouseListener无法设置JPanel绘图颜色求助

问题根源 #

修正后的完整代码 #

关键修正说明 #

问题根源

修正后的完整代码

关键修正说明