GdPicture.NET.14~GdPicture14.GdPicturePDF~GetPagePrivateTag - GetPagePrivateTag Method (GdPicturePDF) -

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

'Declaration
 
Public Function GetPagePrivateTag( _
   ByVal Tag As String _
) As String

public string GetPagePrivateTag( 
   string Tag
)

public function GetPagePrivateTag( 
    Tag: String
): String;

public function GetPagePrivateTag( 
   Tag : String
) : String;

public: string* GetPagePrivateTag( 
   string* Tag
)

public:
String^ GetPagePrivateTag( 
   String^ Tag
)

Parameters

Tag: The name of the private tag for the current page, for example "Origin".

Return Value

The private page tag value previously defined by the GdPicturePDF.SetPagePrivateTag method. The GdPicturePDF.GetStat method can be subsequently used to determine if this method has been successful.

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.

How to determine the values for the private tag named MyTag linked with each page of your document.

VB.NET
C#

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
        Dim message As String = "", content As String = ""
        For i As Integer = 1 To count
            status = gdpicturePDF.SelectPage(i)
            If status = GdPictureStatus.OK Then
                content = gdpicturePDF.GetPagePrivateTag("MyTag")
                status = gdpicturePDF.GetStat()
                If status = GdPictureStatus.OK Then
                    message = message + "The value of the MyTag for the page nr." + i.ToString() + " is : " + content + vbCrLf
                Else
                    message = message + "The GetPagePrivateTag() method has failed for the page nr." + i.ToString() + " with the status: " + status.ToString() + vbCrLf
                End If
            Else
                message = message + "The SelectPage() method has failed for the page nr." + i.ToString() + " with the status: " + status.ToString() + vbCrLf
            End If
        Next
        MessageBox.Show(message, "Example: GetPagePrivateTag")
    Else
        MessageBox.Show("The GetPageCount() method has failed with the status: " + status.ToString(), "Example: GetPagePrivateTag")
    End If
Else
    MessageBox.Show("The file can't be loaded.", "Example: GetPagePrivateTag")
End If
gdpicturePDF.Dispose()

GdPicturePDF gdpicturePDF = new GdPicturePDF();
if (gdpicturePDF.LoadFromFile("test.pdf", false) == GdPictureStatus.OK)
{
    int count = gdpicturePDF.GetPageCount();
    GdPictureStatus status = gdpicturePDF.GetStat();
    if (status == GdPictureStatus.OK)
    {
        string message = "", content = "";
        for (int i = 1; i <= count; i++)
        {
            status = gdpicturePDF.SelectPage(i);
            if (status == GdPictureStatus.OK)
            {
                content = gdpicturePDF.GetPagePrivateTag("MyTag");
                status = gdpicturePDF.GetStat();
                if (status == GdPictureStatus.OK)
                    message = message + "The value of the MyTag for the page nr." + i.ToString() + " is : " + content + "\n";
                else
                    message = message + "The GetPagePrivateTag() method has failed for the page nr." + i.ToString() + " with the status: " + status.ToString() + "\n";
            }
            else
                message = message + "The SelectPage() method has failed for the page nr." + i.ToString() + " with the status: " + status.ToString() + "\n";
        }
        MessageBox.Show(message, "Example: GetPagePrivateTag");
    }
    else
        MessageBox.Show("The GetPageCount() method has failed with the status: " + status.ToString(), "Example: GetPagePrivateTag");
}
else
    MessageBox.Show("The file can't be loaded.", "Example: GetPagePrivateTag");
gdpicturePDF.Dispose();

How to determine the values for the private tag named MyTag linked with each page of your document. 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 Dim message As String = "", content As String = "" For i As Integer = 1 To count status = gdpicturePDF.SelectPage(i) If status = GdPictureStatus.OK Then content = gdpicturePDF.GetPagePrivateTag("MyTag") status = gdpicturePDF.GetStat() If status = GdPictureStatus.OK Then message = message + "The value of the MyTag for the page nr." + i.ToString() + " is : " + content + vbCrLf Else message = message + "The GetPagePrivateTag() method has failed for the page nr." + i.ToString() + " with the status: " + status.ToString() + vbCrLf End If Else message = message + "The SelectPage() method has failed for the page nr." + i.ToString() + " with the status: " + status.ToString() + vbCrLf End If Next MessageBox.Show(message, "Example: GetPagePrivateTag") Else MessageBox.Show("The GetPageCount() method has failed with the status: " + status.ToString(), "Example: GetPagePrivateTag") End If Else MessageBox.Show("The file can't be loaded.", "Example: GetPagePrivateTag") End If gdpicturePDF.Dispose() GdPicturePDF gdpicturePDF = new GdPicturePDF(); if (gdpicturePDF.LoadFromFile("test.pdf", false) == GdPictureStatus.OK) { int count = gdpicturePDF.GetPageCount(); GdPictureStatus status = gdpicturePDF.GetStat(); if (status == GdPictureStatus.OK) { string message = "", content = ""; for (int i = 1; i <= count; i++) { status = gdpicturePDF.SelectPage(i); if (status == GdPictureStatus.OK) { content = gdpicturePDF.GetPagePrivateTag("MyTag"); status = gdpicturePDF.GetStat(); if (status == GdPictureStatus.OK) message = message + "The value of the MyTag for the page nr." + i.ToString() + " is : " + content + "\n"; else message = message + "The GetPagePrivateTag() method has failed for the page nr." + i.ToString() + " with the status: " + status.ToString() + "\n"; } else message = message + "The SelectPage() method has failed for the page nr." + i.ToString() + " with the status: " + status.ToString() + "\n"; } MessageBox.Show(message, "Example: GetPagePrivateTag"); } else MessageBox.Show("The GetPageCount() method has failed with the status: " + status.ToString(), "Example: GetPagePrivateTag"); } else MessageBox.Show("The file can't be loaded.", "Example: GetPagePrivateTag"); gdpicturePDF.Dispose();

Reference

GdPicturePDF Class
GdPicturePDF Members
GetStat Method
SetPagePrivateTag Method
GetStat Method
GetPageCount Method
SelectPage Method
GetCurrentPage Method
SetPagePrivateTag Method
DeletePagePrivateTag Method