ApiTextForm

new ApiTextForm()

Class representing a document text field.

Properties

Name Type Description
comb boolean

Specifies if the text field should be a comb of characters with the same cell width. The maximum number of characters must be set to a positive value.

maxCharacters number

The maximum number of characters in the text field.

cellWidth number

The cell width for each character measured in millimeters. If this parameter is not specified or equal to 0 or less, then the width will be set automatically.

multiLine boolean

Specifies if the current fixed size text field is multiline or not.

autoFit boolean

Specifies if the text field content should be autofit, i.e. whether the font size adjusts to the size of the fixed size form.

Methods

Name Description
Clear

Clears the current form.

Copy

Copies the current form (copies with the shape if it exists).

GetCharactersLimit

Returns a limit of the text field characters.

GetClassType

Returns a type of the ApiFormBase class.

GetFormKey

Returns the current form key.

GetFormType

Returns a type of the current form.

GetText

Returns the text from the current form. This method is used only for text and combo box forms.

GetTextPr

Returns the text properties from the current form. This method is used only for text and combo box forms.

GetTipText

Returns the tip text of the current form.

GetWrapperShape

Returns a shape in which the form is placed to control the position and size of the fixed size form frame. The null value will be returned for the inline forms.

IsAutoFit

Checks if the text field content is autofit, i.e. whether the font size adjusts to the size of the fixed size form.

IsComb

Checks if the text field is a comb of characters with the same cell width.

IsFixed

Checks if the current form is fixed size.

IsMultiline

Checks if the current text field is multiline.

IsRequired

Checks if the current form is required.

SetAutoFit

Specifies if the text field content should be autofit, i.e. whether the font size adjusts to the size of the fixed size form.

SetBackgroundColor

Sets the background color to the current form.

SetBorderColor

Sets the border color to the current form.

SetCellWidth

Sets the cell width to the applied comb of characters.

SetCharactersLimit

Sets a limit to the text field characters.

SetComb

Specifies if the text field should be a comb of characters with the same cell width. The maximum number of characters must be set to a positive value.

SetFormKey

Sets a key to the current form.

SetMultiline

Specifies if the current text field should be miltiline.

SetPlaceholderText

Sets the placeholder text to the current form. Can't be set to checkbox or radio button.

SetRequired

Specifies if the current form should be required.

SetText

Sets the text to the current text field.

SetTextPr

Sets the text properties to the current form. This method is used only for text and combo box forms.

SetTipText

Sets the tip text to the current form.

ToFixed

Converts the current form to a fixed size form.

ToInline

Converts the current form to an inline form. Picture form can't be converted to an inline form, it's always a fixed size object.

Example

Copy code
builder.CreateFile("docx");
var oDocument = Api.GetDocument();
var oTextForm = Api.CreateTextForm({"key": "Personal information", "tip": "Enter your first name", "required": true, "placeholder": "First name", "multiLine": false, "autoFit": false});
var oParagraph = oDocument.GetElement(0);
oParagraph.AddElement(oTextForm);
oTextForm.SetCharactersLimit(5);
oTextForm.SetText("John Smith");
oTextForm.SetComb(true);
var nLimit = oTextForm.GetCharactersLimit();
var bComb = oTextForm.IsComb();
var bMultiline = oTextForm.IsMultiline();
var bAutoFit = oTextForm.IsAutoFit();
oParagraph = Api.CreateParagraph();
oParagraph.AddText("Characters limit: " + nLimit);
oParagraph.AddLineBreak();
oParagraph.AddText("The first text form from this document is comb: " + bComb);
oParagraph.AddLineBreak();
oParagraph.AddText("The first text form from this document is multiline: " + bMultiline);
oParagraph.AddLineBreak();
oParagraph.AddText("The first text form from this document is autofit: " + bAutoFit);
oDocument.Push(oParagraph);
builder.SaveFile("docx", "ApiTextForm.docx");
builder.CloseFile();

Resulting document