GetFormFieldItemValue Method (GdPicturePDF)

In This Topic

Returns the (export) value of a specific item of a choice form field, that is specified by its unique form field's identifier and it is related to the currently loaded PDF document. The item is identified by its index, that simply represents its position in the item's list.

The item's value is an export value assigned to the specified option, it can be different than the item's text.

Syntax

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

'Declaration

 

Public Function GetFormFieldItemValue( _

   ByVal FieldId As Integer, _

   ByVal ItemIdx As Integer _

) As String

public string GetFormFieldItemValue( 

   int FieldId,

   int ItemIdx

)

public function GetFormFieldItemValue( 

    FieldId: Integer;

    ItemIdx: Integer

): String;

public function GetFormFieldItemValue( 

   FieldId : int,

   ItemIdx : int

) : String;

public: string* GetFormFieldItemValue( 

   int FieldId,

   int ItemIdx

)

public:

String^ GetFormFieldItemValue( 

   int FieldId,

   int ItemIdx

)

Parameters

FieldId: A unique form field identifier specifying a required form field object. You can obtain this identifier using these methods: GdPicturePDF.AddComboFormField, GdPicturePDF.AddListFormField, GdPicturePDF.GetFormFieldId or GdPicturePDF.GetFormFieldChildID.
ItemIdx: The index of the required item. It must be a value from 0 to GdPicturePDF.GetFormFieldItemCount-1.

Return Value

A string representing the value of the selected item. The GdPicturePDF.GetStat method can be subsequently used to determine if this method has been successful.

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.

Just to remind you, that this method is only meaningful for choice form fields, that means for combo boxes or list boxes, otherwise it will fail.

Example

How to retrieve all items and their values in all list boxes in the current document.

VB.NET
C#

Dim caption As String = "Example: GetFormFieldItemValue"

Dim message As String = ""

Dim gdpicturePDF As GdPicturePDF = New GdPicturePDF()

If gdpicturePDF.LoadFromFile("forms.pdf", False) <> GdPictureStatus.OK Then

    message = "The file can't be loaded. Status: " + gdpicturePDF.GetStat().ToString()

    GoTo [error]

End If

Dim count As Integer = gdpicturePDF.GetFormFieldsCount()

If gdpicturePDF.GetStat() <> GdPictureStatus.OK Then

    message = "The GetFormFieldsCount() method has failed with the status: " + gdpicturePDF.GetStat().ToString()

    GoTo [error]

End If

If count = 0 Then

    message = "This document includes no form fields."

    GoTo [error]

End If

Dim formID As Integer = 0

Dim type As PdfFormFieldType = PdfFormFieldType.PdfFormFieldTypeUnknown

For i As Integer = 0 To count - 1

    formID = gdpicturePDF.GetFormFieldId(i)

    If gdpicturePDF.GetStat() <> GdPictureStatus.OK Then

        message = "The GetFormFieldId() method has failed with the status: " + gdpicturePDF.GetStat().ToString()

        GoTo [error]

    End If

    type = gdpicturePDF.GetFormFieldType(formID)

    If gdpicturePDF.GetStat() <> GdPictureStatus.OK Then

        message = "The GetFormFieldType() method has failed with the status: " + gdpicturePDF.GetStat().ToString()

        GoTo [error]

    End If

    If type = PdfFormFieldType.PdfFormFieldTypeList Then

        Dim title As String = gdpicturePDF.GetFormFieldTitle(formID)

        If gdpicturePDF.GetStat() = GdPictureStatus.OK Then

            message = message + "listbox: " + title

            Dim itemsCount As Integer = gdpicturePDF.GetFormFieldItemCount(formID)

            If gdpicturePDF.GetStat() = GdPictureStatus.OK Then

                message = message + "    items: " + itemsCount + vbCrLf

                Dim text As String = "", value As String = ""

                For j As Integer = 0 To itemsCount - 1

                    text = gdpicturePDF.GetFormFieldItemText(formID, j)

                    If gdpicturePDF.GetStat() = GdPictureStatus.OK Then

                        message = message + "text: " + text

                    Else

                        message = message + "text: " + gdpicturePDF.GetStat().ToString()

                    End If

                    value = gdpicturePDF.GetFormFieldItemValue(formID, j)

                    If gdpicturePDF.GetStat() = GdPictureStatus.OK Then

                        message = message + "    value: " + value

                    Else

                        message = message + "    value: " + gdpicturePDF.GetStat().ToString()

                    End If

                    message += vbCrLf

                Next

            Else

                message = message + vbCrLf + "The GetFormFieldItemCount() method has failed with the status: " + gdpicturePDF.GetStat().ToString()

                GoTo [error]

            End If

        Else

            message = "The GetFormFieldTitle() method has failed with the status: " + gdpicturePDF.GetStat().ToString()

            GoTo [error]

        End If

    End If

Next

[error]:

If message.Equals("") Then message = "This document includes no list boxes."

MessageBox.Show(message, caption)

gdpicturePDF.Dispose()

string caption = "Example: GetFormFieldItemValue";

string message = "";

GdPicturePDF gdpicturePDF = new GdPicturePDF();

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

{

    message = "The file can't be loaded. Status: " + gdpicturePDF.GetStat().ToString();

    goto error;

}

            

int count = gdpicturePDF.GetFormFieldsCount();

if (gdpicturePDF.GetStat() != GdPictureStatus.OK)

{

    message = "The GetFormFieldsCount() method has failed with the status: " + gdpicturePDF.GetStat().ToString();

    goto error;

}

if (count == 0)

{

    message = "This document includes no form fields.";

    goto error;

}

int formID = 0;

PdfFormFieldType type = PdfFormFieldType.PdfFormFieldTypeUnknown;

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

{

    formID = gdpicturePDF.GetFormFieldId(i);

    if (gdpicturePDF.GetStat() != GdPictureStatus.OK)

    {

        message = "The GetFormFieldId() method has failed with the status: " + gdpicturePDF.GetStat().ToString();

        goto error;

    }

    type = gdpicturePDF.GetFormFieldType(formID);

    if (gdpicturePDF.GetStat() != GdPictureStatus.OK)

    {

        message = "The GetFormFieldType() method has failed with the status: " + gdpicturePDF.GetStat().ToString();

        goto error;

    }

    if (type == PdfFormFieldType.PdfFormFieldTypeList)

    {

        string title = gdpicturePDF.GetFormFieldTitle(formID);

        if (gdpicturePDF.GetStat() == GdPictureStatus.OK)

        {

            message = message + "listbox: " + title;

            int itemsCount = gdpicturePDF.GetFormFieldItemCount(formID);

            if (gdpicturePDF.GetStat() == GdPictureStatus.OK)

            {

                message = message + "    items: " + itemsCount + "\n";

                string text = "", value = "";

                for (int j = 0; j < itemsCount; j++)

                {

                    text = gdpicturePDF.GetFormFieldItemText(formID, j);

                    if (gdpicturePDF.GetStat() == GdPictureStatus.OK)

                        message = message + "text: " + text;

                    else

                        message = message + "text: " + gdpicturePDF.GetStat().ToString();

                    value = gdpicturePDF.GetFormFieldItemValue(formID, j);

                    if (gdpicturePDF.GetStat() == GdPictureStatus.OK)

                        message = message + "    value: " + value;

                    else

                        message = message + "    value: " + gdpicturePDF.GetStat().ToString();

                    message += "\n";

                }

            }

            else

            {

                message = message + "\nThe GetFormFieldItemCount() method has failed with the status: " + gdpicturePDF.GetStat().ToString();

                goto error;

            }

        }

        else

        {

            message = "The GetFormFieldTitle() method has failed with the status: " + gdpicturePDF.GetStat().ToString();

            goto error;

        }

    }

}

error:

if (message.Equals(""))

    message = "This document includes no list boxes.";

MessageBox.Show(message, caption);

gdpicturePDF.Dispose();

Reference

GdPicturePDF Class
GdPicturePDF Members
GetFormFieldItemText Method
GetFormFieldsCount Method
GetFormFieldId Method
GetFormFieldChildID Method
GetFormFieldType Method
AddComboFormField(Single,Single,Single,Single,String,String,Single,Byte,Byte,Byte,Boolean) Method
AddListFormField(Single,Single,Single,Single,String,String,Single,Byte,Byte,Byte,Boolean,Boolean) Method