addSimpleField
- addBibliography
- addBookmark
- addBreak
- addChart
- addCitation
- addComment
- addCrossReference
- addDateAndHour
- addEndnote
- addExternalFile
- addFootnote
- addFormElement
- addHeading
- addImage
- addLink
- addList
- addMathEquation
- addMergeField
- addOLE
- addOnlineVideo
- addPageNumber
- addShape
- addSimpleField
- addSource
- addStructuredDocumentTag
- addSVG
- addTab
- addTable
- addTableContents
- addTableFigures
- addText
- addTextBox
- addWordFragment
- addWordML
- embedHTML
- addBackgroundImage
- addFooter
- addFooterSection
- addHeader
- addHeaderSection
- addLineNumbering
- addMacroFromDoc
- addPageBorders
- addProperties
- addSection
- createDocx
- createDocxAndDownload
- createCharacterStyle
- createListStyle
- createParagraphStyle
- createTableStyle
- docxSettings
- embedFont
- importChartStyle
- importHeadersAndFooters
- importListStyle
- importStyles
- importStylesWordDefault
- modifyPageLayout
- parseStyles
- removeFooters
- removeHeaders
- setBackgroundColor
- setDefaultFont
- setDocumentDefaultStyles
- setEncodeUTF8
- setLanguage
- setMarkAsFinal
- setRTL
- clearBlocks
- cloneBlock
- deleteBlock
- getTemplateVariables
- getTemplateVariablesType
- modifyInputFields
- modifyMergeFields
- processTemplate
- removeTemplateVariable
- removeTemplateVariableImage
- replaceBlock
- replaceListVariable
- replacePlaceholderImage
- replaceTableVariable
- replaceVariableByExternalFile
- replaceVariableByHtml
- replaceVariableByText
- replaceVariableByWordFragment
- replaceVariableByWordML
- setTemplateSymbol
- setTemplateBlockSymbol
- tickCheckboxes
addSimpleField
![](/img/preview/methods_check.png)
Inserts a Word field into your Word document.
This method allows you to insert different types of Word fields into your Word document.
Among the automatic fields that you may insert are:
- AUTHOR
- COMMENTS
- DOCPROPERTY
- FILENAME
- FILESIZE
- KEYWORDS
- LASTSAVEDBY
- NUMCHARS
- NUMPAGES
- NUMWORDS
- SUBJECT
- TEMPLATE
- TITLE
Beware that, of course, some of these fields (like, for example, AUTHOR) have to be previously defined in the Word document. This can be achieved either via the use of a customized base template or with the help of the addProperties method.
There are specific methods for the insertion of dates and page numbers that allow for a further customization of the resulting field. If the updateFields option is not set to true, in certain cases, the user may need to press F9 in the MS Word interface to update the field value. Please, check for each particular case in the resulting Word document.
fieldName
The field value.
type
The possible values are: date, numeric or general.
format
This requires a working knowledge of the Word simple fields available formats (see, for example, this web page). Beware that you should omit the \*, \# and the \@ chunks that are already taken into account in the type parameter. The default value is empty.
options
Key | Type | Description |
---|---|---|
doNotShadeFormData | bool | If true does not shade the corresponding field. Default value is false. |
updateFields | bool | If true the user will be prompted to update the field data on opening the ord document. Check case by case if you need to activate this property. The default value is false. |
The possible keys and values are:
Key | Type | Description |
---|---|---|
pStyle | string | Paragraph style to be used. |
backgroundColor | string | Hexadecimal color value: FF0000, 000000... |
bidi | bool | Sets to true for right to left languages like Hebrew or Arabic. |
bold | bool | If true the text will be shown in bold characters. |
border | string | Available values are:
|
borderBottom | string | Overwrites the general border type for the bottom border of the paragraph. |
borderLeft | string | Overwrites the general border type for the left border of the paragraph. |
borderTop | string | Overwrites the general border type for the top border of the paragraph. |
borderRight | string | Overwrites the general border type for the right border of the paragraph. |
borderColor | string | Hexadecimal color value: FF0000, 000000... |
borderBottomColor | string | Overwrites the general border color for the bottom border of the paragraph. |
borderLeftColor | string | Overwrites the general border color for the left border of the paragraph. |
borderTopColor | string | Overwrites the general border color for the top border of the paragraph. |
borderRightColor | string | Overwrites the general border color for the right border of the paragraph. |
borderSpacing | int | Separation between border and text in points. |
borderBottomSpacing | int | Overwrites the general border spacing for the bottom border of the paragraph. |
borderLeftSpacing | int | Overwrites the general border spacing for the left border of the paragraph. |
borderTopSpacing | int | Overwrites the general border spacing for the top border of the paragraph. |
borderRightSpacing | int | Overwrites the general border spacing for the right border of the paragraph. |
borderWidth | int | Border width in eigths of a point. |
borderBottomWidth | int | Overwrites the general border width for the bottom border of the paragraph. |
borderLeftWidth | int | Overwrites the general border width for the left border of the paragraph. |
borderTopWidth | int | Overwrites the general border width for the top border of the paragraph. |
borderRightWidth | int | Overwrites the general border width for the right border of the paragraph. |
caps | bool | If true displays text in capital letters. |
color | string | Hexadecimal color value: 'FF0000', '000000'... |
contextualSpacing | bool | If true ignores spacing above and below the paragraph whenever the neighbouring paragraphs use the same Word style (false by default). |
doubleStrikeThrough | bool | If true displays text in doubleStrikeThrough. |
em | string | Emphasis mark type: 'none', 'dot', 'circle', 'comma', 'underDot'. |
emboss | bool | Emboss style. |
firstLineIndent | int | First line indentation in twentieths of a point (twips). |
font | string | Font family: 'Arial', Calibri'... |
fontSize | int | Font size in points. |
hanging | int | Paragraph hanging in twentieths of a point (twips). |
headingLevel | int | The heading level if you want this paragraph to be a heading. |
italic | bool | If true displays the text in italics. |
indentLeft | int | Left margin in points. |
indentRight | int | Right margin in points. |
keepLines | bool | Keeps (whenever possible) all the current paragraph lines on the same page. |
keepNext | bool | Keeps (whenever possible) in the same page the current paragraph with next paragraph. |
lineSpacing | int | 120, 240 (standard), 360, 480... (in twentieths of a point). |
noProof | bool | Ignore spelling and grammar errors. |
outline | bool | Outline style. |
parseLineBreaks | bool | If true (default is false) parses the line breaks to include them in the Word document. |
parseTabs | bool | If true (default is false) parses the tabs to include them in the Word document as w:tab tags. |
position | int | Position value. Positive value for raised and negative value for lowered. |
rtl | bool | Sets to true for right to left languages like Hebrew or Arabic. |
scaling | int | Scaling value, 100 is the default value. |
shadow | bool | Shadow style. |
smallCaps | bool | If true displays text in small capital letters. |
spacingBottom | int | Bottom padding in twentieths of a point. |
spacingTop | int | Top padding in twentieths of a point. |
strikeThrough | bool | If true displays text in strikethrough. |
suppressLineNumbers | bool | Suppress line numbers. |
tabPositions | array | Each entry is an associative array with the following keys and values:
|
textAlign | string | Text alignment within paragraph. Possible values are: center, right, both and distribute. |
textDirection | string | Text flow direction within a table cell. Possible values are: lrTb, tbRl, btLr, lrTbV, tbRlV and tbLrV. |
underline | string | Underlines text. Possible values are: single, words, double, dotted, dash and wave. |
underlineColor | string | Underlines text with a color: 'FF0000', '000000'... |
vanish | bool | Uses a vanish style. |
widowControl | bool | Prevents Word from printing the last line of a paragraph by itself at the top of the page (widow) or the first line of a paragraph at the bottom of a page (orphan). |
wordWrap | bool | Allows line breaking at character level (default value is false). |