如何按 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计算。
备注:内容仅供参考。
