API Reference
PdfFormField
Simple AcroForm field information read from a PDF document.
Inheritance
- Object
- PdfFormField
Usage
This type appears in these public API surfaces even when no hand-authored example is attached directly to the page.
Returned or exposed by
- Property PdfAcroFormEditResult.Fields
- Method PdfDocumentInfo.GetFormFields
- Method PdfDocumentInfo.GetFormFields
- Property PdfDocumentInfo.FormFields
- Property PdfDocumentInfo.FormFieldsByKind
- Property PdfDocumentInfo.FormFieldsByName
- Property PdfDocumentInfo.FormFieldsByPageNumber
- Method PdfDocumentReader.FormField
- Method PdfDocumentReader.FormFields
- Method PdfDocumentReader.FormFields
- Method PdfDocumentReader.FormFields
- Method PdfDocumentReader.FormFields
- Method PdfDocumentReader.TryFormFields
- Method PdfDocumentReader.TryFormFields
- Method PdfDocumentReader.TryFormFields
- Method PdfDocumentReader.TryFormFields
- Method PdfLogicalDocument.GetFormFields
- Method PdfLogicalDocument.GetFormFields
- Property PdfLogicalDocument.FormFields
- Property PdfLogicalDocument.FormFieldsByKind
- Property PdfLogicalDocument.FormFieldsByName
- Property PdfLogicalDocument.FormFieldsByPageNumber
- Property PdfLogicalFormWidget.Field
- Property PdfReadDocument.FormFields
Accepted by parameters
Methods
public IReadOnlyList<PdfFormWidget> GetWidgets(Int32 pageNumber) #IReadOnlyList<PdfFormWidget>Returns readable widget annotations for this field on a one-based page number.
Parameters
- pageNumber System.Int32
Inherited Methods
Properties
public Nullable<Int32> ObjectNumber { get; } #Indirect object number for the field dictionary, when known.
public String Name { get; } #Fully qualified field name when a name can be read.
public String PartialName { get; } #Partial field name from the field dictionary.
public String FieldType { get; } #Field type name, for example Tx, Btn, Ch, or Sig, when present or inherited.
public PdfFormFieldKind Kind { get; } #Common field kind inferred from FieldType.
public String Value { get; } #Simple field value formatted for wrapper display, when present.
public IReadOnlyList<String> Values { get; } #Simple field values from /V, preserving array values for multi-select choice fields.
public Int32 ValueCount { get; } #Number of readable field values.
public Boolean HasValues { get; } #True when at least one simple field value was readable.
public String DefaultValue { get; } #Simple default field value formatted for wrapper display, when present.
public IReadOnlyList<String> DefaultValues { get; } #Simple default field values from /DV, preserving array values for multi-select choice fields.
public Int32 DefaultValueCount { get; } #Number of readable default field values.
public Boolean HasDefaultValues { get; } #True when at least one simple default field value was readable.
public String AlternateName { get; } #Alternate field name used as a user-facing label, when present.
public String MappingName { get; } #Mapping name used for export workflows, when present.
public Nullable<Int32> Flags { get; } #Raw field flags from /Ff, when present.
public Nullable<Int32> MaxLength { get; } #Maximum text length from /MaxLen, when present on a simple field.
public String DefaultAppearance { get; } #Default appearance string from /DA, when present or inherited.
public Boolean HasDefaultAppearance { get; } #True when a default appearance string was readable.
public Nullable<Int32> Quadding { get; } #Raw AcroForm /Q quadding value, when present or inherited.
public PdfFormFieldTextAlignment TextAlignment { get; } #Common text alignment inferred from /Q quadding.
public IReadOnlyList<PdfFormFieldOption> Options { get; } #Choice field options from /Opt, when readable.
public Int32 OptionCount { get; } #Number of readable choice options.
public Boolean HasOptions { get; } #True when at least one choice option was readable.
public IReadOnlyList<PdfFormFieldOption> SelectedOptions { get; } #Readable choice options whose export value matches the field value list.
public Int32 SelectedOptionCount { get; } #Number of readable choice options whose export value matches the field value list.
public Boolean HasSelectedOptions { get; } #True when at least one readable choice option matches the field value list.
public IReadOnlyList<PdfFormFieldOption> DefaultSelectedOptions { get; } #Readable choice options whose export value matches the default field value list.
public Int32 DefaultSelectedOptionCount { get; } #Number of readable choice options whose export value matches the default field value list.
public Boolean HasDefaultSelectedOptions { get; } #True when at least one readable choice option matches the default field value list.
public Boolean IsReadOnly { get; } #True when the common read-only field flag is set.
public Boolean IsRequired { get; } #True when the common required field flag is set.
public Boolean IsNoExport { get; } #True when the common no-export field flag is set.
public Boolean IsTextField { get; } #True when this is a text field.
public Boolean IsButtonField { get; } #True when this is a button field.
public Boolean IsChoiceField { get; } #True when this is a choice field.
public Boolean IsSignatureField { get; } #True when this is a signature field.
public Boolean IsMultiline { get; } #True when a text field has the multiline flag set.
public Boolean IsPassword { get; } #True when a text field has the password flag set.
public Boolean IsFileSelect { get; } #True when a text field has the file-select flag set.
public Boolean DoesNotSpellCheck { get; } #True when a text or choice field disables spell checking.
public Boolean DoesNotScroll { get; } #True when a text field disables scrolling.
public Boolean IsComb { get; } #True when a text field uses comb formatting.
public Boolean IsRichText { get; } #True when a text field has the rich-text flag set.
public Boolean IsPushButton { get; } #True when a button field is a push button.
public Boolean IsRadioButton { get; } #True when a button field is a radio button.
public Boolean IsNoToggleToOff { get; } #True when a button field has the no-toggle-to-off flag set.
public Boolean IsCheckBox { get; } #True when a button field is a check box rather than a push button or radio button.
public Boolean IsCombo { get; } #True when a choice field is a combo box.
public Boolean IsEditableChoice { get; } #True when a choice combo box allows direct text editing.
public Boolean IsSortedChoice { get; } #True when a choice field asks viewers to sort options.
public Boolean AllowsMultipleSelection { get; } #True when a choice field allows multiple selections.
public Boolean CommitsOnSelectionChange { get; } #True when a choice field commits values immediately when the selected item changes.
public IReadOnlyList<PdfFormWidget> Widgets { get; } #Simple widget annotations that visually represent this field, when readable.
public Int32 WidgetCount { get; } #Number of readable widget annotations associated with this field.
public Boolean HasWidgets { get; } #True when at least one widget annotation was associated with this field.
public IReadOnlyList<Int32> PageNumbers { get; } #Distinct one-based page numbers where this field has readable widget annotations.
public Int32 PageNumberCount { get; } #Number of distinct readable page numbers where this field has widgets.
public Boolean HasPageNumbers { get; } #True when at least one widget for this field has a readable page number.
public IReadOnlyDictionary<Int32, IReadOnlyList<PdfFormWidget>> WidgetsByPageNumber { get; } #Readable widget annotations for this field grouped by one-based page number.