AddPageLabelsRange Method (GdPicturePDF)

In This Topic

Adds a new page labeling range into the currently loaded PDF document according to what you have specified.

A page labeling range is a series of consecutive pages using the same numbering system. The purpose of page labels is to identify each page visually on the screen or in print. Pages, that are included in the specific labeling range, are defined by the interval starting at the first page specified by the StartPage parameter and always ending at the last page of the document.

All labeling ranges are simply indexed by an integer value from 0 to GetPageLabelsRangeCount-1.

Syntax

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

'Declaration

 

Public Function AddPageLabelsRange( _

   ByVal StartPage As Integer, _

   ByVal Style As PdfPageLabelStyle, _

   ByVal Prefix As String, _

   ByVal NumPortion As Integer _

) As GdPictureStatus

public GdPictureStatus AddPageLabelsRange( 

   int StartPage,

   PdfPageLabelStyle Style,

   string Prefix,

   int NumPortion

)

public function AddPageLabelsRange( 

    StartPage: Integer;

    Style: PdfPageLabelStyle;

    Prefix: String;

    NumPortion: Integer

): GdPictureStatus;

public function AddPageLabelsRange( 

   StartPage : int,

   Style : PdfPageLabelStyle,

   Prefix : String,

   NumPortion : int

) : GdPictureStatus;

public: GdPictureStatus AddPageLabelsRange( 

   int StartPage,

   PdfPageLabelStyle Style,

   string* Prefix,

   int NumPortion

)

public:

GdPictureStatus AddPageLabelsRange( 

   int StartPage,

   PdfPageLabelStyle Style,

   String^ Prefix,

   int NumPortion

)

Parameters

StartPage: The page number of the starting page in the labeling range. It must be a value from 1 to GetPageCount.
Style: A member of the PdfPageLabelStyle enumeration. It defines the page labeling style.
Prefix: The label prefix for page labels in this range. It can be an empty string.
NumPortion: The value of the numeric portion for the first page label in the range. Subsequent pages are numbered sequentially from this value, which must be greater than or equal to 1. The default value is 1.

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.

Pages within a labeling range are numbered sequentially in ascending order, starting at the first page specified by the StartPage parameter and always ending at the last page of the document. You also need to be aware that if you add a page range, which begins at the page other than the first page of the document, the supplementary labeling range is created for the pages outside your required interval (starting at the first page and ending at the page before your StartPage).

Example

How to define the roman page labels, which begin at number 10, starting from the first page within the PDF document

VB.NET
C#

Dim caption As String = "Example: AddPageLabelsRange"

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

        MessageBox.Show("The GetPageCount() method has failed with the status: " + status.ToString(), caption)

        GoTo [error]

    End If

    If count = 0 Then

        MessageBox.Show("This PDF document contains no pages.", caption)

        GoTo [error]

    End If

            

    'Removing current labeling ranges, if any are defined.

    status = gdpicturePDF.DeletePageLabels()

    If status <> GdPictureStatus.OK Then

        MessageBox.Show("The DeletePageLabels() method has failed with the status: " + status.ToString(), caption)

        Goto [Error]

    End If

            

    status = gdpicturePDF.AddPageLabelsRange(1, PdfPageLabelStyle.PdfPageLabelStyleUppercaseRomanNumerals, "A-", 10)

    If status = GdPictureStatus.OK Then

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

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

        Else

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

        End If

    Else

        MessageBox.Show("The AddPageLabelsRange() method has failed with the status: " + status.ToString(), caption)

    End If

Else

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

End If

[error]:

gdpicturePDF.Dispose()

string caption = "Example: AddPageLabelsRange";

GdPicturePDF gdpicturePDF = new GdPicturePDF();

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

{

    int count = gdpicturePDF.GetPageCount();

    GdPictureStatus status = gdpicturePDF.GetStat();

    if (status != GdPictureStatus.OK)

    {

        MessageBox.Show("The GetPageCount() method has failed with the status: " + status.ToString(), caption);

        goto error;

    }

    if (count == 0)

    {

        MessageBox.Show("This PDF document contains no pages.", caption);

        goto error;

    }

            

    //Removing current labeling ranges, if any are defined.

    status = gdpicturePDF.DeletePageLabels();

    if (status != GdPictureStatus.OK)

    {

        MessageBox.Show("The DeletePageLabels() method has failed with the status: " + status.ToString(), caption);

        goto error;

    }

            

    status = gdpicturePDF.AddPageLabelsRange(1, PdfPageLabelStyle.PdfPageLabelStyleUppercaseRomanNumerals, "A-", 10);

    if (status == GdPictureStatus.OK)

    {

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

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

        else

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

    }

    else

        MessageBox.Show("The AddPageLabelsRange() method has failed with the status: " + status.ToString(), caption);

}

else

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

            

error:

gdpicturePDF.Dispose();

Example

How to define the roman page labels, which begin at number 10, starting from the first page within the PDF document Dim caption As String = "Example: AddPageLabelsRange" 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 MessageBox.Show("The GetPageCount() method has failed with the status: " + status.ToString(), caption) GoTo [error] End If If count = 0 Then MessageBox.Show("This PDF document contains no pages.", caption) GoTo [error] End If 'Removing current labeling ranges, if any are defined. status = gdpicturePDF.DeletePageLabels() If status <> GdPictureStatus.OK Then MessageBox.Show("The DeletePageLabels() method has failed with the status: " + status.ToString(), caption) Goto [Error] End If status = gdpicturePDF.AddPageLabelsRange(1, PdfPageLabelStyle.PdfPageLabelStyleUppercaseRomanNumerals, "A-", 10) If status = GdPictureStatus.OK Then If gdpicturePDF.SaveToFile("test_AddPageLabelsRange.pdf") = GdPictureStatus.OK Then MessageBox.Show("The pages have been labeled successfully and the file has been saved.", caption) Else MessageBox.Show("The pages have been labeled successfully, but the file can't be saved.", caption) End If Else MessageBox.Show("The AddPageLabelsRange() method has failed with the status: " + status.ToString(), caption) End If Else MessageBox.Show("The file can't be loaded.", caption) End If [error]: gdpicturePDF.Dispose() string caption = "Example: AddPageLabelsRange"; GdPicturePDF gdpicturePDF = new GdPicturePDF(); if (gdpicturePDF.LoadFromFile("test.pdf", false) == GdPictureStatus.OK) { int count = gdpicturePDF.GetPageCount(); GdPictureStatus status = gdpicturePDF.GetStat(); if (status != GdPictureStatus.OK) { MessageBox.Show("The GetPageCount() method has failed with the status: " + status.ToString(), caption); goto error; } if (count == 0) { MessageBox.Show("This PDF document contains no pages.", caption); goto error; } //Removing current labeling ranges, if any are defined. status = gdpicturePDF.DeletePageLabels(); if (status != GdPictureStatus.OK) { MessageBox.Show("The DeletePageLabels() method has failed with the status: " + status.ToString(), caption); goto error; } status = gdpicturePDF.AddPageLabelsRange(1, PdfPageLabelStyle.PdfPageLabelStyleUppercaseRomanNumerals, "A-", 10); if (status == GdPictureStatus.OK) { if (gdpicturePDF.SaveToFile("test_AddPageLabelsRange.pdf") == GdPictureStatus.OK) MessageBox.Show("The pages have been labeled successfully and the file has been saved.", caption); else MessageBox.Show("The pages have been labeled successfully, but the file can't be saved.", caption); } else MessageBox.Show("The AddPageLabelsRange() method has failed with the status: " + status.ToString(), caption); } else MessageBox.Show("The file can't be loaded.", caption); error: gdpicturePDF.Dispose();

Reference

GdPicturePDF Class
GdPicturePDF Members
GetPageLabelsRangeCount Method
GetPageCount Method
GetPageCount Method
GetPageLabelsRangeCount Method
GetPageLabelsRange Method
DeletePageLabelsRange Method
DeletePageLabels Method
GetPageLabel Method