Java操作LibreOffice：如何设置页面边距？

问题描述 #

已通过XPrintable接口设置了纸张方向（PaperOrientation）和纸张格式（PaperFormat），但无法找到设置左右页面边距的方法，且代码中xPageProps始终为null。

原代码 #

static void setPaper(Object oDoc_To_Store, com.sun.star.view.PaperOrientation paperOrientation,com.sun.star.view.PaperFormat paperFormat) {
    com.sun.star.view.XPrintable xPrintable = 
            UnoRuntime.queryInterface(
            com.sun.star.view.XPrintable.class, oDoc_To_Store);
    com.sun.star.beans.PropertyValue[] pv = new com.sun.star.beans.PropertyValue[2];
    pv[0] = new PropertyValue();
    pv[0].Name="PaperOrientation";
    pv[0].Value=paperOrientation;//com.sun.star.view.PaperOrientation.LANDSCAPE;
   // pv[0].State=pv[0].State.DEFAULT_VALUE;
    pv[1] = new PropertyValue();
    pv[1].Name="PaperFormat";
    pv[1].Value=paperFormat;//com.sun.star.view.PaperFormat.A4;
  //  pv[1].State=pv[0].State.DEFAULT_VALUE;

    xPrintable.setPrinter(pv);

    com.sun.star.beans.XPropertySet xPageProps = (com.sun.star.beans.XPropertySet)
        UnoRuntime.queryInterface(
            com.sun.star.beans.XPropertySet.class, xDrawPage);
    if ((xPageProps!=null)) {// Always = null,
        System.out.println("++++++++ xPageProps!=null");
        Property[] pp = xPageProps.getPropertySetInfo().getProperties();// 
        int ii =pp.length;
        for (int i = 0; i < pp.length; i++) {
              System.out.println(pp[i].Name+" "+pp[i].Attributes+" "+pp[i].Type);
        }
    }
}

问题分析与解决 #

1. xPageProps为空的原因及修复

原代码直接使用未初始化的xDrawPage对象，导致接口查询失败。不同类型的LibreOffice文档，获取页面属性集的方式差异明显，需针对性处理：

针对Writer文档（文字处理）

页面边距属于页面样式属性，需从文档的样式家族中获取标准页面样式：

// 从文档对象获取文字文档接口
XTextDocument xTextDoc = UnoRuntime.queryInterface(XTextDocument.class, oDoc_To_Store);
// 获取样式家族容器
XStyleFamiliesSupplier xStyleFamiliesSupplier = UnoRuntime.queryInterface(XStyleFamiliesSupplier.class, xTextDoc);
XNameContainer xStyleFamilies = UnoRuntime.queryInterface(XNameContainer.class, xStyleFamiliesSupplier.getStyleFamilies());
// 获取标准页面样式
XStyle xPageStyle = UnoRuntime.queryInterface(XStyle.class, xStyleFamilies.getByName("Standard"));
// 从页面样式获取属性集
XPropertySet xPageProps = UnoRuntime.queryInterface(XPropertySet.class, xPageStyle);

针对Draw/Impress文档（绘图/演示）

需先获取文档的页面集合，再拿到具体页面对象：

// 获取文档的页面集合供应商接口
XDrawPagesSupplier xDrawPagesSupplier = UnoRuntime.queryInterface(XDrawPagesSupplier.class, oDoc_To_Store);
XDrawPages xDrawPages = xDrawPagesSupplier.getDrawPages();
// 获取第一页（索引从0开始）
Object firstPage = xDrawPages.getByIndex(0);
// 从页面对象获取属性集
XPropertySet xPageProps = UnoRuntime.queryInterface(XPropertySet.class, firstPage);

2. 设置页面边距

获取有效的xPageProps后，即可通过属性名设置边距：

• Writer文档的边距属性：LeftMargin、RightMargin、TopMargin、BottomMargin，单位为1/100毫米（例如20毫米对应2000）
• Draw/Impress文档的边距属性名与Writer一致，部分版本也可通过调整PageWidth、PageHeight配合纸张尺寸实现边距控制

示例代码：

if (xPageProps != null) {
    try {
        // 设置左、右边距为20毫米
        xPageProps.setPropertyValue("LeftMargin", 2000);
        xPageProps.setPropertyValue("RightMargin", 2000);
        // 可选：设置上下边距
        xPageProps.setPropertyValue("TopMargin", 1500);
        xPageProps.setPropertyValue("BottomMargin", 1500);
    } catch (Exception e) {
        e.printStackTrace();
    }
}

3. 补充说明

• 通过XPrintable.setPrinter()设置的是打印参数，而页面边距属于文档本身的页面样式配置，二者是独立的设置项。
• 若处理Calc（表格）文档，页面边距需从XSpreadsheetDocument的打印设置或页面样式中获取，逻辑与Writer类似。

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