PDFComponent
Configures the settings for the export of Grid in PDF (see example).
Selector
kendo-grid-pdf
Inputs
allPages
boolean
Exports all Grid pages, starting from the first one.
delay
number
(default: 0) The delay in milliseconds before exporting the Grid content. Useful for scenarios which involve exporting complex components used in the Grid templates such as charts or data-bound components with asynchronous data retrieval (see example).
Fields
author
string
The author (metadata) of the PDF document.
autoPrint?
boolean
Specifies if the Print dialog should be opened immediately after loading the document.
The default value is false
.
Requires
@progress/kendo-drawing
v1.9.0 or later.
avoidLinks
string | boolean
A flag that indicates whether to produce actual hyperlinks in the exported PDF file. It is also possible to set a CSS selector. All matching links will be ignored.
creator
string
(default: "Kendo UI PDF Generator") The creator of the PDF document.
date
Date
The date when the PDF document is created. Defaults to new Date()
.
fileName
string
(default: "Export.pdf") Specifies the name of the exported PDF file.
forcePageBreak
string
An optional CSS selector that specifies the elements which cause the page breaks (see example).
forceProxy
boolean
If set to true
, the content is forwarded to proxyURL
even if the
browser supports local saving of files.
imageResolution
number
The forced resolution of the images in the exported PDF document (see example). By default, the images are exported at their full resolution.
keepTogether
string
An optional CSS selector that specifies the elements which should not be split across the pages (see example).
keywords
string
The keywords (metadata) of the PDF document.
landscape
boolean
(default: false) A flag that indicates if the page will be in a landscape orientation (see example). By default, the page is in a portrait orientation.
margin
string | number | PageMargin
Specifies the margins of the page.
Numbers are treated as points (
"pt"
).
The supported units are:
"mm"
"cm"
"in"
"pt"
(default).
paperSize
PaperSize
Specifies the paper size of the PDF document (see example).
Defaults to "auto"
which means that the paper size is determined by the content.
The size of the content in pixels matches the size of the output in points (1 pixel = 1/72 inch).
If paperSize
is set, the content is split across multiple pages. This enables the repeatHeaders
and
scale
options, and allows you to specify a template.
The supported values are:
- A predefined size. The supported paper sizes are:
A0-A10
,B0-B10
,C0-C10
,Executive
,Folio
,Legal
,Letter
,Tabloid
. - An array of two numbers which specify the width and height in points (1pt = 1/72in).
- An array of two strings which specify the width and height in units. The supported units are
"mm"
,"cm"
,"in"
, and"pt"
.
producer
string
The producer (metadata) of the PDF document.
proxyData?
{[key: string]: string}
A key/value dictionary of form values which will be sent to the proxy. Can be used to submit Anti-Forgery tokens and other metadata.
proxyTarget
string
(default: "_self")
A name or keyword which indicates where to display the document that is returned from the proxy.
To display the document in a new window or iframe,
the proxy has to have the "Content-Disposition"
header set to inline; filename="<fileName.pdf>"
.
proxyURL
string
The URL of the server-side proxy which streams the file to the end user. You need to use a proxy if
the browser is not capable of saving files locally—for example, Internet Explorer 9 and Safari.
It is your responsibility to implement the server-side proxy. The proxy returns the decoded file with
the "Content-Disposition"
header set to attachment; filename="<fileName.pdf>"
.
In the request body, the proxy receives a POST request with the following parameters:
"contentType"
—The MIME type of the file."base64"
—The base-64 encoded file content."fileName"
—The file name, as requested by the caller.
repeatHeaders
boolean
Specifies if the <thead>
elements of the tables will be repeated on each page
(see example).
scale
number
(default: 1) A scale factor (see example). The text size on the screen might be too big for printing. To scale down the output in PDF, use this option.
subject
string
The subject (metadata) of the PDF document.
title
string
The title (metadata) of the PDF document.