Class
FormField

Base abstraction for fields that collect user input in a PDF, exposing common properties, actions, and access to visual widgets.

Definition

Namespace:Telerik.Windows.Documents.Fixed.Model.InteractiveForms

Assembly:Telerik.Windows.Documents.Fixed.dll

Syntax:

cs-api-definition
public abstract class FormField : IStructuralElement

Inheritance: objectFormField

Derived Classes: FormField<T>RadioButtonField

Implements: IStructuralElement

Properties

Actions

Collection of actions triggered by field events such as value changes or mouse interactions.

Declaration

cs-api-definition
public FormFieldActionCollection Actions { get; }

Property Value

FormFieldActionCollection

FieldType

Gets the field category used by viewers to render and process the field (text, button, choice, etc.).

Declaration

cs-api-definition
public abstract FormFieldType FieldType { get; }

Property Value

FormFieldType

IsReadOnly

Gets or sets a value indicating whether this field should not accept user input or changes.

Declaration

cs-api-definition
public bool IsReadOnly { get; set; }

Property Value

bool

IsRequired

Gets or sets a value indicating whether this field must contain a value when the form is submitted.

Declaration

cs-api-definition
public bool IsRequired { get; set; }

Property Value

bool

MappingName

Gets or sets the mapping name to be used when exporting interactive form field data from the document.

Declaration

cs-api-definition
public string MappingName { get; set; }

Property Value

string

Name

Gets or sets the field's unique name used to identify it within the document and exported form data.

Declaration

cs-api-definition
public string Name { get; set; }

Property Value

string

The field name used to identify this form field uniquely within the document.

Exceptions

ArgumentNullException

Name cannot be empty.

ShouldBeSkipped

Gets or sets a value indicating whether this field should be excluded from form submission.

Declaration

cs-api-definition
public bool ShouldBeSkipped { get; set; }

Property Value

bool

StructureTag

Gets the StructureTag associated with this element.

Declaration

cs-api-definition
public StructureElement StructureTag { get; set; }

Property Value

StructureElement

Implements IStructuralElement.StructureTag

TextProperties

Gets or sets the text formatting properties used by PDF viewers to render the field's appearance dynamically.

Declaration

cs-api-definition
public VariableTextProperties TextProperties { get; set; }

Property Value

VariableTextProperties

UserInterfaceName

Gets or sets an alternate field name to be used in place of the actual field name wherever the field must be identified in the user interface. For instance this may be used for error or status messages referring to the field. This text is also useful when extracting the document’s contents in support of accessibility to users with disabilities or for other purposes.

Declaration

cs-api-definition
public string UserInterfaceName { get; set; }

Property Value

string

Widgets

Collection of visual widget instances that render this field on document pages.

Declaration

cs-api-definition
public IEnumerable<Widget> Widgets { get; }

Property Value

IEnumerable<Widget>

An enumerable collection of widgets associated with this form field.

Methods

Equals(object)

Returns a value indicating whether this instance is equal to a specified object.

Declaration

cs-api-definition
public override bool Equals(object obj)

Parameters

obj

object

The object to compare with the current form field.

Returns

bool

true if the specified object is equal to the current form field; otherwise, false.

Overrides object.Equals(object)

GetHashCode()

Returns a hash code for the current form field based on its key properties.

Declaration

cs-api-definition
public override int GetHashCode()

Returns

int

A hash code value for the current form field instance.

Overrides object.GetHashCode()