Log in
Contact
addHeading
- addBackgroundImage
- addFooter
- addHeader
- addLineNumbering
- addPageBorders
- addProperties
- addSection
- createDocx
- createCharacterStyle
- createListStyle
- createParagraphStyle
- createTableStyle
- docxSettings
- embedFont
- importHeadersAndFooters
- importStyles
- modifyPageLayout
- removeFooters
- removeHeaders
- setBackgroundColor
- setDefaultFont
- setDocumentDefaultStyles
- setEncodeUTF8
- setLanguage
- setMarkAsFinal
- setRTL
- addBibliography
- addBookmark
- addBreak
- addChart
- addCitation
- addComment
- addCrossReference
- addDateAndHour
- addEndnote
- addExternalFile
- addFootnote
- addFormElement
- addHeading
- addImage
- addLink
- addList
- addMathEquation
- addMergeField
- addOLE
- addPageNumber
- addShape
- addSimpleField
- addSource
- addStructuredDocumentTag
- addTable
- addTableContents
- addText
- addTextBox
- addWordML
- embedHTML
- clearBlocks
- deleteTemplateBlock
- getTemplateVariables
- getTemplateVariablesType
- modifyInputFields
- modifyMergeFields
- processTemplate
- removeTemplateVariable
- replaceListVariable
- replacePlaceholderImage
- replaceTableVariable
- replaceVariableByExternalFile
- replaceVariableByHtml
- replaceVariableByText
- replaceVariableByWordFragment
- replaceVariableByWordML
- setTemplateSymbol
- tickCheckbox
addHeading
BASIC / ADVANCED / PREMIUM
Inserts a heading into the Word document.
Description
public void addHeading(String text)
public void addHeading(String text, Integer level)
public void addHeading(String text, Integer level, OptionsHeading options)
This method allows you to insert a heading into your Word document.
If a text is inserted as a heading it will show up in the associated Table of Contents. Please refer to addTableContents for further detail to that respect.
If you wish you may obtain similar results using the addText method with a standard Word heading style.
Parameters
text
Include the text that you want to be shown in the heading.
level
An integer specifying the heading level. If not set up explicitely it takes the default value of 1.
options
| Option | Type | Description |
|---|---|---|
| pStyle | String | Word style to be used. |
| backgroundColor | String | Hexadecimal color value: FF0000, 000000... |
| bidi | Boolean | Sets to true for right to left languages like Hebrew or Arabic. |
| bold | Boolean | 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 | Integer | Separation between border and text in points. |
| borderBottomSpacing | Integer | Overwrites the general border spacing for the bottom border of the paragraph. |
| borderLeftSpacing | Integer | Overwrites the general border spacing for the left border of the paragraph. |
| borderTopSpacing | Integer | Overwrites the general border spacing for the top border of the paragraph. |
| borderRightSpacing | Integer | Overwrites the general border spacing for the right border of the paragraph. |
| borderWidth | Integer | Border width in eigths of a point. |
| borderBottomWidth | Integer | Overwrites the general border width for the bottom border of the paragraph. |
| borderLeftWidth | Integer | Overwrites the general border width for the left border of the paragraph. |
| borderTopWidth | Integer | Overwrites the general border width for the top border of the paragraph. |
| borderRightWidth | Integer | Overwrites the general border width for the right border of the paragraph. |
| caps | Boolean | If true displays text in capital letters. |
| color | String | Hexadecimal color value: "FF0000", "000000"... |
| contextualSpacing | String | Ignores spacing above and below the paragraph whenever the neighbouring paragraphs use the same Word style. |
| doubleStrikeThrough | Boolean | If true displays text in doubleStrikeThrough. |
| em | String | Emphasis mark type: "none", "dot", "circle", "comma", "underDot". |
| firstLineIndent | Integer | First line indentation in twentieths of a point (twips). |
| font | String | Font family: "Arial", "Calibri"... |
| fontSize | Integer | Font size in points. |
| hanging | Integer | Paragraph hanging in twentieths of a point (twips). |
| headingLevel | Integer | The heading level if you want this paragraph to be a heading. |
| italic | Boolean | If true displays the text in italics. |
| indentLeft | Integer | Left margin in points. |
| indentRight | Integer | Right margin in points. |
| keepLines | Boolean | Keeps (whenever possible) all the current paragraph lines on the same page (default value is false). |
| keepNext | Boolean | Keeps (whenever possible) in the same page the current paragraph with next paragraph (default value is false). |
| lineSpacing | Integer | 120, 240 (standard), 360, 480... (in twentieths of a point). |
| pageBreakBefore | Boolean | If true forces a page break before the paragraph. |
| primaryStyle | Boolean | If true sets as primary style. | position | Integer | Position value. Positive value for raised and negative value for lowered. |
| rtl | Boolean | Sets to true for right to left languages like Hebrew or Arabic. |
| scaling | Integer | Scaling value, 100 is the default value. |
| semiHidden | Boolean | If true sets as semihidden style. |
| smallCaps | Boolean | If true displays text in small capital letters. |
| spacingBottom | Integer | Bottom padding in twentieths of a point. |
| spacingTop | Integer | Top padding in twentieths of a point. |
| strikeThrough | Boolean | If true displays text in strikethrough. |
| tabPositions | ArrayList<HashMap<String, String>> | Each entry is a HashMap 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 | Boolean | Uses a vanish style. |
| widowControl | Boolean | 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 | Boolean | Allows line breaking at character level (default value is false). |
Code samples
Example #1
The resulting Word document looks like:
