NewPage(PdfPageSizes) Method

In This Topic

Adds a new page according to the required predefined page size into the currently loaded PDF document. The new empty page is added at the end of the document as the last page and it is automatically selected as the current page.

Syntax

Visual Basic
C#
Delphi
JScript
Managed Extensions for C++
C++/CLI

'Declaration
 
Public Overloads Function NewPage( _
   ByVal PageSize As PdfPageSizes _
) As GdPictureStatus

public GdPictureStatus NewPage( 
   PdfPageSizes PageSize
)

public function NewPage( 
    PageSize: PdfPageSizes
): GdPictureStatus;

public function NewPage( 
   PageSize : PdfPageSizes
) : GdPictureStatus;

public: GdPictureStatus NewPage( 
   PdfPageSizes PageSize
)

public:
GdPictureStatus NewPage( 
   PdfPageSizes PageSize
)

Parameters

PageSize: A member of the PdfPageSizes enumeration. The predefined page size.

Return Value

A member of the GdPictureStatus enumeration. If the method has been successfully followed, then the return value is GdPictureStatus.OK.

We strongly recommend always checking this status first.

Remarks

This method is only allowed for use with non-encrypted documents.

The newly created page is automatically set as the current page after successful adding.

Example

How to add a new page with the standard size of A4 to the newly created document.

VB.NET
C#

Dim gdpicturePDF As New GdPicturePDF()
If gdpicturePDF.NewPDF() = GdPictureStatus.OK Then
    Dim status As GdPictureStatus = gdpicturePDF.NewPage(PdfPageSizes.PdfPageSizeA4)
    If status = GdPictureStatus.OK Then
        status = gdpicturePDF.SaveToFile("test_NewPage.pdf")
        If status = GdPictureStatus.OK Then
            MessageBox.Show("The file has been saved successfully.", "Example: NewPage")
        Else
            MessageBox.Show("The file can't be saved.", "Example: NewPage")
        End If
    Else
        MessageBox.Show("The NewPage() method has failed with the status: " + status.ToString(), "Example: NewPage")
    End If
Else
    MessageBox.Show("The file can't be created.", "Example: NewPage")
End If
gdpicturePDF.Dispose()

GdPicturePDF gdpicturePDF = new GdPicturePDF();
if (gdpicturePDF.NewPDF() == GdPictureStatus.OK)
{
    GdPictureStatus status = gdpicturePDF.NewPage(PdfPageSizes.PdfPageSizeA4);
    if (status == GdPictureStatus.OK)
    {
        status = gdpicturePDF.SaveToFile("test_NewPage.pdf");
        if (status == GdPictureStatus.OK)
            MessageBox.Show("The file has been saved successfully.", "Example: NewPage");
        else
            MessageBox.Show("The file can't be saved.", "Example: NewPage");
    }
    else
        MessageBox.Show("The NewPage() method has failed with the status: " + status.ToString(), "Example: NewPage");
}
else
    MessageBox.Show("The file can't be created.", "Example: NewPage");
gdpicturePDF.Dispose();

Reference

GdPicturePDF Class
GdPicturePDF Members
Overload List
GetPageCount Method
GetCurrentPage Method
SelectPage Method
NewPDF Method