officefileapi-devexpress-dot-pdf-a18dcc7b.md
Represents a check box field.
Namespace : DevExpress.Pdf
Assembly : DevExpress.Pdf.v25.2.Core.dll
NuGet Package : DevExpress.Pdf.Core
public class PdfAcroFormCheckBoxField :
PdfAcroFormCommonVisualField
Public Class PdfAcroFormCheckBoxField
Inherits PdfAcroFormCommonVisualField
The following members return PdfAcroFormCheckBoxField objects:
The check box field is represented by an instance of the PdfAcroFormCheckBoxField class with the specified field name, page number where the field will be added, and the field rectangle.
The PdfAcroFormCheckBoxField class contains properties to specify a check box field. For example, to specify the check box name, tooltip and appearance, use PdfAcroFormField.Name, PdfAcroFormField.ToolTip, and PdfAcroFormVisualField.Appearance properties.
You can also specify whether a check box is in the pushed state using the PdfAcroFormCheckBoxField.IsChecked property.
To add check box fields to a document, pass an array of PdfAcroFormCheckBoxField objects as a parameter to the PdfDocumentProcessor.AddFormFields method.
To delete a form field from a document using a field name, call the PdfDocumentProcessor.RemoveFormField method.
To delete all interactive elements from a document, call the PdfDocumentProcessor.RemoveForm method.
This example creates a text box and radio button group fields, and adds them to a document.
using DevExpress.Pdf;
using (PdfDocumentProcessor processor = new PdfDocumentProcessor())
{
// Load a document:
processor.LoadDocument("..\\..\\Document.pdf");
// Create a text box field:
PdfAcroFormTextBoxField textBox =
new PdfAcroFormTextBoxField("text box", 1, new PdfRectangle(230, 690, 280, 710));
// Specify text box text and appearance:
textBox.Text = "Text Box";
textBox.Appearance.BackgroundColor = new PdfRGBColor(0.8, 0.5, 0.3);
textBox.Appearance.FontSize = 12;
// Create a radio group field:
PdfAcroFormRadioGroupField radioGroup =
PdfAcroFormField.CreateRadioGroup("Gender Group", 1);
// Add the first radio button to the group and specify its location:
radioGroup.AddButton("button1", new PdfRectangle(230, 635, 250, 655));
// Add the second radio button to the group:
radioGroup.AddButton("button2", new PdfRectangle(310, 635, 330, 655));
// Specify radio group's selected index and appearance:
radioGroup.SelectedIndex = 0;
radioGroup.Appearance.BorderAppearance = new PdfAcroFormBorderAppearance()
{ Color = new PdfRGBColor(0.8, 0.5, 0.3), Width = 3 };
// Add form fields to the page:
processor.AddFormFields(textBox, radioGroup);
// Save the resulting document:
processor.SaveDocument("..\\..\\Result.pdf");
}
Imports DevExpress.Pdf
Namespace AddFormFieldsToExistingDocument
Friend Class Program
Shared Sub Main(ByVal args() As String)
Using processor As New PdfDocumentProcessor()
' Load a document:
processor.LoadDocument("..\..\Document.pdf")
' Create a text box field:
Dim textBox As New PdfAcroFormTextBoxField("text box", 1, New PdfRectangle(230, 690, 280, 710))
' Specify text box text and appearance:
textBox.Text = "Text Box"
textBox.Appearance.BackgroundColor = New PdfRGBColor(0.8, 0.5, 0.3)
textBox.Appearance.FontSize = 12
' Create a radio group field:
Dim radioGroup As PdfAcroFormRadioGroupField = PdfAcroFormField.CreateRadioGroup("Gender Group", 1)
' Add the first radio button to the group and specify its location:
radioGroup.AddButton("button1", New PdfRectangle(230, 635, 250, 655))
' Add the second radio button to the group:
radioGroup.AddButton("button2", New PdfRectangle(310, 635, 330, 655))
' Specify radio group selected index and appearance:
radioGroup.SelectedIndex = 0
radioGroup.Appearance.BorderAppearance = New PdfAcroFormBorderAppearance() With {.Color = New PdfRGBColor(0.8, 0.5, 0.3), .Width = 3}
' Add form fields to the page:
processor.AddFormFields(textBox, radioGroup)
' Save the resulting document:
processor.SaveDocument("..\..\Result.pdf")
End Using
End Sub
End Class
End Namespace
Object PdfAcroFormField PdfAcroFormVisualField PdfAcroFormCommonVisualField PdfAcroFormCheckBoxField
See Also