| AddImageToChain Function | ||
|
||
|
Adds a new page from a paged HTML or PostScript render.
|
Syntax
|
[C#]
|
may
throw Exception()Params
|
Notes
|
Some web pages are too large to fit on one PDF page. To split a web page across multiple PDF pages you need to call AddImageUrl or AddImageHtml to render the first page. The ID returned from these calls represents the head of the chain. To add subsequent pages to the chain you need to make calls to AddImageToChain passing in the previous image from the chain each time. As well as using chaining to split web pages across multiple PDF pages you can also use it to split your web pages across multiple columns within a page. You can even split your chain to generate multiple copies of the same page. More information can be found in the HTML / CSS Rendering section of the documentation. Similarly some PostScript (PS) files contain more than one page of content. To split a PS file across multiple PDF pages you need to call AddImageFile or AddImageData to render the first page. The ID returned from these calls represents the head of the chain. To add subsequent pages to the chain you need to make calls to AddImageToChain passing in the previous image from the chain each time.
|
Example
|
This example shows how to import an HTML page into a multi-page PDF document. We first create a Doc object and inset the edges a little so that the HTML will appear in the middle of the page.
using var doc = new Doc();
doc.Rect.Inset(72, 144);
We add the first page of HTML. We save the returned ID as this will be used to add subsequent pages.
int id = doc.AddImageUrl("http://www.yahoo.com/");
We now chain subsequent pages together. We stop when we reach a page which wasn't truncated.
while (true) {
doc.FrameRect();
if (!doc.Chainable(id))
break;
doc.Page = doc.AddPage();
id = doc.AddImageToChain(id);
}
After adding the pages we can flatten them. We can't do this until after the pages have been added because flattening will invalidate our previous ID and break the chain.
for (int i = 1; i <= doc.PageCount; i++) {
doc.PageNumber = i;
doc.Flatten();
}
Finally we save.
doc.Save("paged_html.pdf");
We get the following output.
|
