FormField Object
Description
Represents a form field.
Syntax
FormFieldExamples
The following example demonstrates FormField in a practical document-editing workflow. It represents a form field.
function onTxError(error) {
console.error("TX Text Control error:", error.msg);
error.handled = true;
}
TXTextControl.textParts.getMainText(function(mainText) {
const formFields = mainText.formFields;
formFields.getItem(function(formField) {
if (!formField) {
console.warn("No form field is available at the current input position.");
return;
}
formField.getChecked(
function(result) {
if (result) {
console.log("get checked is available.");
} else {
console.warn("get checked is not available in the current document state.");
}
},
onTxError
);
}, onTxError);
}, onTxError);Members
Methods
| Method | Description |
|---|---|
| getBounds | Gets the bounding rectangle of a text field. (Inherited from TextField.) |
| getContainsInputPosition | Returns true, if the Textfield contains the current text input position. (Inherited from TextField.) |
| getDeleteable | Gets whether a text field can be deleted by the end-user while a TX Text Control document is being edited. (Inherited from TextField.) |
| getDescriptiveText | Gets the form field's descriptive text. An empty string indicates that the link has no such text. |
| getDoubledInputPosition | Sets whether a text field has a doubled input position in front of its first character and behind its last character. (Inherited from TextField.) |
| getEditable | Gets whether the text of a text field can be changed by the end-user while a TX Text Control document is being edited. (Inherited from TextField.) |
| getEnabled | Gets a value indicating whether the form field is enabled. |
| getFormattingBounds | Gets the formatting rectangle of a text field. (Inherited from TextField.) |
| getHighlightColor | Gets the highlight color for the text field. (Inherited from TextField.) |
| getHighlightMode | Gets a value indicating when the text field is highlighted. (Inherited from TextField.) |
| getID | Gets an identifier for a text field. (Inherited from TextField.) |
| getIsSpellCheckingEnabled | Gets whether a text field's text is checked on misspelled words. (Inherited from TextField.) |
| getLength | Gets the number of characters in a text field. (Inherited from TextField.) |
| getName | Relates a user-defined name to a text field. (Inherited from TextField.) |
| getStart | Gets the first character position (one-based) of a text field. (Inherited from TextField.) |
| getText | Gets the text which is contained within a text field. (Inherited from TextField.) |
| scrollTo | Sets the current input position to the beginning of a text field and scrolls it into the visible part of the document. (Inherited from TextField.) |
| setDeleteable | Sets whether a text field can be deleted by the end-user while a TX Text Control document is being edited. (Inherited from TextField.) |
| setDescriptiveText | Sets the form field's descriptive text. An empty string or null can be used to delete a previously set text. |
| setDoubledInputPosition | Gets whether a text field has a doubled input position in front of its first character and behind its last character. (Inherited from TextField.) |
| setEditable | Sets whether the text of a text field can be changed by the end-user while a TX Text Control document is being edited. (Inherited from TextField.) |
| setEnabled | Sets a value indicating whether the form field is enabled. This property has only an effect, when the when the edit mode is set to TXTextControl.EditMode.ReadAndSelect and the allowEditingFormFields property of the document permissions has been set to true. In this case a Formfield can only be edited, when its Enabled property is true. When a FormField is disabled, the TextFieldClicked and TextFieldDoubleClicked of the Formfield are suppressed. The default value of this property is true. |
| setHighlightColor | Sets the highlight color for the text field. (Inherited from TextField.) |
| setHighlightMode | Sets a value indicating when the text field is highlighted. (Inherited from TextField.) |
| setID | Sets an identifier for the text field. (Inherited from TextField.) |
| setIsSpellCheckingEnabled | Gets whether a text field's text is checked on misspelled words. (Inherited from TextField.) |
| setName | Sets the name of a text field. (Inherited from TextField.) |
| setText | Sets the text which is contained within a text field. (Inherited from TextField.) |