Adds a page to the current document.

[C#]
virtual int AddPage()
virtual int AddPage(int page)

[Visual Basic]
Function AddPage() As Integer
Function AddPage(ByVal page As Integer) As Integer


Adds a page to the current document.

The AddPage function returns the Object ID of the newly added Page Object. Typically you will want to assign this return value to the document Page property using code of the form.

theDoc.Page = theDoc.AddPage()

Pages are added at the end of the document. However you can use the PageNum parameter to insert pages at other locations. The following code inserts a page at the start of a document.

theDoc.Page = theDoc.AddPage(1)

Any existing page and all subsequent pages will be shifted towards the end of the document to make room for the insertion.

The following code adds three pages to a document. Each page is marked with the page number and page Object ID.

[C#]
Doc theDoc = new Doc();
theDoc.FontSize = 96; // big text
theDoc.HPos = 0.5; // centered
theDoc.VPos = 0.5; // ...
for (int i = 1; i <= 3; i++) {
  theDoc.Page = theDoc.AddPage();
  string txt;
  txt = "Page " + i.ToString() + ", ID=";
  txt = txt + theDoc.Page.ToString();
  theDoc.AddText(txt);
}
theDoc.Save(Server.MapPath("docaddpage.pdf"));
theDoc.Clear();

[Visual Basic]
Dim theDoc As Doc = New Doc()
theDoc.FontSize = 96 ' big text
theDoc.HPos = 0.5 ' centered
theDoc.VPos = 0.5 ' ...
Dim i As Integer
For i = 1 To 3
  theDoc.Page = theDoc.AddPage()
  Dim txt As String
  txt = "Page " + i.ToString() + ", ID="
  txt = txt + theDoc.Page.ToString()
  theDoc.AddText(txt)
Next
theDoc.Save(Server.MapPath("docaddpage.pdf"))
theDoc.Clear()


docaddpage.pdf