Namespace DocWright.Dom.Forms

Classes

FormField

A legacy form field — the FORMTEXT, FORMCHECKBOX and FORMDROPDOWN fields Word wrote before content controls existed, and still writes for documents in compatibility mode.

A legacy form field is a field chain whose begin character carries a w:ffData element (ECMA-376 Part 1 §17.16.17). Phase 14 already parses the instruction; this type adds the w:ffData half, which the reader has been preserving as an island on the begin run since Phase 1.

Editing works the same way content controls do: typed properties are a view over the preserved island, and a setter splices it. An edit the rewriter cannot place with certainty throws FormFieldEditException and changes nothing.

Macros are preserved, never run. EntryMacro and ExitMacro report the names a document recorded. DocWright does not execute them and has no mechanism to.

FormFieldDiscovery

Finds legacy form fields — the field chains whose begin character carries a w:ffData.

FormFieldEditException

Thrown when a legacy form field edit was refused because it could not be applied with certainty, or because the property does not apply to the field's kind.

As with content controls, the refusal is the feature: a form field's typed properties are a view over the preserved w:ffData, and that island is what the writer emits. When this is thrown, neither the island nor the field has changed.

Enums

FormFieldKind

The kind of a legacy form field, determined by the type-specific child of w:ffData (ECMA-376 Part 1 §17.16.17).

FormTextType

What a text form field accepts (w:textInput/w:type).