PAYATHON 2026

如何按 A4 比例缩放 JTextPane 的子组件

数据小陈

结论:JTextPane 的文本内容并不是由一组普通 Component 子节点构成的,所以不能照搬缩放普通组件的方式,遍历 getComponents() 去统一缩放每个“子组件”。要让文本随 A4 页面等比缩放,优先修改 StyledDocument 的字体和样式,让文本布局跟着 JTextPane 的尺寸重新排列;只有通过 insertComponent 插入的内嵌 JComponent,才需要自定义 View/ComponentView,或者在外层做视觉缩放。

原因

JTextPane 继承自 JEditorPane,文本显示依赖 Document 和 View 树。你的 VerticalPageLayoutManager 只设置了 JTextPane 的 bounds,文本会在这个 bounds 内自动换行;默认字体不会因为组件变宽而变大。内嵌组件由 ComponentView 管理,也不会自动按比例修改 bounds。因此,在 JTextPane 上谈“所有 children 缩放”,要分成普通文本和嵌入组件两类来看。

推荐做法一:按 A4 宽度缩放文档字体

如果希望在页面变宽或变窄时让文字整体按比例缩放,调整字体会比较稳妥。A4 竖版宽度约为 595pt(210mm/25.4*72,近似值)。示例:

import javax.swing.*;
import javax.swing.text.*;

public class A4TextPane extends JTextPane {
    private static final float A4_WIDTH_PT = 595f;
    private static final float BASE_FONT_SIZE = 12f;
    private boolean scaling;

    public void updateFontScale() {
        if (scaling) return;
        int w = getWidth();
        if (w <= 0) return;

        scaling = true;
        try {
            float scale = w / A4_WIDTH_PT;
            int fontSize = Math.max(1, Math.round(BASE_FONT_SIZE * scale));

            StyledDocument doc = getStyledDocument();
            Style defaultStyle = doc.getStyle(StyleContext.DEFAULT_STYLE);
            StyleConstants.setFontSize(defaultStyle, fontSize);

            // 如果已有文本显式设置了字号,需要按你的文档策略同步处理,
            // 否则这些字符不会跟着默认样式变化。
            revalidate();
            repaint();
        } finally {
            scaling = false;
        }
    }

    @Override
    public void setBounds(int x, int y, int width, int height) {
        super.setBounds(x, y, width, height);
        updateFontScale();
    }
}

更推荐的做法是:在文档里只定义几个命名 Style,缩放时修改这些 Style 的 FontSize,插入文本时让文本引用样式。这样比遍历整个文档逐个设置字符属性更可控。

嵌入组件怎么处理

通过 JTextPane.insertComponent(component) 插入的组件,会作为 ComponentView 出现在 View 树里。这类组件不会因为 JTextPane 改宽而自动等比缩放,也不建议直接 for (Component c : textPane.getComponents()) 去设置缩放,因为文本本身不是 Component,而且 ComponentView 的 bounds 由 View 布局决定。

需要自定义 ViewFactory,返回自己的 ComponentView 子类,在 setSize/layout 中根据缩放因子设置内部组件尺寸。下面只是入口骨架,不是完整可运行实现:

class ScaledComponentView extends ComponentView {
    private final float scale;

    ScaledComponentView(Element elem, float scale) {
        super(elem);
        this.scale = scale;
    }

    @Override
    public void setSize(float width, float height) {
        super.setSize(width, height);
        Component c = getComponent();
        if (c != null) {
            int w = Math.max(1, Math.round(width));
            int h = Math.max(1, Math.round(height));
            c.setBounds(0, 0, w, h);
        }
    }
}

实际接入时,要让 JTextPane 的 EditorKit 使用自定义 ViewFactory,并在页面宽度变化后重新布局 View 树。

只想整体视觉缩放

如果只是打印预览式缩放,可以在外层用 JLayer/JPanel 的 paintComponent 里 Graphics2D.scale 画 JTextPane。但这只影响绘制,鼠标坐标、滚动范围和光标定位需要另外转换;编辑交互要求高时,不建议作为首选。

注意事项

  • VerticalPageLayoutManager.preferredLayoutSize 里用 parent.getSize() 在首次布局时可能还是 0,建议基于 viewport 宽度或 parent.getWidth() 做保护。
  • JTextPane 的 margin 和文档边距也要跟页面缩放一起调,否则文字区域比例会偏。
  • 字体缩放会改变换行位置,这是正常现象;如果要固定分页,需要按字体度量重新计算分页/分栏。
  • A4 尺寸用 595pt 是近似值,实际可按 210mm/25.4*72 计算。

备注:内容仅供参考。