UR机器人URCap开发：JScrollPane中JCheckBox列表不显示问题

方案一：修复JPanel+JScrollPane的实现问题 #

你遇到的问题大概率是JPanel布局管理器未正确设置或者组件未触发刷新导致的。默认FlowLayout在组件过多时无法正确垂直排列，且若JPanel没有足够垂直空间，复选框会被隐藏。

代码示例 #

// 创建垂直排列的JPanel，使用BoxLayout确保选项纵向排列
JPanel checkBoxPanel = new JPanel();
checkBoxPanel.setLayout(new BoxLayout(checkBoxPanel, BoxLayout.Y_AXIS));

// 批量添加64个JCheckBox
for (int i = 1; i <= 64; i++) {
    JCheckBox checkBox = new JCheckBox("选项 " + i);
    // 给复选框添加边距，避免布局过于紧凑
    checkBox.setBorder(BorderFactory.createEmptyBorder(2, 5, 2, 5));
    checkBoxPanel.add(checkBox);
}

// 创建JScrollPane并将JPanel设为视口内容
JScrollPane scrollPane = new JScrollPane(checkBoxPanel);
// 适配URCap容器，设置滚动面板的首选尺寸
scrollPane.setPreferredSize(new Dimension(300, 400));

// 添加到URCap UI容器后，强制触发组件布局刷新
checkBoxPanel.revalidate();
checkBoxPanel.repaint();

核心要点 #

• 必须给JPanel设置BoxLayout（垂直方向），确保复选框纵向排列，超出高度后自动激活滚动。
• 添加完所有复选框后调用revalidate()和repaint()，强制Swing重新计算布局并绘制组件。

方案二：使用JList实现复选框列表（更推荐） #

对于大量可多选的复选框，使用JList搭配自定义单元格渲染器是更规范的Swing实现，维护性更高。

代码示例 #

// 创建列表数据模型，存储每个选项的文本和选中状态
DefaultListModel<CheckBoxItem> listModel = new DefaultListModel<>();
for (int i = 1; i <= 64; i++) {
    listModel.addElement(new CheckBoxItem("选项 " + i, false));
}

// 创建JList并绑定模型，设置自定义渲染器
JList<CheckBoxItem> checkBoxList = new JList<>(listModel);
checkBoxList.setCellRenderer(new CheckBoxListRenderer());
// 开启多选模式
checkBoxList.setSelectionMode(ListSelectionModel.MULTIPLE_INTERVAL_SELECTION);
// 固定每行高度，保证布局整齐
checkBoxList.setFixedCellHeight(25);

// 用JScrollPane包裹JList
JScrollPane scrollPane = new JScrollPane(checkBoxList);
scrollPane.setPreferredSize(new Dimension(300, 400));

辅助类定义 #

// 存储复选框的文本与选中状态
class CheckBoxItem {
    private String text;
    private boolean selected;

    public CheckBoxItem(String text, boolean selected) {
        this.text = text;
        this.selected = selected;
    }

    public String getText() { return text; }
    public boolean isSelected() { return selected; }
    public void setSelected(boolean selected) { this.selected = selected; }
}

// 自定义单元格渲染器，将每个列表项绘制成复选框
class CheckBoxListRenderer extends JCheckBox implements ListCellRenderer<CheckBoxItem> {
    @Override
    public Component getListCellRendererComponent(JList<? extends CheckBoxItem> list, CheckBoxItem value, int index, boolean isSelected, boolean cellHasFocus) {
        setText(value.getText());
        setSelected(value.isSelected());
        // 匹配系统选中样式
        setBackground(isSelected ? list.getSelectionBackground() : list.getBackground());
        setForeground(isSelected ? list.getSelectionForeground() : list.getForeground());
        return this;
    }
}

// 添加鼠标监听器，处理复选框点击切换事件
checkBoxList.addMouseListener(new MouseAdapter() {
    @Override
    public void mouseClicked(MouseEvent e) {
        int index = checkBoxList.locationToIndex(e.getPoint());
        if (index != -1) {
            CheckBoxItem item = listModel.getElementAt(index);
            item.setSelected(!item.isSelected());
            checkBoxList.repaint();
        }
    }
});

核心要点 #

• 用数据模型绑定复选框状态，避免手动管理大量组件的状态同步。
• 鼠标监听器负责触发复选框的选中状态切换，弥补JList默认选中逻辑与复选框的分离问题。

URCap额外注意事项 #

URCap的UI组件必须在EDT事件调度线程中创建和更新，若代码在非EDT线程执行，可能导致组件不显示。可以用以下方式包裹UI创建逻辑：

SwingUtilities.invokeLater(() -> {
    // 在这里创建JScrollPane和复选框列表
});

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