Example





In This Topic

PageRange Property (GdPictureDocumentConverter)

In This Topic
Specifies individual pages or page intervals related to the loaded document for further processing.

The required page numbers need to be defined in the matching pattern, for example use the string of "1-5" for pages 1 to 5, or use the string of "1,5,6" to specify pages 1 and 5 and 6. You can use the string of "1,5,8-12" to specify pages 1, 5, 8 and all pages from page 8 to page 12, etc.

Syntax
'Declaration

 


Public Property PageRange As String
public string PageRange {get; set;}
public read-write property PageRange: String; 
public function get,set PageRange : String
public: __property string* get_PageRange();

public: __property void set_PageRange( 

   string* value

);
public:

property String^ PageRange {

   String^ get();

   void set (    String^ value);

}

Property Value

The default value is the string of "*", which means all pages.
Example
The first example shows you how to load only the first page of the source document you want to convert.

The second example shows you how to convert and save only the first page of the loaded source document.

Using gdpictureDocumentConverter As New GdPictureDocumentConverter()

    'Only the first page is loaded.

    gdpictureDocumentConverter.PageRange = "1"

    'Please try to use also a multi-page document.

    Dim status As GdPictureStatus = gdpictureDocumentConverter.LoadFromFile("test_doc.docx", GdPicture14.DocumentFormat.DocumentFormatDOCX)

    If status = GdPictureStatus.OK Then

        MessageBox.Show("The file has been loaded successfully.", "GdPicture")

        status = gdpictureDocumentConverter.SaveAsPDF("load_first_page.pdf", PdfConformance.PDF)

        If status = GdPictureStatus.OK Then

            MessageBox.Show("The file has been saved successfully.", "GdPicture")

        Else

            MessageBox.Show("The file has failed to save. Status: " + status.ToString(), "GdPicture")

        End If

    Else

        MessageBox.Show("The file has failed to load. Status: " + status.ToString(), "GdPicture")

    End If

End Using
using (GdPictureDocumentConverter gdpictureDocumentConverter = new GdPictureDocumentConverter())

{

    //Only the first page is loaded.

    gdpictureDocumentConverter.PageRange = "1";

    //Please try to use also a multi-page document.

    GdPictureStatus status = gdpictureDocumentConverter.LoadFromFile("test_doc.docx", GdPicture14.DocumentFormat.DocumentFormatDOCX);

    if (status == GdPictureStatus.OK)

    {

        MessageBox.Show("The file has been loaded successfully.", "GdPicture");

        status = gdpictureDocumentConverter.SaveAsPDF("load_first_page.pdf", PdfConformance.PDF);

        if (status == GdPictureStatus.OK)

        {

            MessageBox.Show("The file has been saved successfully.", "GdPicture");

        }

        else

        {

            MessageBox.Show("The file has failed to save. Status: " + status.ToString(), "GdPicture");

        }

    }

    else

    {

        MessageBox.Show("The file has failed to load. Status: " + status.ToString(), "GdPicture");

    }

}
Using gdpictureDocumentConverter As New GdPictureDocumentConverter()

    'Please try to use also a multi-page document.

    Dim status As GdPictureStatus = gdpictureDocumentConverter.LoadFromFile("test_doc.docx", GdPicture14.DocumentFormat.DocumentFormatDOCX)

    If status = GdPictureStatus.OK Then

        MessageBox.Show("The file has been loaded successfully.", "GdPicture")

        'Only the first page is saved.

        gdpictureDocumentConverter.PageRange = "1"

        status = gdpictureDocumentConverter.SaveAsPDF("save_first_page.pdf", PdfConformance.PDF)

        If status = GdPictureStatus.OK Then

            MessageBox.Show("The file has been saved successfully.", "GdPicture")

        Else

            MessageBox.Show("The file has failed to save. Status: " + status.ToString(), "GdPicture")

        End If

    Else

        MessageBox.Show("The file has failed to load. Status: " + status.ToString(), "GdPicture")

    End If

End Using
using (GdPictureDocumentConverter gdpictureDocumentConverter = new GdPictureDocumentConverter())

{

    //Please try to use also a multi-page document.

    GdPictureStatus status = gdpictureDocumentConverter.LoadFromFile("test_doc.docx", GdPicture14.DocumentFormat.DocumentFormatDOCX);

    if (status == GdPictureStatus.OK)

    {

        MessageBox.Show("The file has been loaded successfully.", "GdPicture");

        //Only the first page is saved.

        gdpictureDocumentConverter.PageRange = "1";

        status = gdpictureDocumentConverter.SaveAsPDF("save_first_page.pdf", PdfConformance.PDF);

        if (status == GdPictureStatus.OK)

        {

            MessageBox.Show("The file has been saved successfully.", "GdPicture");

        }

        else

        {

            MessageBox.Show("The file has failed to save. Status: " + status.ToString(), "GdPicture");

        }

    }

    else

    {

        MessageBox.Show("The file has failed to load. Status: " + status.ToString(), "GdPicture");

    }

}
See Also

Reference

GdPictureDocumentConverter Class
GdPictureDocumentConverter Members