Chart.ExportAsFixedFormat Method

Reference

Definition

Namespace:: Microsoft.Office.Tools.Excel

Assembly:: Microsoft.Office.Tools.Excel.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Saves the chart in either PDF or XPS format.

public void ExportAsFixedFormat (Microsoft.Office.Interop.Excel.XlFixedFormatType Type, object Filename, object Quality, object IncludeDocProperties, object IgnorePrintAreas, object From, object To, object OpenAfterPublish, object FixedFormatExtClassPtr);

abstract member ExportAsFixedFormat : Microsoft.Office.Interop.Excel.XlFixedFormatType * obj * obj * obj * obj * obj * obj * obj * obj -> unit

Public Sub ExportAsFixedFormat (Type As XlFixedFormatType, Optional Filename As Object, Optional Quality As Object, Optional IncludeDocProperties As Object, Optional IgnorePrintAreas As Object, Optional From As Object, Optional To As Object, Optional OpenAfterPublish As Object, Optional FixedFormatExtClassPtr As Object)

Parameters

Type: XlFixedFormatType

One of the T:Microsoft.Office.Interop.Excel.XlFixedFormatType values that specifies whether to save the chart in PDF or XPS format.

Filename: Object

The full path of the new PDF or XPS file. If you omit this parameter, Excel saves the file in the current folder.

Quality: Object

One of the T:Microsoft.Office.Interop.Excel.XlFixedFormatQuality values that specifies the quality of the exported file.

IncludeDocProperties: Object

true to include document properties in the exported file; otherwise, false.

IgnorePrintAreas: Object

true to ignore any print areas set when exporting; otherwise, false.

From: Object

The number of the page at which to start exporting. If this parameter is omitted, exporting starts at the beginning.

To: Object

The number of the last page to export. If this parameter is omitted, exporting ends with the last page.

OpenAfterPublish: Object

true to open the new file after exporting the chart; otherwise, false.

FixedFormatExtClassPtr: Object

A pointer to an implementation of the IMsoDocExporter interface that enables the chart to be saved in a different fixed format. For more information, see Extending the Office (2007) Fixed-Format Export Feature.

Examples

The following code example saves one page of the chart Chart_1 of worksheet Sheet1 in PDF format to the specified file path and file name using the standard quality resolution. The generated PDF file includes the workbook properties. To run this code example, your workbook must include a sheet named Sheet1 with a chart named Chart_1.

private void SaveChartAsPDF()
{
    Microsoft.Office.Tools.Excel.Chart myChart = 
        Globals.Sheet1.Chart_1;

    myChart.ExportAsFixedFormat(
        Excel.XlFixedFormatType.xlTypePDF, 
        @"c:\SalesChart", 
        Excel.XlFixedFormatQuality.xlQualityStandard, 
        true, 
        true, 
        1, 
        1,
        false);
}

Private Sub SaveChartAsPDF()
    Dim myChart As Microsoft.Office.Tools.Excel.Chart = _
        Globals.Sheet1.Chart_1

    myChart.ExportAsFixedFormat( _
        Excel.XlFixedFormatType.xlTypePDF, _
        "c:\SalesChart", _
        Excel.XlFixedFormatQuality.xlQualityStandard, _
        True, _
        True, _
        1, _
        1, _
        False)
End Sub

Remarks

You can save as a PDF or XPS file from Microsoft Office Excel only after you install an add-in that provides this feature. For more information, search for "Enable support for other file formats, such as PDF and XPS" on Office Online.

Optional Parameters

For information about optional parameters, see Optional Parameters in Office Solutions.

Applies to

Share via