Documentation – Render, Print, and Preview

Java: Printing Workbooks

Mon, 01 Jan 0001 00:00:00 +0000

This document is designed to provide developers with an understanding (in a compact manner) of how to print spreadsheets.

Usage Scenario

After you finish creating your spreadsheet, you will probably want to print a hard copy of the sheet for your needs. When you are printing, MS Excel assumes you want to print the entire worksheet area unless you specify your selection. The following screenshot shows the dialog box for printing a workbook with Excel.

Figure: Print Dialog Box

Printing Workbooks using Aspose.Cells

Aspose.Cells for Java provides a toPrinter method of the SheetRender class. By using the SheetRender.toPrinter method, you can provide the printer name as well as the print job name.

Sample Code

Print Selected Worksheet

The following code snippet demonstrates the use of the SheetRender.toPrinter method to print your selected worksheet.

Print Whole Workbook

You can also use the WorkbookRender.toPrinter method to print the whole workbook. The following code snippet demonstrates the use of the WorkbookRender.toPrinter method to print the whole workbook.

Specify Job or Document Name while printing with Aspose.Cells

Java: Converting Worksheet to Different Image Formats

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Cells allows you to export a worksheet from the workbook and convert it into different formats. This article explains how to convert a worksheet to different formats.

Converting Worksheet to Image

Sometimes, it is useful to save a picture of a worksheet. Images can be shared online, inserted into other documents (reports written in Microsoft Word, for example, or PowerPoint presentations).

Aspose.Cells provides image export through the SheetRender class. This class represents the worksheet that will be rendered to an image. The SheetRender class provides the toImage() method for converting a worksheet to an image file. BMP, PNG, JPEG, TIFF, and EMF formats are supported.

Aspose.Cells for Java also supports conversion to TIFF format. To convert a worksheet to a TIFF image, add the JAI library to your classpath.

At present, the worksheet-to-image conversion API does not support 3D-bubble charts.

The code below shows how to convert a worksheet in a Microsoft Excel file to a PNG file.

Converting Worksheet to SVG

SVG stands for Scalable Vector Graphics. SVG is a specification based on XML standards for two-dimensional vector graphics. It is an open standard that has been under development by the World Wide Web Consortium (W3C) since 1999.

Since the release of v7.1.0, Aspose.Cells for Java can convert worksheets into SVG images.

To use this feature, you need to import the com.aspose.cells namespace to your program or project. It has several valuable classes for rendering and printing, for example, SheetRender, ImageOrPrintOptions, WorkbookRender, and others.

The com.aspose.cells.ImageOrPrintOptions class specifies that the worksheet will be saved in SVG format.

The SheetRender class takes an ImageOrPrintOptions object as a parameter, which sets the save format to SVG.

The following code snippet shows how to convert a worksheet in an Excel file to an SVG image file.

Render active worksheet in a workbook

A simple way to convert the active worksheet in a workbook is to set the active sheet index and then save the workbook as SVG. It will render the active sheet to SVG. Following sample code demonstrates this feature:

Java: Generate a Thumbnail Image of a Worksheet

Mon, 01 Jan 0001 00:00:00 +0000

It can be useful to generate thumbnails of worksheets. A thumbnail is a small image that can be pasted into a Word document or a PowerPoint presentation to give a preview of what’s on the worksheet. It can be added to a webpage with a link to download the original document and has a host of other uses.

Aspose.Cells for Java allows you to output worksheets to image files, so making a thumbnail is easy.

The sample code below shows you how, step by step.

Java: Create Transparent Image of Excel Worksheet

Mon, 01 Jan 0001 00:00:00 +0000

Sometimes, you need to generate the image of your worksheet as a transparent image. You want to apply transparency to all cells which have no fill colors. Aspose.Cells provides the ImageOrPrintOptions.setTransparent() property to apply transparency to worksheet image. When this property is false, then cells with no fill colors are drawn with white color and when it is true, cells with no fill colors are drawn transparent.

In the following worksheet image, transparency has not been applied. The cells with no fill colors are drawn white.

Worksheet image without applying transparency

While, in the following worksheet image, transparency has been applied. The cells with no fill colors are transparent.

Worksheet image after applying transparency

You can use the following sample code to generate a transparent image of your Excel worksheet.

Java: Output Blank Page when there is Nothing to Print

Mon, 01 Jan 0001 00:00:00 +0000

Possible Usage Scenarios

If the sheet is empty, then Aspose.Cells will not print anything when you export worksheet to image. You can change this behavior by using ImageOrPrintOptions.OutputBlankPageWhenNothingToPrint property. When you will set it to true, it will print the blank page.

Output Blank Page when there is Nothing to Print

The following sample code creates the empty workbook which has an empty worksheet and renders the empty worksheet to an image after setting the ImageOrPrintOptions.OutputBlankPageWhenNothingToPrint property as true. Consequently, it generates the blank page as there is nothing to print which you can see as below.

Sample Code

Java: Aspose.Cells Font Usage

Mon, 01 Jan 0001 00:00:00 +0000

Java: Convert Excel to High-Resolution Image

Mon, 01 Jan 0001 00:00:00 +0000

With the increasing prevalence of high-resolution screens, images generated at the default 96 DPI often appear blurry and unclear. To ensure clarity on high-resolution screens, it’s essential to generate images at a higher DPI. Aspose.Cells offers the functionality to set ImageOrPrintOptions.HorizontalResolution and ImageOrPrintOptions.VerticalResolution, allowing you to create high-quality images from Excel files that look sharp on high-resolution displays.

Java: Render Sequence of Pages using PageIndex and PageCount Properties of ImageOrPrintOptions

Mon, 01 Jan 0001 00:00:00 +0000

Possible Usage Scenarios

You can render a sequence of pages of your Excel file to images using Aspose.Cells with ImageOrPrintOptions.PageIndex and ImageOrPrintOptions.PageCount properties. These properties are useful when there are so many e.g. thousands of pages in your worksheet but you want to render some of them only. This will not only save the processing time but will also save the memory consumption of the rendering process.

Render Sequence of Pages using PageIndex and PageCount Properties of ImageOrPrintOptions

The following sample code loads the sample Excel file and renders only pages 4, 5, 6, and 7 using the ImageOrPrintOptions.PageIndex and ImageOrPrintOptions.PageCount properties. Here are the rendered pages generated by the code.

Sample Code

Java: Fonts

Mon, 01 Jan 0001 00:00:00 +0000

Java: Get Warnings for Font Substitution while Rendering Excel File

Mon, 01 Jan 0001 00:00:00 +0000

Sometimes, when rendering Microsoft Excel files to PDF, Aspose.Cells substitutes fonts. Aspose.Cells provides a feature that lets developers know that a particular font has been substituted by firing a warning. This is a useful feature that can help you identify why Aspose.Cells rendered PDF is differently than the actual Excel file and you can then take appropriate actions. For example, you can install the missing fonts so that rendering results could look same.

If you want to get the warnings for font substitution while rendering an Excel file to PDF, implement the IWarningCallback interface and set the PdfSaveOptions.setWarningCallback() method with your implemented interface.

The screenshot below shows the source Excel file used in the following code. It has some text in cells A6 and A7 in fonts that are not rendered well by Microsoft Excel.

Aspose.Cells will substitute the fonts in the cells A6 and A7 with suitable fonts as shown below.

Download Source File and Output PDF

You can download the source Excel file and the output PDF from the following links

The following code implements the IWarningCallback and set the PdfSaveOptions.setWarningCallback() method with the implemented interface. Now, whenever any font will be substituted in any cell, Aspose.Cells will fire a warning inside the WarningCallback.warning() method.

 public class WarningCallback implements IWarningCallback {

    @Override

    public void warning(WarningInfo info) {

        if(info.getWarningType() == WarningType.FONT_SUBSTITUTION)

        {

            System.out.println("WARNING INFO: " + info.getDescription());

        }

    }

}

//........

//........

static void Run() throws Exception

{

    Workbook workbook = new Workbook("source.xlsx");

    PdfSaveOptions options = new PdfSaveOptions();

    options.setWarningCallback(new WarningCallback());

    workbook.save("output.pdf", options);

}

Warnings Output

After converting the source file, the following warnings are output to the debug console:

WARNING INFO: Font substitution: Font [ Athene Logos; Regular ] has been substituted in Cell [ A6 ] in Sheet [ Sheet1 ].

WARNING INFO: Font substitution: Font [ B Traffic; Regular ] has been substituted in Cell [ A7 ] in Sheet [ Sheet1 ].

If your spreadsheet contains formulas, it is best to call Workbook.calculateFormula method just before rendering the spreadsheet to PDF format. Doing so will ensure that the formula dependent values are recalculated, and the correct values are rendered in the PDF.

Java: Export Range of Cells in a Worksheet to Image

Mon, 01 Jan 0001 00:00:00 +0000

You can make an image of a worksheet using Aspose.Cells. However, sometimes you need to export only a range of cells in a worksheet to an image. This article explains how to achieve this.

To take an image of a range, set the print area to the desired range and then set all margins to 0. Also set ImageOrPrintOptions.setOnePagePerSheet() to true.

The following code takes an image of the range E8:H10. Below is a screenshot of the source workbook used in the code. You can try the code with any workbook.

Input file

Executing the code creates an image of the range E8:H10 only.

Output image

You may also find the article Converting Worksheet to Different Image Formats helpful.

Java: Workbook and Worksheet Print Preview

Mon, 01 Jan 0001 00:00:00 +0000

Usage Scenario

There may be cases where Excel files with millions of pages need to be converted to PDF or images. Processing such files will consume a lot of time and resources. In such cases, the Workbook and Worksheet Print Preview feature might prove to be useful. Before converting such files, the user can check the total number of pages and then decide whether the file is to be converted or not. This article focuses on using the WorkbookPrintingPreview and SheetPrintingPreview classes to find out the total number of pages.

Workbook and Worksheet Print Preview

Aspose.Cells provides the print preview feature. For this, the API provides WorkbookPrintingPreview and SheetPrintingPreview classes. To create the print preview of the whole workbook, create an instance of the WorkbookPrintingPreview class by passing Workbook and ImageOrPrintOptions objects to the constructor. The WorkbookPrintingPreview class provides an EvaluatedPageCount method which returns the number of pages in the generated preview. Similar to WorkbookPrintingPreview class, the SheetPrintingPreview class is used to generate a print preview for a specific worksheet. To create the print preview of a worksheet, create an instance of the SheetPrintingPreview class by passing Worksheet and ImageOrPrintOptions objects to the constructor. The SheetPrintingPreview class also provides an EvaluatedPageCount method which returns the number of pages in the generated preview.

The following code snippet demonstrates the use of both WorkbookPrintingPreview and SheetPrintingPreview classes by using the sample excel file.

Sample Code

The following is the output generated by executing the above code.

Console Output

Workbook page count: 1</br>
Worksheet page count: 1

Java: Specify Job or Document Name while printing with Aspose.Cells

Mon, 01 Jan 0001 00:00:00 +0000

You can specify job or document name while printing your workbook or worksheet using the WorkbookRender or SheetRender objects. Aspose.Cells provides the WorkbookRender.toPrinter(printerName, jobName) and SheetRender.toPrinter(printerName, jobName) methods that you can use to specify a job name while printing your workbook or worksheet.

Specify Job or Document Name while printing with Aspose.Cells

The sample code loads the source Excel file and then sends it to the printer by specifying the job or document name using the WorkbookRender.toPrinter(printerName, jobName) and SheetRender.toPrinter(printerName, jobName) methods. The screenshot shows how the job name looks in the printer queue.

Printing Workbooks

Java: Generate Conditional Formatting DataBars Images

Mon, 01 Jan 0001 00:00:00 +0000

Sometimes, you need to generate images of Conditional Formatting DataBars. You can use Aspose.Cells DataBar.toImage() method to generate these images. This article shows how to generate a DataBar image using Aspose.Cells.

Example

The following sample code generates the DataBar image of cell C1. First, it accesses the format‑condition object of the cell; then, from that object, it accesses the DataBar object and uses its DataBar.toImage() method to generate the image of the cell. Finally, it saves the image on disk.

Java: Export Worksheet or Chart into Image with Desired Width and Height

Mon, 01 Jan 0001 00:00:00 +0000

You can use Aspose.Cells to export your worksheet or chart into an image with the desired width and height. It provides the ImageOrPrintOptions.setDesiredSize() method to set the desired width and height of the exported image. The width and height are specified in units of pixels.

Export Worksheet into Image with Desired Width and Height

The following code exports the worksheet into an image with a size of 400 × 400 pixels.

Java: Converting Worksheet to Image and Worksheet to Image by Page

Mon, 01 Jan 0001 00:00:00 +0000

This document is designed to provide developers with a detailed understanding of how to convert a worksheet to an image file and a worksheet with multiple pages to an image file per page.

Sometimes, you might need to present worksheets as images, for example, to use them in applications or web pages. You might need to insert the images into a Word document, a PDF file, a PowerPoint presentation, or use them in some other scenario. Simply, you want to render the worksheet as an image. Aspose.Cells APIs support converting worksheets in Microsoft Excel files to images. Also, Aspose.Cells supports converting a workbook to multiple image files, one per page.

Using Aspose.Cells to Convert Worksheet to Image File

This article shows how to use the Aspose.Cells for Java API to convert a worksheet to an image. The API provides several valuable classes, such as SheetRender, ImageOrPrintOptions, WorkbookRender, and so on. The SheetRender class represents a worksheet for rendering images and has an overloaded toImage method that can convert a worksheet to image files directly with any attributes or options set.

Result

After executing the above code, the worksheet named Sheet1 is converted into an image file SheetImage.jpg.

The output JPG

Using Aspose.Cells to Convert Worksheet to Image File by Page

This example shows how to use Aspose.Cells to convert a worksheet from a template workbook that has several pages into one image file per page.

Result

After executing the above code, the worksheet named Sheet1 is converted into two image files (one per page): Sheet 1 Page 1.Tiff and Sheet 1 Page 2.Tiff.

Generated image file (Sheet 1 Page 1.Tiff)

Generated image file (Sheet 1 Page 2.Tiff)

This article shows how to convert a worksheet to an image file and convert worksheets with multiple pages to multiple image files (one per page) using Aspose.Cells. Aspose.Cells offers more flexibility than other components and provides outstanding speed, efficiency, and reliability. The results show that Aspose.Cells has benefited from years of research, design, and careful tuning.

Java: Render the Worksheet and Workbook to Image using ImageOrPrintOptions

Mon, 01 Jan 0001 00:00:00 +0000

This document is designed to provide a detailed understanding of how to convert a worksheet or a workbook to an image file and apply different image and print options for the image, such as resolution, TIFF compression, image format, and page quality.

Overview

Sometimes, you might require presenting your worksheets as a pictorial representation. You may need to present the worksheet images in your applications or web pages. You might need to insert the images into a Word document, a PDF file, a PowerPoint presentation, or use them in some other scenario. Simply, you want a worksheet rendered as an image so that you can use it elsewhere. Aspose.Cells supports converting worksheets in Excel files to images. It also supports setting different options like image format, resolution (both vertical and horizontal), image quality, and other image and print options.

The API provides several valuable classes, for example, SheetRender, ImageOrPrintOptions, WorkbookRender, etc.

The SheetRender class handles the task of rendering images for the worksheet, whereas the WorkbookRender does the same for a workbook. Both aforesaid classes have several overloaded versions of the toImage method that can directly convert a worksheet or a workbook to image file(s) specified with your desired attributes or options. You can save the image file to the disk/stream. There are several image formats supported, e.g., BMP, PNG, GIF, JPEG, TIFF, EMF, and so on.

Convert Worksheet to Image

Conversion Options

It is possible to save specific pages as images. The following code converts the first and second worksheets in a workbook to JPG images.

Or you can cycle through the workbook and render each worksheet in it to a separate image:

Convert Workbook to Image

In order to render the complete workbook to image format, you may either use the above approach or simply use the WorkbookRender class that accepts an instance of Workbook as well as an object of ImageOrPrintOptions.

You can save the whole workbook to a single TIFF image with multiple frames or pages:

Java: Extract Images from Worksheets

Mon, 01 Jan 0001 00:00:00 +0000

Microsoft Excel users can add images to spreadsheets. With Aspose.Cells, it’s possible to read images from Microsoft Excel files and save them to a local drive. This article shows how to achieve this using Aspose.Cells for Java API.

The sample code below shows how to extract images from an Excel file and save them.

Java: Remove White Spaces from the Data before Rendering to Image

Mon, 01 Jan 0001 00:00:00 +0000

Sometimes, you need to present worksheet images in applications or web pages. For example, you might need to insert images into a Word document, a PDF file, a PowerPoint presentation, or some other document. Basically, you want to render a worksheet as an image so that it can be pasted into other applications. Aspose.Cells API allows you to convert Microsoft Excel worksheets to images.

The SheetRender class is capable of converting a worksheet to an image file with any specified attributes, for example, image format, paginated sheets, etc. Several image formats are supported, including BMP, GIF, JPG, TIFF, and EMF.

When you use the sheet‑to‑image feature, the output image has white/blank space (i.e., a border) around it by default. You can remove this. Set the top, left, bottom, and right page‑setup margins for the source worksheet to 0 and specify ImageOrPrintOptions attributes accordingly.

Java: Render Worksheet to Graphic Context

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Cells can now render a worksheet to a graphic context. A graphic context can be anything such as an image file, screen, or printer, etc. Please use the following method to render a worksheet to a graphic context.

SheetRender.toImage(int pageIndex, Graphics2D graphic)

Render Worksheet to Graphic Context

The following code illustrates how to use Aspose.Cells to render a worksheet to a graphic context. Once you execute the code, it will print the entire worksheet and fill the leftover empty space with blue color in the graphic context and save the image as test.png file. You can use any source Excel file to try this code. Please also read the comments inside the code for better understanding.

Java: Set Default Font while rendering spreadsheet to images

Mon, 01 Jan 0001 00:00:00 +0000

Please use the ImageOrPrintOptions.DefaultFont property to set the default font while rendering spreadsheet to images. This property will only be effective when the default font of workbook could not render your characters. The default font specified with ImageOrPrintOptions.DefaultFont property is used for all those cells which have invalid or non-existent fonts.

Set Default Font while rendering spreadsheet to images

The following sample code creates a workbook, adds some text in cell A4 of the first worksheet and sets its font to invalid or non-existent font. Then, it takes two images of the worksheet. The first image is taken by setting the ImageOrPrintOptions.DefaultFont property to Courier New and the second image is taken by setting the ImageOrPrintOptions.DefaultFont property to Times New Roman.

This is the output image after setting the ImageOrPrintOptions.DefaultFont property to Courier New.

This is the output image after setting the ImageOrPrintOptions.DefaultFont property to Times New Roman.

Documentation – Render, Print, and Preview

Java: Printing Workbooks

Usage Scenario

Printing Workbooks using Aspose.Cells

Sample Code

Print Selected Worksheet

Print Whole Workbook

Related Articles

Java: Converting Worksheet to Different Image Formats

Converting Worksheet to Image

Converting Worksheet to SVG

Render active worksheet in a workbook

Related Articles

Java: Generate a Thumbnail Image of a Worksheet

Java: Create Transparent Image of Excel Worksheet

Java: Output Blank Page when there is Nothing to Print

Possible Usage Scenarios

Output Blank Page when there is Nothing to Print

Sample Code

Java: Aspose.Cells Font Usage

Java: Convert Excel to High-Resolution Image

Java: Render Sequence of Pages using PageIndex and PageCount Properties of ImageOrPrintOptions

Possible Usage Scenarios

Render Sequence of Pages using PageIndex and PageCount Properties of ImageOrPrintOptions

Sample Code

Java: Fonts

Java: Get Warnings for Font Substitution while Rendering Excel File

Download Source File and Output PDF

Warnings Output

Java: Export Range of Cells in a Worksheet to Image

Java: Workbook and Worksheet Print Preview

Usage Scenario

Workbook and Worksheet Print Preview

Sample Code

Console Output

Java: Specify Job or Document Name while printing with Aspose.Cells

Specify Job or Document Name while printing with Aspose.Cells

Related Articles

Java: Generate Conditional Formatting DataBars Images

Example

Java: Export Worksheet or Chart into Image with Desired Width and Height

Export Worksheet into Image with Desired Width and Height

Related Articles

Java: Converting Worksheet to Image and Worksheet to Image by Page

Using Aspose.Cells to Convert Worksheet to Image File

Result

Using Aspose.Cells to Convert Worksheet to Image File by Page

Result

Related Articles

Java: Render the Worksheet and Workbook to Image using ImageOrPrintOptions

Overview

Convert Worksheet to Image

Conversion Options

Convert Workbook to Image

Related Articles

Java: Extract Images from Worksheets

Java: Remove White Spaces from the Data before Rendering to Image

Java: Render Worksheet to Graphic Context

Render Worksheet to Graphic Context

Java: Set Default Font while rendering spreadsheet to images

Set Default Font while rendering spreadsheet to images