PdfAcroFormFacade.GetButtonFormField(String) Method

Gets a specific button form field’s properties.

Namespace: DevExpress.Pdf

Assembly: DevExpress.Pdf.v25.1.Core.dll

NuGet Package: DevExpress.Pdf.Core

Declaration

C#

public PdfButtonFormFieldFacade GetButtonFormField(
    string fullName
)

VB.NET

Public Function GetButtonFormField(
    fullName As String
) As PdfButtonFormFieldFacade

Parameters

Name	Type	Description
fullName	String	A form field name.

Returns

Type	Description
PdfButtonFormFieldFacade	An object that contains the button form field properties.

Remarks

The PdfButtonFormFieldFacade object contains form field and widget properties without access to the form field’s inner structure. Use the Widgets property to get form field widget settings. Use the PdfButtonWidgetFacade.IconOptions property to get the button icon options.

The code sample below specifies a button form field icon and its scaling options:

C#

using (PdfDocumentProcessor pdfDocumentProcessor = new PdfDocumentProcessor())
{
    pdfDocumentProcessor.LoadDocument("Documents//FormDemo.pdf");

    PdfDocumentFacade documentFacade = pdfDocumentProcessor.DocumentFacade;
    PdfAcroFormFacade acroForm = documentFacade.AcroForm;
    //Obtain button form field parameters:
    PdfButtonFormFieldFacade pushButton = acroForm.GetButtonFormField("Submit");
    PdfButtonWidgetFacade buttonWidget = pushButton.Widgets[0];

    //Specify a button icon and set its options:
    buttonWidget.SetNormalIcon("Documents//submit_3802014.png");
    buttonWidget.IconOptions.FitToAnnotationBounds = true;
    buttonWidget.IconOptions.ScaleCondition = PdfIconScalingCircumstances.BiggerThanAnnotationRectangle;
    buttonWidget.TextPosition = PdfWidgetAnnotationTextPosition.NoCaption;
    pdfDocumentProcessor.SaveDocument("FormDemo_new.pdf");
}

VB.NET

Using pdfDocumentProcessor As New PdfDocumentProcessor()
  pdfDocumentProcessor.LoadDocument("Documents//FormDemo.pdf")

  Dim documentFacade As PdfDocumentFacade = pdfDocumentProcessor.DocumentFacade
  Dim acroForm As PdfAcroFormFacade = documentFacade.AcroForm
  'Obtain button form field parameters:
  Dim pushButton As PdfButtonFormFieldFacade = acroForm.GetButtonFormField("Submit")
  Dim buttonWidget As PdfButtonWidgetFacade = pushButton.Widgets(0)

  'Specify a button icon and set its options:
  buttonWidget.SetNormalIcon("Documents//submit_3802014.png")
  buttonWidget.IconOptions.FitToAnnotationBounds = True
  buttonWidget.IconOptions.ScaleCondition = PdfIconScalingCircumstances.BiggerThanAnnotationRectangle
  buttonWidget.TextPosition = PdfWidgetAnnotationTextPosition.NoCaption
  pdfDocumentProcessor.SaveDocument("FormDemo_new.pdf")
End Using