GetPageWidth Method (GdPicturePDF)

In This Topic

Returns the page width of the currently selected page in the loaded PDF document expressed in the current units used in this document.

You can simply use the GdPicturePDF.GetMeasurementUnit method to determine the currently defined units or you can easily use the GdPicturePDF.SetMeasurementUnit method to reset the units according to your preference.

Syntax

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

'Declaration
 
Public Function GetPageWidth() As Single

public float GetPageWidth()

public function GetPageWidth(): Single;

public function GetPageWidth() : float;

public: float GetPageWidth();

public:
float GetPageWidth();

Return Value

The page width expressed in the current units specified by the SetMeasurementUnit method. The GdPicturePDF.GetStat method can be subsequently used to determine if this method has been successful.

Be aware that any potential page rotation is not respected. The returned value is always the original page width value, that has been set when adding the page.

Remarks

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

It is recommend to use the GdPicturePDF.GetStat method to identify the specific reason for the method's failure, if any.

Example

How to find out the page width of the currently selected page in the loaded PDF document. This example shows you that the page rotation is not respected when determining the page width.

VB.NET
C#

Dim caption As String = "Example: GetPageWidth"
Dim gdpicturePDF As New GdPicturePDF()
If gdpicturePDF.NewPDF() = GdPictureStatus.OK Then
    Dim status As GdPictureStatus = gdpicturePDF.NewPage(PdfPageSizes.PdfPageSizeA4) 'A4 = (210mm x 270mm)
    If status = GdPictureStatus.OK Then
        gdpicturePDF.SetOrigin(PdfOrigin.PdfOriginTopLeft)
        gdpicturePDF.SetMeasurementUnit(PdfMeasurementUnit.PdfMeasurementUnitMillimeter)
        Dim width As Single = gdpicturePDF.GetPageWidth()
        status = gdpicturePDF.GetStat()
        If status = GdPictureStatus.OK Then
            MessageBox.Show("The width of the current page is " + width.ToString() + " mm.", caption)
        Else
            MessageBox.Show("The GetPageWidth() method has failed with the status: " + status.ToString(), caption)
        End If
            
        status = gdpicturePDF.RotatePage(90)
        If status = GdPictureStatus.OK Then
            width = gdpicturePDF.GetPageWidth()
            status = gdpicturePDF.GetStat()
            If status = GdPictureStatus.OK Then
                MessageBox.Show("The width of the current page after the rotation is " + width.ToString() + " mm.", caption)
            Else
                MessageBox.Show("The GetPageWidth() method has failed with the status: " + status.ToString(), caption)
            End If
        Else
            MessageBox.Show("The RotatePage() method has failed with the status: " + status.ToString(), caption)
        End If
    Else
        MessageBox.Show("The NewPage() method has failed with the status: " + status.ToString(), caption)
    End If
Else
    MessageBox.Show("The file can't be created.", caption)
End If
gdpicturePDF.Dispose()

string caption = "Example: GetPageWidth";
GdPicturePDF gdpicturePDF = new GdPicturePDF();
if (gdpicturePDF.NewPDF() == GdPictureStatus.OK)
{
    GdPictureStatus status = gdpicturePDF.NewPage(PdfPageSizes.PdfPageSizeA4); //A4 = (210mm x 270mm)
    if (status == GdPictureStatus.OK)
    {
        gdpicturePDF.SetOrigin(PdfOrigin.PdfOriginTopLeft);
        gdpicturePDF.SetMeasurementUnit(PdfMeasurementUnit.PdfMeasurementUnitMillimeter);
        float width = gdpicturePDF.GetPageWidth();
        status = gdpicturePDF.GetStat();
        if (status == GdPictureStatus.OK)
            MessageBox.Show("The width of the current page is " + width.ToString() + " mm." , caption);
        else
            MessageBox.Show("The GetPageWidth() method has failed with the status: " + status.ToString(), caption);
            
        status = gdpicturePDF.RotatePage(90);
        if (status == GdPictureStatus.OK)
        {
            width = gdpicturePDF.GetPageWidth();
            status = gdpicturePDF.GetStat();
            if (status == GdPictureStatus.OK)
                MessageBox.Show("The width of the current page after the rotation is " + width.ToString() + " mm.", caption);
            else
                MessageBox.Show("The GetPageWidth() method has failed with the status: " + status.ToString(), caption);
        }
        else
            MessageBox.Show("The RotatePage() method has failed with the status: " + status.ToString(), caption);
    }
    else
        MessageBox.Show("The NewPage() method has failed with the status: " + status.ToString(), caption);
}
else
    MessageBox.Show("The file can't be created.", caption);
gdpicturePDF.Dispose();

Reference

GdPicturePDF Class
GdPicturePDF Members
GetPageHeight Method
SelectPage Method
GetCurrentPage Method
RotatePage Method
GetPageCount Method
NewPage(Single,Single) Method
NewPDF Method