如何在JScrollPane中让图片保持左上对齐显示

问题根源在于JScrollPane的视口默认会将小于视口尺寸的组件居中显示，同时JLabel默认垂直居中对齐内部图标，两者叠加导致了图片垂直居中的现象。以下是两种可行的解决方案：

方案一：用GridBagLayout包裹JLabel #

通过GridBagLayout将JLabel锚定在面板左上角，同时让面板填充整个视口，多余空间自然留在右下。

修改步骤： #

1. 给JLabel设置图标对齐方式：

private final JLabel imgLabel = new JLabel();
// 强制图标左上对齐
imgLabel.setVerticalAlignment(JLabel.TOP);
imgLabel.setHorizontalAlignment(JLabel.LEFT);

2. 修改createImagePane方法，用GridBagLayout面板包裹JLabel：

private JScrollPane createImagePane(JLabel image) {
    JPanel panel = new JPanel(new GridBagLayout());
    GridBagConstraints gbc = new GridBagConstraints();
    gbc.anchor = GridBagConstraints.NORTHWEST; // 组件锚定左上
    gbc.weightx = 1.0; // 允许面板水平扩展
    gbc.weighty = 1.0; // 允许面板垂直扩展
    panel.add(image, gbc);

    JScrollPane scrollPane = new JScrollPane(panel);
    scrollPane.setHorizontalScrollBarPolicy(ScrollPaneConstants.HORIZONTAL_SCROLLBAR_ALWAYS);
    scrollPane.setVerticalScrollBarPolicy(ScrollPaneConstants.VERTICAL_SCROLLBAR_ALWAYS);
    scrollPane.setCursor(Cursor.getPredefinedCursor(Cursor.CROSSHAIR_CURSOR));
    return scrollPane;
}

方案二：自定义视口布局 #

直接重写JViewport的布局逻辑，强制视图组件始终左上对齐，无需额外面板。

修改createImagePane方法： #

private JScrollPane createImagePane(JLabel image) {
    JScrollPane scrollPane = new JScrollPane(image);
    // 自定义视口布局，强制组件左上对齐
    scrollPane.getViewport().setLayout(new ViewportLayout() {
        @Override
        public void layoutContainer(Container parent) {
            JViewport viewport = (JViewport) parent;
            Component view = viewport.getView();
            if (view == null) return;

            Dimension viewSize = view.getPreferredSize();
            Dimension viewportSize = viewport.getSize();

            int x = viewSize.width < viewportSize.width ? 0 : viewport.getViewPosition().x;
            int y = viewSize.height < viewportSize.height ? 0 : viewport.getViewPosition().y;
            
            viewport.setViewPosition(new Point(x, y));
        }
    });
    // 确保JLabel图标左上对齐
    image.setVerticalAlignment(JLabel.TOP);
    image.setHorizontalAlignment(JLabel.LEFT);

    scrollPane.setHorizontalScrollBarPolicy(ScrollPaneConstants.HORIZONTAL_SCROLLBAR_ALWAYS);
    scrollPane.setVerticalScrollBarPolicy(ScrollPaneConstants.VERTICAL_SCROLLBAR_ALWAYS);
    scrollPane.setCursor(Cursor.getPredefinedCursor(Cursor.CROSSHAIR_CURSOR));
    return scrollPane;
}

两种方案均能实现：当面板尺寸大于图片时，图片左上对齐，多余空间留在底部和右侧；当面板尺寸小于图片时，滚动条正常工作。

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