Example





In This Topic
GdPicture14 Namespace / GdPicturePDF Class / NormalizePage Method

NormalizePage Method (GdPicturePDF)

In This Topic
Normalizes the currently selected page in the loaded PDF document, in other words all the page boundary boxes are adjusted to the physical size of the page (means the CropBox property is equal to the MediaBox property) and the page's rotation is reset to 0. The actual page rendering is not changed.
Syntax
'Declaration

 


Public Function NormalizePage() As GdPictureStatus
public GdPictureStatus NormalizePage()
public function NormalizePage(): GdPictureStatus; 
public function NormalizePage() : GdPictureStatus;
public: GdPictureStatus NormalizePage(); 
public:

GdPictureStatus NormalizePage();

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.

Just to remind you that the purpose of this method is to prepare the content of the current page so that subsequent drawing operations are at the expected position on the page. This method should be used before the drawing operations, which ignore the page's rotation and cropping.

Example
How to normalize all pages in the PDF document. 
Dim caption As String = "Example: NormalizePage"

Dim gdpicturePDF As New GdPicturePDF()

If gdpicturePDF.LoadFromFile("test.pdf", False) = GdPictureStatus.OK Then

    Dim count As Integer = gdpicturePDF.GetPageCount()

    Dim status As GdPictureStatus = gdpicturePDF.GetStat()

    If status = GdPictureStatus.OK Then

        For i As Integer = 1 To count

            status = gdpicturePDF.SelectPage(i)

            If status = GdPictureStatus.OK Then

                status = gdpicturePDF.NormalizePage()

                If status <> GdPictureStatus.OK Then

                    MessageBox.Show("The NormalizePage() method has failed for the page number " + i.ToString() + " with the status: " + status.ToString(), caption)

                    Exit For

                End If

            Else

                Exit For

            End If

        Next

        If status = GdPictureStatus.OK Then

            If gdpicturePDF.SaveToFile("test_NormalizePage.pdf") = GdPictureStatus.OK Then

                MessageBox.Show("The pages have been normalized successfully and the file has been saved.", caption)

            Else

                MessageBox.Show("The pages have been normalized successfully but the file can't be saved.", caption)

            End If

        End If

    End If

    If status <> GdPictureStatus.OK Then

        MessageBox.Show("The example HAS NOT been followed successfully. The last error status is: " + status.ToString(), caption)

    End If

Else

    MessageBox.Show("The file can't be loaded.", caption)

End If

gdpicturePDF.Dispose()
string caption = "Example: NormalizePage";

GdPicturePDF gdpicturePDF = new GdPicturePDF();

if (gdpicturePDF.LoadFromFile("test.pdf", false) == GdPictureStatus.OK)

{

    int count = gdpicturePDF.GetPageCount();

    GdPictureStatus status = gdpicturePDF.GetStat();

    if (status == GdPictureStatus.OK)

    {

        for (int i = 1; i <= count; i++)

        {

            status = gdpicturePDF.SelectPage(i);

            if (status == GdPictureStatus.OK)

            {

                status = gdpicturePDF.NormalizePage();

                if (status != GdPictureStatus.OK)

                {

                    MessageBox.Show("The NormalizePage() method has failed for the page number " + i.ToString() + " with the status: " + status.ToString(), caption);

                    break;

                }

            }

            else break;

        }

        if (status == GdPictureStatus.OK)

        {

            if (gdpicturePDF.SaveToFile("test_NormalizePage.pdf") == GdPictureStatus.OK)

                MessageBox.Show("The pages have been normalized successfully and the file has been saved.", caption);

            else

                MessageBox.Show("The pages have been normalized successfully but the file can't be saved.", caption);

        }

    }

    if (status != GdPictureStatus.OK)

        MessageBox.Show("The example HAS NOT been followed successfully. The last error status is: " + status.ToString(), caption);

}

else

    MessageBox.Show("The file can't be loaded.", caption);

gdpicturePDF.Dispose();
See Also

Reference

GdPicturePDF Class
GdPicturePDF Members
GetPageCount Method
SelectPage Method
GetPageHeight Method
GetPageWidth Method
NewPage(Single,Single) Method