Configures the exporting and printing features.
These features allow a user to export your widget into a document or print it. When exporting is enabled, the "Exporting/Printing" button appears in the widget. A click on it invokes a drop-down menu that lists exporting and printing commands. The following formats are supported for exporting into: PNG, PDF, JPEG, SVG and GIF.
- exportTo(fileName, format) - exports the widget.
- print() - opens the browser's print window.
- DevExpress.viz.exportFromMarkup(markup, options) - exports the widget using its SVG markup.
Specifies the color that will fill transparent regions in the resulting file or document.
This option supports the following colors.
- Hexadecimal colors
- RGB colors
- RGBA colors
- Predefined/cross-browser color names
- Predefined SVG colors
Enables the client-side exporting in the widget.
Specifies a default name for the file to which the widget will be exported.
Specifies a set of formats available for exporting into.
By default, a user can export the widget into five formats: PNG, PDF, JPEG, SVG and GIF. If you need to alter this set, assign an array of the required formats to this option.
Enables the printing feature in the widget. Applies only if the export | enabled option is true.
When printing is enabled, the export menu contains an item that invokes the Print window of the user's browser. It lets the user to select preferred printing options and to send the print job to the printer.
Specifies the URL of the server-side proxy that streams the resulting file to the end user to enable exporting in IE9 and Safari browsers.
Generally, exporting is performed using client-side API in browsers. However, the IE9 and Safari (integrated in Mac OS) browsers do not implement an API for saving files. In this instance, the widget can POST the content to a server-side proxy, which will stream the file back to the end user. To enable this functionality, set the export | proxyUrl option to the proxy, which will stream the file to the end user. When implementing the proxy, take the following information into account.
- Your proxy will receive a POST request with the following parameters in the request body: fileName, contentType (the MIME type of the file) and base64 (the base-64 encoded file content).
- The proxy should return the decoded file with the "Content-Disposition" header set to attachment; filename="
- Setting Up a Server-Side Proxy - shows how to set up a server-side proxy on ASP.NET and PHP servers.