工作表尺寸调整的可行解决方案

背景

在文章 Manage OLE 中,我们说明了如何使用 Aspose.Slides for Java 向 PowerPoint 演示文稿添加 OLE 框。为了解决 object preview issue,我们为 OLE 对象框分配了所选工作表区域的图片。在输出的演示文稿中,双击显示工作表图片的 OLE 对象框会激活 Excel 工作簿。最终用户可以对实际的 Excel 工作簿进行任意更改,然后点击激活的 Excel 工作簿之外的区域返回幻灯片。用户返回幻灯片时,OLE 对象框的大小会发生变化。调整大小的幅度取决于 OLE 对象框和嵌入的 Excel 工作簿的尺寸。

调整大小的原因

由于 Excel 工作簿拥有自己的窗口尺寸,它会在首次激活时尝试保持原始大小。另一方面,OLE 对象框也有自己的尺寸。根据 Microsoft 的说法,当 Excel 工作簿被激活时,Excel 与 PowerPoint 会协商尺寸,以确保在嵌入过程中保持正确的比例。尺寸调整基于 Excel 窗口尺寸与 OLE 对象框的尺寸和位置之间的差异而产生。

工作解决方案

有两种可能的解决方案可以避免尺寸调整效果。

  • 将 PowerPoint 演示文稿中的 OLE 框缩放至匹配所选行列的总高度和宽度。
  • 保持 OLE 框尺寸不变,缩放所选行列以适应框大小。

缩放 OLE 框大小

此方法将 OLE 框的大小设置为匹配嵌入的 Excel 工作表中所选行列的总高度和宽度。

示例加载现有的 Excel 工作簿,并使用零基索引选择其第一个工作表的前 10 行和 13 列。WorksheetCollection.setOleSize 定义了显示范围。预览以 96 DPI 渲染,其像素尺寸使用每英寸 72 点转换为点数。IShapeCollection.addOleObjectFrame 将修改后的工作簿嵌入具有这些尺寸的框中。预览通过 IOleObjectFrame.getSubstitutePictureFormat 分配,以替换已保存演示文稿中的 “EMBEDDED OLE OBJECT” 占位符。

import com.aspose.slides.*;
import java.awt.Image;
import java.io.ByteArrayOutputStream;
import java.io.InputStream;
import javax.imageio.ImageIO;

int startRow = 0, rowCount = 10;
int startColumn = 0, columnCount = 13;
int worksheetIndex = 0;

int imageResolution = 96;

com.aspose.cells.Workbook workbook = new com.aspose.cells.Workbook( "sample.xlsx");
com.aspose.cells.Worksheet worksheet = workbook.getWorksheets().get(worksheetIndex);

// 在 PowerPoint 中将工作簿文件用作 OLE 对象时设置显示尺寸。
int lastRow = startRow + rowCount - 1;
int lastColumn = startColumn + columnCount - 1;
workbook.getWorksheets().setOleSize(startRow, lastRow, startColumn, lastColumn);

com.aspose.cells.Range cellRange = worksheet.getCells().createRange(startRow, startColumn, rowCount, columnCount);
InputStream imageStream = CreateOleImage(cellRange, imageResolution);

// 获取 OLE 图像的宽度和高度(单位为点)。
Image image = ImageIO.read(imageStream);
float imageWidth = image.getWidth(null) * 72f / imageResolution;
float imageHeight = image.getHeight(null) * 72f / imageResolution;

// 我们需要使用已修改的工作簿。
ByteArrayOutputStream oleStream = new ByteArrayOutputStream();
workbook.save(oleStream, com.aspose.cells.SaveFormat.XLSX);
workbook.dispose();

Presentation presentation = new Presentation();
ISlide slide = presentation.getSlides().get_Item(0);

// 将 OLE 图像添加到演示文稿资源中。
imageStream.reset();
IPPImage oleImage = presentation.getImages().addImage(imageStream);
imageStream.close();

// 创建 OLE 对象框。
IOleEmbeddedDataInfo dataInfo = new OleEmbeddedDataInfo(oleStream.toByteArray(), "xlsx");
IOleObjectFrame oleFrame = slide.getShapes().addOleObjectFrame(10, 10, imageWidth, imageHeight, dataInfo);
oleFrame.getSubstitutePictureFormat().getPicture().setImage(oleImage);
oleFrame.setObjectIcon(false);
oleStream.close();

presentation.save("output.pptx", SaveFormat.Pptx);
presentation.dispose();

预览帮助程序将 PageSetup.setPrintArea 设置为所选范围,并移除页边距、页眉和页脚。启用 ImageOrPrintOptions.setOnlyArea 后,SheetRender.toImage 将该范围渲染为 PNG 图像。帮助程序返回一个包含 PNG 图像的新输入流,流指针位于起始位置,以供演示文稿使用。

import java.io.ByteArrayInputStream;
import java.io.ByteArrayOutputStream;
import java.io.InputStream;

static InputStream CreateOleImage(com.aspose.cells.Range cellRange, int imageResolution) throws Exception {
    com.aspose.cells.PageSetup pageSetup = cellRange.getWorksheet().getPageSetup();
    pageSetup.setPrintArea(cellRange.getAddress());
    pageSetup.setLeftMargin(0);
    pageSetup.setRightMargin(0);
    pageSetup.setTopMargin(0);
    pageSetup.setBottomMargin(0);
    pageSetup.clearHeaderFooter();

    com.aspose.cells.ImageOrPrintOptions imageOptions = new com.aspose.cells.ImageOrPrintOptions();
    imageOptions.setImageType(com.aspose.cells.ImageType.PNG);
    imageOptions.setVerticalResolution(imageResolution);
    imageOptions.setHorizontalResolution(imageResolution);
    imageOptions.setOnePagePerSheet(true);
    imageOptions.setOnlyArea(true);

    com.aspose.cells.SheetRender sheetRender = new com.aspose.cells.SheetRender(cellRange.getWorksheet(), imageOptions);
    ByteArrayOutputStream imageStream = new ByteArrayOutputStream();

    sheetRender.toImage(0, imageStream);
    return new ByteArrayInputStream(imageStream.toByteArray());
}

缩放单元格范围大小

此方法缩放所选行的高度和所选列的宽度,以匹配自定义的 OLE 框大小。

示例加载现有的 Excel 工作簿,并使用零基索引选择其第一个工作表的前 10 行和 13 列。WorksheetCollection.setOleSize 定义了显示范围,下面的帮助程序将该范围缩放至宽度为 400 点、高度为 100 点的框中。将修改后的工作簿保存到流后,IShapeCollection.addOleObjectFrame 按指定尺寸嵌入。预览以 96 DPI 渲染后通过 IOleObjectFrame.getSubstitutePictureFormat 分配,使已保存的演示文稿显示所选单元格而非默认占位符。

import com.aspose.slides.*;
import java.io.ByteArrayOutputStream;
import java.io.InputStream;

int startRow = 0, rowCount = 10;
int startColumn = 0, columnCount = 13;
int worksheetIndex = 0;

int imageResolution = 96;
float frameWidth = 400, frameHeight = 100;

com.aspose.cells.Workbook workbook = new com.aspose.cells.Workbook("sample.xlsx");
com.aspose.cells.Worksheet worksheet = workbook.getWorksheets().get(worksheetIndex);

// 当工作簿文件在 PowerPoint 中用作 OLE 对象时设置显示尺寸。
int lastRow = startRow + rowCount - 1;
int lastColumn = startColumn + columnCount - 1;
workbook.getWorksheets().setOleSize(startRow, lastRow, startColumn, lastColumn);

// 将单元格范围缩放以适应框的尺寸。
com.aspose.cells.Range cellRange = worksheet.getCells().createRange(startRow, startColumn, rowCount, columnCount);
ScaleCellRange(cellRange, frameWidth, frameHeight);

InputStream imageStream = CreateOleImage(cellRange, imageResolution);

// 我们需要使用已修改的工作簿。
ByteArrayOutputStream oleStream = new ByteArrayOutputStream();
workbook.save(oleStream, com.aspose.cells.SaveFormat.XLSX);
workbook.dispose();

Presentation presentation = new Presentation();
ISlide slide = presentation.getSlides().get_Item(0);

// 将 OLE 图像添加到演示文稿资源中。
IPPImage oleImage = presentation.getImages().addImage(imageStream);
imageStream.close();

// 创建 OLE 对象框。
IOleEmbeddedDataInfo dataInfo = new OleEmbeddedDataInfo(oleStream.toByteArray(), "xlsx");
IOleObjectFrame oleFrame = slide.getShapes().addOleObjectFrame(10, 10, frameWidth, frameHeight, dataInfo);
oleFrame.getSubstitutePictureFormat().getPicture().setImage(oleImage);
oleFrame.setObjectIcon(false);
oleStream.close();

presentation.save("output.pptx", SaveFormat.Pptx);
presentation.dispose();

缩放帮助程序为所选范围计算宽度和高度的比例,保留列的相对宽度和行的相对高度。它在使用 Cells.setColumnWidthInch 和 Cells.setRowHeightInch 应用之前,将计算得到的尺寸从点转换为英寸。所选范围的宽度和高度必须为非零。

/**
 * @param width     单元格范围的预期宽度(单位:点)。
 * @param height    单元格范围的预期高度(单位:点)。
 */
static void ScaleCellRange(com.aspose.cells.Range cellRange, float width, float height) {
    double rangeWidth = cellRange.getWidth();
    double rangeHeight = cellRange.getHeight();

    for (int i = 0; i < cellRange.getColumnCount(); i++) {
        int columnIndex = cellRange.getFirstColumn() + i;
        double columnWidth = cellRange.getWorksheet()
                .getCells()
                .getColumnWidth(columnIndex, false, com.aspose.cells.CellsUnitType.POINT);

        double newColumnWidth = columnWidth * width / rangeWidth;
        double widthInInches = newColumnWidth / 72.0;
        cellRange.getWorksheet()
                .getCells()
                .setColumnWidthInch(columnIndex, widthInInches);
    }

    for (int i = 0; i < cellRange.getRowCount(); i++) {
        int rowIndex = cellRange.getFirstRow() + i;
        double rowHeight = cellRange.getWorksheet()
                .getCells()
                .getRowHeight(rowIndex, false, com.aspose.cells.CellsUnitType.POINT);

        double newRowHeight = rowHeight * height / rangeHeight;
        double heightInInches = newRowHeight / 72.0;
        cellRange.getWorksheet()
                .getCells()
                .setRowHeightInch(rowIndex, heightInInches);
    }
}

此预览帮助程序使用 SheetRender.toImage 渲染调整大小后的范围。它将 PageSetup.setPrintArea 限定为该范围,移除页边距、页眉和页脚,并返回一个指向起始位置的 PNG 流。

import java.io.ByteArrayInputStream;
import java.io.ByteArrayOutputStream;
import java.io.InputStream;

static InputStream CreateOleImage(com.aspose.cells.Range cellRange, int imageResolution) throws Exception {
    com.aspose.cells.PageSetup pageSetup = cellRange.getWorksheet().getPageSetup();
    pageSetup.setPrintArea(cellRange.getAddress());
    pageSetup.setLeftMargin(0);
    pageSetup.setRightMargin(0);
    pageSetup.setTopMargin(0);
    pageSetup.setBottomMargin(0);
    pageSetup.clearHeaderFooter();

    com.aspose.cells.ImageOrPrintOptions imageOptions = new com.aspose.cells.ImageOrPrintOptions();
    imageOptions.setImageType(com.aspose.cells.ImageType.PNG);
    imageOptions.setVerticalResolution(imageResolution);
    imageOptions.setHorizontalResolution(imageResolution);
    imageOptions.setOnePagePerSheet(true);
    imageOptions.setOnlyArea(true);

    com.aspose.cells.SheetRender sheetRender = new com.aspose.cells.SheetRender(cellRange.getWorksheet(), imageOptions);
    ByteArrayOutputStream imageStream = new ByteArrayOutputStream();

    sheetRender.toImage(0, imageStream);
    return new ByteArrayInputStream(imageStream.toByteArray());
}

结论

常见问题

为什么嵌入的 Excel 工作表在 PowerPoint 中首次激活时会改变大小?

因为 Excel 在激活时会尝试保持原始窗口尺寸,而 PowerPoint 中的 OLE 对象框有自己的尺寸。PowerPoint 与 Excel 会协商尺寸以保持宽高比,这可能导致大小调整。

是否可以完全防止此大小调整问题?

可以。通过将 OLE 框缩放至匹配 Excel 单元格范围大小,或将单元格范围缩放至匹配所需的 OLE 框大小,即可防止不需要的尺寸变化。

应该使用哪种缩放方式,OLE 框缩放还是单元格范围缩放?

如果希望保持 Excel 行列的原始尺寸,请选择 OLE 框缩放。如果希望在演示文稿中获得固定的 OLE 框尺寸,请选择 单元格范围缩放。

这些解决方案在基于模板的演示文稿中也有效吗?

有效。两种解决方案均适用于基于模板创建的演示文稿和从头创建的演示文稿。

使用这些方法时 OLE 框的尺寸是否有限制?

没有限制。只要按比例设置,OLE 对象框可以任意大小。

是否有办法避免 PowerPoint 中的 “EMBEDDED OLE OBJECT” 占位符文本?

可以。通过截取目标 Excel 单元格范围的快照并将其设置为 OLE 框的占位符图像,您可以在默认占位符位置显示自定义预览图像。

相关文章

Creating an Excel Chart and Embedding It in a Presentation as an OLE Object

Updating OLE Objects Automatically Using an MS PowerPoint Add-In