public class ParagraphFormat
extends java.lang.Object
To learn more, visit the Working with Paragraphs documentation article.
Examples:
Shows how to construct an Aspose.Words document by hand.
Document doc = new Document();
// A blank document contains one section, one body and one paragraph.
// Call the "RemoveAllChildren" method to remove all those nodes,
// and end up with a document node with no children.
doc.removeAllChildren();
// This document now has no composite child nodes that we can add content to.
// If we wish to edit it, we will need to repopulate its node collection.
// First, create a new section, and then append it as a child to the root document node.
Section section = new Section(doc);
doc.appendChild(section);
// Set some page setup properties for the section.
section.getPageSetup().setSectionStart(SectionStart.NEW_PAGE);
section.getPageSetup().setPaperSize(PaperSize.LETTER);
// A section needs a body, which will contain and display all its contents
// on the page between the section's header and footer.
Body body = new Body(doc);
section.appendChild(body);
// Create a paragraph, set some formatting properties, and then append it as a child to the body.
Paragraph para = new Paragraph(doc);
para.getParagraphFormat().setStyleName("Heading 1");
para.getParagraphFormat().setAlignment(ParagraphAlignment.CENTER);
body.appendChild(para);
// Finally, add some content to do the document. Create a run,
// set its appearance and contents, and then append it as a child to the paragraph.
Run run = new Run(doc);
run.setText("Hello World!");
run.getFont().setColor(Color.RED);
para.appendChild(run);
Assert.assertEquals("Hello World!", doc.getText().trim());
doc.save(getArtifactsDir() + "Section.CreateManually.docx");
| Modifier and Type | Method and Description |
|---|---|
void |
clearFormatting()
Resets to default paragraph formatting.
|
java.lang.Object |
fetchInheritedBorderAttr(int key) |
java.lang.Object |
fetchInheritedShadingAttr(int key) |
boolean |
getAddSpaceBetweenFarEastAndAlpha()
Gets a flag indicating whether inter-character spacing is automatically adjusted between regions of Latin text and regions of East Asian text in the current paragraph.
|
boolean |
getAddSpaceBetweenFarEastAndDigit()
Gets a flag indicating whether inter-character spacing is automatically adjusted between regions of numbers and regions of East Asian text in the current paragraph.
|
int |
getAlignment()
Gets text alignment for the paragraph.
|
int |
getBaselineAlignment()
Gets fonts vertical position on a line.
|
boolean |
getBidi()
Gets whether this is a right-to-left paragraph.
|
BorderCollection |
getBorders()
Gets collection of borders of the paragraph.
|
double |
getCharacterUnitFirstLineIndent()
Gets the value (in characters) for the first-line or hanging indent.
|
double |
getCharacterUnitLeftIndent()
Gets the left indent value (in characters) for the specified paragraphs.
|
double |
getCharacterUnitRightIndent()
Gets the right indent value (in characters) for the specified paragraphs.
|
java.lang.Object |
getDirectBorderAttr(int key) |
int |
getDropCapPosition()
Gets the position for a drop cap text.
|
boolean |
getFarEastLineBreakControl()
Gets a flag indicating whether East Asian line-breaking rules are applied to the current paragraph.
|
double |
getFirstLineIndent()
Gets the value (in points) for a first line or hanging indent.
|
boolean |
getHangingPunctuation()
Gets a flag indicating whether hanging punctuation is enabled for the current paragraph.
|
boolean |
getKeepTogether()
True if all lines in the paragraph are to remain on the same page.
|
boolean |
getKeepWithNext()
True if the paragraph is to remains on the same page as the paragraph that follows it.
|
double |
getLeftIndent()
Gets the value (in points) that represents the left indent for paragraph.
|
double |
getLineSpacing()
Gets the line spacing (in points) for the paragraph.
|
int |
getLineSpacingRule()
Gets the line spacing for the paragraph.
|
int |
getLinesToDrop()
Gets the number of lines of the paragraph text used to calculate the drop cap height.
|
double |
getLineUnitAfter()
Gets the amount of spacing (in gridlines) after the paragraphs.
|
double |
getLineUnitBefore()
Gets the amount of spacing (in gridlines) before the paragraphs.
|
boolean |
getMirrorIndents()
Gets a flag indicating whether the left and right indents are of the same width.
|
boolean |
getNoSpaceBetweenParagraphsOfSameStyle()
When
true, getSpaceBefore() / setSpaceBefore(double) and getSpaceAfter() / setSpaceAfter(double) will be ignored between the paragraphs of the same style. |
int |
getOutlineLevel()
Specifies the outline level of the paragraph in the document.
|
boolean |
getPageBreakBefore()
True if a page break is forced before the paragraph.
|
double |
getRightIndent()
Gets the value (in points) that represents the right indent for paragraph.
|
Shading |
getShading()
Returns a
Shading object that refers to the shading formatting for the paragraph. |
boolean |
getSnapToGrid()
Specifies whether the current paragraph should use the document grid lines per page settings when laying out the contents in the paragraph.
|
double |
getSpaceAfter()
Gets the amount of spacing (in points) after the paragraph.
|
boolean |
getSpaceAfterAuto()
True if the amount of spacing after the paragraph is set automatically.
|
double |
getSpaceBefore()
Gets the amount of spacing (in points) before the paragraph.
|
boolean |
getSpaceBeforeAuto()
True if the amount of spacing before the paragraph is set automatically.
|
Style |
getStyle()
Gets the paragraph style applied to this formatting.
|
int |
getStyleIdentifier()
Gets the locale independent style identifier of the paragraph style applied to this formatting.
|
java.lang.String |
getStyleName()
Gets the name of the paragraph style applied to this formatting.
|
boolean |
getSuppressAutoHyphens()
Specifies whether the current paragraph should be exempted from any hyphenation which is applied in the document settings.
|
boolean |
getSuppressLineNumbers()
Specifies whether the current paragraph's lines should be exempted from line numbering which is applied in the parent section.
|
TabStopCollection |
getTabStops()
Gets the collection of custom tab stops defined for this object.
|
boolean |
getWidowControl()
True if the first and last lines in the paragraph are to remain on the same page as the rest of the paragraph.
|
boolean |
getWordWrap()
If this property is
false, Latin text in the middle of a word can be wrapped for the current paragraph. |
boolean |
isHeading()
True when the paragraph style is one of the built-in Heading styles.
|
boolean |
isListItem()
True when the paragraph is an item in a bulleted or numbered list.
|
void |
setAddSpaceBetweenFarEastAndAlpha(boolean value)
Sets a flag indicating whether inter-character spacing is automatically adjusted between regions of Latin text and regions of East Asian text in the current paragraph.
|
void |
setAddSpaceBetweenFarEastAndDigit(boolean value)
Sets a flag indicating whether inter-character spacing is automatically adjusted between regions of numbers and regions of East Asian text in the current paragraph.
|
void |
setAlignment(int value)
Sets text alignment for the paragraph.
|
void |
setBaselineAlignment(int value)
Sets fonts vertical position on a line.
|
void |
setBidi(boolean value)
Sets whether this is a right-to-left paragraph.
|
void |
setBorderAttr(int key,
java.lang.Object value) |
void |
setCharacterUnitFirstLineIndent(double value)
Sets the value (in characters) for the first-line or hanging indent.
|
void |
setCharacterUnitLeftIndent(double value)
Sets the left indent value (in characters) for the specified paragraphs.
|
void |
setCharacterUnitRightIndent(double value)
Sets the right indent value (in characters) for the specified paragraphs.
|
void |
setDropCapPosition(int value)
Sets the position for a drop cap text.
|
void |
setFarEastLineBreakControl(boolean value)
Sets a flag indicating whether East Asian line-breaking rules are applied to the current paragraph.
|
void |
setFirstLineIndent(double value)
Sets the value (in points) for a first line or hanging indent.
|
void |
setHangingPunctuation(boolean value)
Sets a flag indicating whether hanging punctuation is enabled for the current paragraph.
|
void |
setKeepTogether(boolean value)
True if all lines in the paragraph are to remain on the same page.
|
void |
setKeepWithNext(boolean value)
True if the paragraph is to remains on the same page as the paragraph that follows it.
|
void |
setLeftIndent(double value)
Sets the value (in points) that represents the left indent for paragraph.
|
void |
setLineSpacing(double value)
Sets the line spacing (in points) for the paragraph.
|
void |
setLineSpacingRule(int value)
Sets the line spacing for the paragraph.
|
void |
setLinesToDrop(int value)
Sets the number of lines of the paragraph text used to calculate the drop cap height.
|
void |
setLineUnitAfter(double value)
Sets the amount of spacing (in gridlines) after the paragraphs.
|
void |
setLineUnitBefore(double value)
Sets the amount of spacing (in gridlines) before the paragraphs.
|
void |
setMirrorIndents(boolean value)
Sets a flag indicating whether the left and right indents are of the same width.
|
void |
setNoSpaceBetweenParagraphsOfSameStyle(boolean value)
When
true, getSpaceBefore() / setSpaceBefore(double) and getSpaceAfter() / setSpaceAfter(double) will be ignored between the paragraphs of the same style. |
void |
setOutlineLevel(int value)
Specifies the outline level of the paragraph in the document.
|
void |
setPageBreakBefore(boolean value)
True if a page break is forced before the paragraph.
|
void |
setRightIndent(double value)
Sets the value (in points) that represents the right indent for paragraph.
|
void |
setSnapToGrid(boolean value)
Specifies whether the current paragraph should use the document grid lines per page settings when laying out the contents in the paragraph.
|
void |
setSpaceAfter(double value)
Sets the amount of spacing (in points) after the paragraph.
|
void |
setSpaceAfterAuto(boolean value)
True if the amount of spacing after the paragraph is set automatically.
|
void |
setSpaceBefore(double value)
Sets the amount of spacing (in points) before the paragraph.
|
void |
setSpaceBeforeAuto(boolean value)
True if the amount of spacing before the paragraph is set automatically.
|
void |
setStyle(Style value)
Sets the paragraph style applied to this formatting.
|
void |
setStyleIdentifier(int value)
Sets the locale independent style identifier of the paragraph style applied to this formatting.
|
void |
setStyleName(java.lang.String value)
Sets the name of the paragraph style applied to this formatting.
|
void |
setSuppressAutoHyphens(boolean value)
Specifies whether the current paragraph should be exempted from any hyphenation which is applied in the document settings.
|
void |
setSuppressLineNumbers(boolean value)
Specifies whether the current paragraph's lines should be exempted from line numbering which is applied in the parent section.
|
void |
setWidowControl(boolean value)
True if the first and last lines in the paragraph are to remain on the same page as the rest of the paragraph.
|
void |
setWordWrap(boolean value)
If this property is
false, Latin text in the middle of a word can be wrapped for the current paragraph. |
public void clearFormatting()
Remarks:
Default paragraph formatting is Normal style, left aligned, no indentation, no spacing, no borders and no shading.
Examples:
Shows how to nest a list inside another list.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// A list allows us to organize and decorate sets of paragraphs with prefix symbols and indents.
// We can create nested lists by increasing the indent level.
// We can begin and end a list by using a document builder's "ListFormat" property.
// Each paragraph that we add between a list's start and the end will become an item in the list.
// Create an outline list for the headings.
List outlineList = doc.getLists().add(ListTemplate.OUTLINE_NUMBERS);
builder.getListFormat().setList(outlineList);
builder.getParagraphFormat().setStyleIdentifier(StyleIdentifier.HEADING_1);
builder.writeln("This is my Chapter 1");
// Create a numbered list.
List numberedList = doc.getLists().add(ListTemplate.NUMBER_DEFAULT);
builder.getListFormat().setList(numberedList);
builder.getParagraphFormat().setStyleIdentifier(StyleIdentifier.NORMAL);
builder.writeln("Numbered list item 1.");
// Every paragraph that comprises a list will have this flag.
Assert.assertTrue(builder.getCurrentParagraph().isListItem());
Assert.assertTrue(builder.getParagraphFormat().isListItem());
// Create a bulleted list.
List bulletedList = doc.getLists().add(ListTemplate.BULLET_DEFAULT);
builder.getListFormat().setList(bulletedList);
builder.getParagraphFormat().setLeftIndent(72.0);
builder.writeln("Bulleted list item 1.");
builder.writeln("Bulleted list item 2.");
builder.getParagraphFormat().clearFormatting();
// Revert to the numbered list.
builder.getListFormat().setList(numberedList);
builder.writeln("Numbered list item 2.");
builder.writeln("Numbered list item 3.");
// Revert to the outline list.
builder.getListFormat().setList(outlineList);
builder.getParagraphFormat().setStyleIdentifier(StyleIdentifier.HEADING_1);
builder.writeln("This is my Chapter 2");
builder.getParagraphFormat().clearFormatting();
builder.getDocument().save(getArtifactsDir() + "Lists.NestedLists.docx");
public int getAlignment()
Examples:
Shows how to insert a paragraph into the document.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Font font = builder.getFont();
font.setSize(16.0);
font.setBold(true);
font.setColor(Color.BLUE);
font.setName("Arial");
font.setUnderline(Underline.DASH);
ParagraphFormat paragraphFormat = builder.getParagraphFormat();
paragraphFormat.setFirstLineIndent(8.0);
paragraphFormat.setAlignment(ParagraphAlignment.JUSTIFY);
paragraphFormat.setAddSpaceBetweenFarEastAndAlpha(true);
paragraphFormat.setAddSpaceBetweenFarEastAndDigit(true);
paragraphFormat.setKeepTogether(true);
// The "Writeln" method ends the paragraph after appending text
// and then starts a new line, adding a new paragraph.
builder.writeln("Hello world!");
Assert.assertTrue(builder.getCurrentParagraph().isEndOfDocument());
Shows how to construct an Aspose.Words document by hand.
Document doc = new Document();
// A blank document contains one section, one body and one paragraph.
// Call the "RemoveAllChildren" method to remove all those nodes,
// and end up with a document node with no children.
doc.removeAllChildren();
// This document now has no composite child nodes that we can add content to.
// If we wish to edit it, we will need to repopulate its node collection.
// First, create a new section, and then append it as a child to the root document node.
Section section = new Section(doc);
doc.appendChild(section);
// Set some page setup properties for the section.
section.getPageSetup().setSectionStart(SectionStart.NEW_PAGE);
section.getPageSetup().setPaperSize(PaperSize.LETTER);
// A section needs a body, which will contain and display all its contents
// on the page between the section's header and footer.
Body body = new Body(doc);
section.appendChild(body);
// Create a paragraph, set some formatting properties, and then append it as a child to the body.
Paragraph para = new Paragraph(doc);
para.getParagraphFormat().setStyleName("Heading 1");
para.getParagraphFormat().setAlignment(ParagraphAlignment.CENTER);
body.appendChild(para);
// Finally, add some content to do the document. Create a run,
// set its appearance and contents, and then append it as a child to the paragraph.
Run run = new Run(doc);
run.setText("Hello World!");
run.getFont().setColor(Color.RED);
para.appendChild(run);
Assert.assertEquals("Hello World!", doc.getText().trim());
doc.save(getArtifactsDir() + "Section.CreateManually.docx");
ParagraphAlignment constants.public void setAlignment(int value)
Examples:
Shows how to insert a paragraph into the document.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Font font = builder.getFont();
font.setSize(16.0);
font.setBold(true);
font.setColor(Color.BLUE);
font.setName("Arial");
font.setUnderline(Underline.DASH);
ParagraphFormat paragraphFormat = builder.getParagraphFormat();
paragraphFormat.setFirstLineIndent(8.0);
paragraphFormat.setAlignment(ParagraphAlignment.JUSTIFY);
paragraphFormat.setAddSpaceBetweenFarEastAndAlpha(true);
paragraphFormat.setAddSpaceBetweenFarEastAndDigit(true);
paragraphFormat.setKeepTogether(true);
// The "Writeln" method ends the paragraph after appending text
// and then starts a new line, adding a new paragraph.
builder.writeln("Hello world!");
Assert.assertTrue(builder.getCurrentParagraph().isEndOfDocument());
Shows how to construct an Aspose.Words document by hand.
Document doc = new Document();
// A blank document contains one section, one body and one paragraph.
// Call the "RemoveAllChildren" method to remove all those nodes,
// and end up with a document node with no children.
doc.removeAllChildren();
// This document now has no composite child nodes that we can add content to.
// If we wish to edit it, we will need to repopulate its node collection.
// First, create a new section, and then append it as a child to the root document node.
Section section = new Section(doc);
doc.appendChild(section);
// Set some page setup properties for the section.
section.getPageSetup().setSectionStart(SectionStart.NEW_PAGE);
section.getPageSetup().setPaperSize(PaperSize.LETTER);
// A section needs a body, which will contain and display all its contents
// on the page between the section's header and footer.
Body body = new Body(doc);
section.appendChild(body);
// Create a paragraph, set some formatting properties, and then append it as a child to the body.
Paragraph para = new Paragraph(doc);
para.getParagraphFormat().setStyleName("Heading 1");
para.getParagraphFormat().setAlignment(ParagraphAlignment.CENTER);
body.appendChild(para);
// Finally, add some content to do the document. Create a run,
// set its appearance and contents, and then append it as a child to the paragraph.
Run run = new Run(doc);
run.setText("Hello World!");
run.getFont().setColor(Color.RED);
para.appendChild(run);
Assert.assertEquals("Hello World!", doc.getText().trim());
doc.save(getArtifactsDir() + "Section.CreateManually.docx");
value - Text alignment for the paragraph. The value must be one of ParagraphAlignment constants.public int getBaselineAlignment()
Examples:
Shows how to set fonts vertical position on a line.
Document doc = new Document(getMyDir() + "Office math.docx");
ParagraphFormat format = doc.getFirstSection().getBody().getParagraphs().get(0).getParagraphFormat();
if (format.getBaselineAlignment() == BaselineAlignment.AUTO)
{
format.setBaselineAlignment(BaselineAlignment.TOP);
}
doc.save(getArtifactsDir() + "ParagraphFormat.ParagraphBaselineAlignment.docx");
BaselineAlignment constants.public void setBaselineAlignment(int value)
Examples:
Shows how to set fonts vertical position on a line.
Document doc = new Document(getMyDir() + "Office math.docx");
ParagraphFormat format = doc.getFirstSection().getBody().getParagraphs().get(0).getParagraphFormat();
if (format.getBaselineAlignment() == BaselineAlignment.AUTO)
{
format.setBaselineAlignment(BaselineAlignment.TOP);
}
doc.save(getArtifactsDir() + "ParagraphFormat.ParagraphBaselineAlignment.docx");
value - Fonts vertical position on a line. The value must be one of BaselineAlignment constants.public boolean getNoSpaceBetweenParagraphsOfSameStyle()
true, getSpaceBefore() / setSpaceBefore(double) and getSpaceAfter() / setSpaceAfter(double) will be ignored between the paragraphs of the same style.
Remarks:
This setting only takes affect when applied to a paragraph style. If applied to a paragraph directly, it has no effect.
Examples:
Shows how to apply no spacing between paragraphs with the same style.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Apply a large amount of spacing before and after paragraphs that this builder will create.
builder.getParagraphFormat().setSpaceBefore(24.0);
builder.getParagraphFormat().setSpaceAfter(24.0);
// Set the "NoSpaceBetweenParagraphsOfSameStyle" flag to "true" to apply
// no spacing between paragraphs with the same style, which will group similar paragraphs.
// Leave the "NoSpaceBetweenParagraphsOfSameStyle" flag as "false"
// to evenly apply spacing to every paragraph.
builder.getParagraphFormat().setNoSpaceBetweenParagraphsOfSameStyle(noSpaceBetweenParagraphsOfSameStyle);
builder.getParagraphFormat().setStyle(doc.getStyles().get("Normal"));
builder.writeln(MessageFormat.format("Paragraph in the \"{0}\" style.", builder.getParagraphFormat().getStyle().getName()));
builder.writeln(MessageFormat.format("Paragraph in the \"{0}\" style.", builder.getParagraphFormat().getStyle().getName()));
builder.writeln(MessageFormat.format("Paragraph in the \"{0}\" style.", builder.getParagraphFormat().getStyle().getName()));
builder.getParagraphFormat().setStyle(doc.getStyles().get("Quote"));
builder.writeln(MessageFormat.format("Paragraph in the \"{0}\" style.", builder.getParagraphFormat().getStyle().getName()));
builder.writeln(MessageFormat.format("Paragraph in the \"{0}\" style.", builder.getParagraphFormat().getStyle().getName()));
builder.getParagraphFormat().setStyle(doc.getStyles().get("Normal"));
builder.writeln(MessageFormat.format("Paragraph in the \"{0}\" style.", builder.getParagraphFormat().getStyle().getName()));
builder.writeln(MessageFormat.format("Paragraph in the \"{0}\" style.", builder.getParagraphFormat().getStyle().getName()));
doc.save(getArtifactsDir() + "ParagraphFormat.ParagraphSpacingSameStyle.docx");
boolean value.public void setNoSpaceBetweenParagraphsOfSameStyle(boolean value)
true, getSpaceBefore() / setSpaceBefore(double) and getSpaceAfter() / setSpaceAfter(double) will be ignored between the paragraphs of the same style.
Remarks:
This setting only takes affect when applied to a paragraph style. If applied to a paragraph directly, it has no effect.
Examples:
Shows how to apply no spacing between paragraphs with the same style.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Apply a large amount of spacing before and after paragraphs that this builder will create.
builder.getParagraphFormat().setSpaceBefore(24.0);
builder.getParagraphFormat().setSpaceAfter(24.0);
// Set the "NoSpaceBetweenParagraphsOfSameStyle" flag to "true" to apply
// no spacing between paragraphs with the same style, which will group similar paragraphs.
// Leave the "NoSpaceBetweenParagraphsOfSameStyle" flag as "false"
// to evenly apply spacing to every paragraph.
builder.getParagraphFormat().setNoSpaceBetweenParagraphsOfSameStyle(noSpaceBetweenParagraphsOfSameStyle);
builder.getParagraphFormat().setStyle(doc.getStyles().get("Normal"));
builder.writeln(MessageFormat.format("Paragraph in the \"{0}\" style.", builder.getParagraphFormat().getStyle().getName()));
builder.writeln(MessageFormat.format("Paragraph in the \"{0}\" style.", builder.getParagraphFormat().getStyle().getName()));
builder.writeln(MessageFormat.format("Paragraph in the \"{0}\" style.", builder.getParagraphFormat().getStyle().getName()));
builder.getParagraphFormat().setStyle(doc.getStyles().get("Quote"));
builder.writeln(MessageFormat.format("Paragraph in the \"{0}\" style.", builder.getParagraphFormat().getStyle().getName()));
builder.writeln(MessageFormat.format("Paragraph in the \"{0}\" style.", builder.getParagraphFormat().getStyle().getName()));
builder.getParagraphFormat().setStyle(doc.getStyles().get("Normal"));
builder.writeln(MessageFormat.format("Paragraph in the \"{0}\" style.", builder.getParagraphFormat().getStyle().getName()));
builder.writeln(MessageFormat.format("Paragraph in the \"{0}\" style.", builder.getParagraphFormat().getStyle().getName()));
doc.save(getArtifactsDir() + "ParagraphFormat.ParagraphSpacingSameStyle.docx");
value - The corresponding boolean value.public boolean getKeepTogether()
Examples:
Shows how to insert a paragraph into the document.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Font font = builder.getFont();
font.setSize(16.0);
font.setBold(true);
font.setColor(Color.BLUE);
font.setName("Arial");
font.setUnderline(Underline.DASH);
ParagraphFormat paragraphFormat = builder.getParagraphFormat();
paragraphFormat.setFirstLineIndent(8.0);
paragraphFormat.setAlignment(ParagraphAlignment.JUSTIFY);
paragraphFormat.setAddSpaceBetweenFarEastAndAlpha(true);
paragraphFormat.setAddSpaceBetweenFarEastAndDigit(true);
paragraphFormat.setKeepTogether(true);
// The "Writeln" method ends the paragraph after appending text
// and then starts a new line, adding a new paragraph.
builder.writeln("Hello world!");
Assert.assertTrue(builder.getCurrentParagraph().isEndOfDocument());
boolean value.public void setKeepTogether(boolean value)
Examples:
Shows how to insert a paragraph into the document.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Font font = builder.getFont();
font.setSize(16.0);
font.setBold(true);
font.setColor(Color.BLUE);
font.setName("Arial");
font.setUnderline(Underline.DASH);
ParagraphFormat paragraphFormat = builder.getParagraphFormat();
paragraphFormat.setFirstLineIndent(8.0);
paragraphFormat.setAlignment(ParagraphAlignment.JUSTIFY);
paragraphFormat.setAddSpaceBetweenFarEastAndAlpha(true);
paragraphFormat.setAddSpaceBetweenFarEastAndDigit(true);
paragraphFormat.setKeepTogether(true);
// The "Writeln" method ends the paragraph after appending text
// and then starts a new line, adding a new paragraph.
builder.writeln("Hello world!");
Assert.assertTrue(builder.getCurrentParagraph().isEndOfDocument());
value - The corresponding boolean value.public boolean getKeepWithNext()
Examples:
Shows how to set a table to stay together on the same page.
Document doc = new Document(getMyDir() + "Table spanning two pages.docx");
Table table = doc.getFirstSection().getBody().getTables().get(0);
// Enabling KeepWithNext for every paragraph in the table except for the
// last ones in the last row will prevent the table from splitting across multiple pages.
for (Cell cell : (Iterable<Cell>) table.getChildNodes(NodeType.CELL, true))
for (Paragraph para : cell.getParagraphs()) {
Assert.assertTrue(para.isInCell());
if (!(cell.getParentRow().isLastRow() && para.isEndOfCell()))
para.getParagraphFormat().setKeepWithNext(true);
}
doc.save(getArtifactsDir() + "Table.KeepTableTogether.docx");
boolean value.public void setKeepWithNext(boolean value)
Examples:
Shows how to set a table to stay together on the same page.
Document doc = new Document(getMyDir() + "Table spanning two pages.docx");
Table table = doc.getFirstSection().getBody().getTables().get(0);
// Enabling KeepWithNext for every paragraph in the table except for the
// last ones in the last row will prevent the table from splitting across multiple pages.
for (Cell cell : (Iterable<Cell>) table.getChildNodes(NodeType.CELL, true))
for (Paragraph para : cell.getParagraphs()) {
Assert.assertTrue(para.isInCell());
if (!(cell.getParentRow().isLastRow() && para.isEndOfCell()))
para.getParagraphFormat().setKeepWithNext(true);
}
doc.save(getArtifactsDir() + "Table.KeepTableTogether.docx");
value - The corresponding boolean value.public boolean getPageBreakBefore()
Examples:
Shows how to create paragraphs with page breaks at the beginning.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Set this flag to "true" to apply a page break to each paragraph's beginning
// that the document builder will create under this ParagraphFormat configuration.
// The first paragraph will not receive a page break.
// Leave this flag as "false" to start each new paragraph on the same page
// as the previous, provided there is sufficient space.
builder.getParagraphFormat().setPageBreakBefore(pageBreakBefore);
builder.writeln("Paragraph 1.");
builder.writeln("Paragraph 2.");
LayoutCollector layoutCollector = new LayoutCollector(doc);
ParagraphCollection paragraphs = doc.getFirstSection().getBody().getParagraphs();
if (pageBreakBefore) {
Assert.assertEquals(1, layoutCollector.getStartPageIndex(paragraphs.get(0)));
Assert.assertEquals(2, layoutCollector.getStartPageIndex(paragraphs.get(1)));
} else {
Assert.assertEquals(1, layoutCollector.getStartPageIndex(paragraphs.get(0)));
Assert.assertEquals(1, layoutCollector.getStartPageIndex(paragraphs.get(1)));
}
doc.save(getArtifactsDir() + "ParagraphFormat.PageBreakBefore.docx");
boolean value.public void setPageBreakBefore(boolean value)
Examples:
Shows how to create paragraphs with page breaks at the beginning.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Set this flag to "true" to apply a page break to each paragraph's beginning
// that the document builder will create under this ParagraphFormat configuration.
// The first paragraph will not receive a page break.
// Leave this flag as "false" to start each new paragraph on the same page
// as the previous, provided there is sufficient space.
builder.getParagraphFormat().setPageBreakBefore(pageBreakBefore);
builder.writeln("Paragraph 1.");
builder.writeln("Paragraph 2.");
LayoutCollector layoutCollector = new LayoutCollector(doc);
ParagraphCollection paragraphs = doc.getFirstSection().getBody().getParagraphs();
if (pageBreakBefore) {
Assert.assertEquals(1, layoutCollector.getStartPageIndex(paragraphs.get(0)));
Assert.assertEquals(2, layoutCollector.getStartPageIndex(paragraphs.get(1)));
} else {
Assert.assertEquals(1, layoutCollector.getStartPageIndex(paragraphs.get(0)));
Assert.assertEquals(1, layoutCollector.getStartPageIndex(paragraphs.get(1)));
}
doc.save(getArtifactsDir() + "ParagraphFormat.PageBreakBefore.docx");
value - The corresponding boolean value.public boolean getSuppressLineNumbers()
Examples:
Shows how to enable line numbering for a section.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// We can use the section's PageSetup object to display numbers to the left of the section's text lines.
// This is the same behavior as a List object,
// but it covers the entire section and does not modify the text in any way.
// Our section will restart the numbering on each new page from 1 and display the number,
// if it is a multiple of 3, at 50pt to the left of the line.
PageSetup pageSetup = builder.getPageSetup();
pageSetup.setLineStartingNumber(1);
pageSetup.setLineNumberCountBy(3);
pageSetup.setLineNumberRestartMode(LineNumberRestartMode.RESTART_PAGE);
pageSetup.setLineNumberDistanceFromText(50.0d);
for (int i = 1; i <= 25; i++)
builder.writeln(MessageFormat.format("Line {0}.", i));
// The line counter will skip any paragraph with the "SuppressLineNumbers" flag set to "true".
// This paragraph is on the 15th line, which is a multiple of 3, and thus would normally display a line number.
// The section's line counter will also ignore this line, treat the next line as the 15th,
// and continue the count from that point onward.
doc.getFirstSection().getBody().getParagraphs().get(14).getParagraphFormat().setSuppressLineNumbers(true);
doc.save(getArtifactsDir() + "PageSetup.LineNumbers.docx");
boolean value.public void setSuppressLineNumbers(boolean value)
Examples:
Shows how to enable line numbering for a section.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// We can use the section's PageSetup object to display numbers to the left of the section's text lines.
// This is the same behavior as a List object,
// but it covers the entire section and does not modify the text in any way.
// Our section will restart the numbering on each new page from 1 and display the number,
// if it is a multiple of 3, at 50pt to the left of the line.
PageSetup pageSetup = builder.getPageSetup();
pageSetup.setLineStartingNumber(1);
pageSetup.setLineNumberCountBy(3);
pageSetup.setLineNumberRestartMode(LineNumberRestartMode.RESTART_PAGE);
pageSetup.setLineNumberDistanceFromText(50.0d);
for (int i = 1; i <= 25; i++)
builder.writeln(MessageFormat.format("Line {0}.", i));
// The line counter will skip any paragraph with the "SuppressLineNumbers" flag set to "true".
// This paragraph is on the 15th line, which is a multiple of 3, and thus would normally display a line number.
// The section's line counter will also ignore this line, treat the next line as the 15th,
// and continue the count from that point onward.
doc.getFirstSection().getBody().getParagraphs().get(14).getParagraphFormat().setSuppressLineNumbers(true);
doc.save(getArtifactsDir() + "PageSetup.LineNumbers.docx");
value - The corresponding boolean value.public boolean getSuppressAutoHyphens()
Examples:
Shows how to suppress hyphenation for a paragraph.
Hyphenation.registerDictionary("de-CH", getMyDir() + "hyph_de_CH.dic");
Assert.assertTrue(Hyphenation.isDictionaryRegistered("de-CH"));
// Open a document containing text with a locale matching that of our dictionary.
// When we save this document to a fixed page save format, its text will have hyphenation.
Document doc = new Document(getMyDir() + "German text.docx");
// We can set the "SuppressAutoHyphens" property to "true" to disable hyphenation
// for a specific paragraph while keeping it enabled for the rest of the document.
// The default value for this property is "false",
// which means every paragraph by default uses hyphenation if any is available.
doc.getFirstSection().getBody().getFirstParagraph().getParagraphFormat().setSuppressAutoHyphens(suppressAutoHyphens);
doc.save(getArtifactsDir() + "ParagraphFormat.SuppressHyphens.pdf");
boolean value.public void setSuppressAutoHyphens(boolean value)
Examples:
Shows how to suppress hyphenation for a paragraph.
Hyphenation.registerDictionary("de-CH", getMyDir() + "hyph_de_CH.dic");
Assert.assertTrue(Hyphenation.isDictionaryRegistered("de-CH"));
// Open a document containing text with a locale matching that of our dictionary.
// When we save this document to a fixed page save format, its text will have hyphenation.
Document doc = new Document(getMyDir() + "German text.docx");
// We can set the "SuppressAutoHyphens" property to "true" to disable hyphenation
// for a specific paragraph while keeping it enabled for the rest of the document.
// The default value for this property is "false",
// which means every paragraph by default uses hyphenation if any is available.
doc.getFirstSection().getBody().getFirstParagraph().getParagraphFormat().setSuppressAutoHyphens(suppressAutoHyphens);
doc.save(getArtifactsDir() + "ParagraphFormat.SuppressHyphens.pdf");
value - The corresponding boolean value.public boolean getWidowControl()
Examples:
Shows how to enable widow/orphan control for a paragraph.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// When we write the text that does not fit onto one page, one line may spill over onto the next page.
// The single line that ends up on the next page is called an "Orphan",
// and the previous line where the orphan broke off is called a "Widow".
// We can fix orphans and widows by rearranging text via font size, spacing, or page margins.
// If we wish to preserve our document's dimensions, we can set this flag to "true"
// to push widows onto the same page as their respective orphans.
// Leave this flag as "false" will leave widow/orphan pairs in text.
// Every paragraph has this setting accessible in Microsoft Word via Home -> Paragraph -> Paragraph Settings
// (button on bottom right hand corner of "Paragraph" tab) -> "Widow/Orphan control".
builder.getParagraphFormat().setWidowControl(widowControl);
// Insert text that produces an orphan and a widow.
builder.getFont().setSize(68.0);
builder.write("Lorem ipsum dolor sit amet, consectetur adipiscing elit, " +
"sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.");
doc.save(getArtifactsDir() + "ParagraphFormat.WidowControl.docx");
boolean value.public void setWidowControl(boolean value)
Examples:
Shows how to enable widow/orphan control for a paragraph.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// When we write the text that does not fit onto one page, one line may spill over onto the next page.
// The single line that ends up on the next page is called an "Orphan",
// and the previous line where the orphan broke off is called a "Widow".
// We can fix orphans and widows by rearranging text via font size, spacing, or page margins.
// If we wish to preserve our document's dimensions, we can set this flag to "true"
// to push widows onto the same page as their respective orphans.
// Leave this flag as "false" will leave widow/orphan pairs in text.
// Every paragraph has this setting accessible in Microsoft Word via Home -> Paragraph -> Paragraph Settings
// (button on bottom right hand corner of "Paragraph" tab) -> "Widow/Orphan control".
builder.getParagraphFormat().setWidowControl(widowControl);
// Insert text that produces an orphan and a widow.
builder.getFont().setSize(68.0);
builder.write("Lorem ipsum dolor sit amet, consectetur adipiscing elit, " +
"sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.");
doc.save(getArtifactsDir() + "ParagraphFormat.WidowControl.docx");
value - The corresponding boolean value.public boolean getAddSpaceBetweenFarEastAndAlpha()
Examples:
Shows how to insert a paragraph into the document.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Font font = builder.getFont();
font.setSize(16.0);
font.setBold(true);
font.setColor(Color.BLUE);
font.setName("Arial");
font.setUnderline(Underline.DASH);
ParagraphFormat paragraphFormat = builder.getParagraphFormat();
paragraphFormat.setFirstLineIndent(8.0);
paragraphFormat.setAlignment(ParagraphAlignment.JUSTIFY);
paragraphFormat.setAddSpaceBetweenFarEastAndAlpha(true);
paragraphFormat.setAddSpaceBetweenFarEastAndDigit(true);
paragraphFormat.setKeepTogether(true);
// The "Writeln" method ends the paragraph after appending text
// and then starts a new line, adding a new paragraph.
builder.writeln("Hello world!");
Assert.assertTrue(builder.getCurrentParagraph().isEndOfDocument());
public void setAddSpaceBetweenFarEastAndAlpha(boolean value)
Examples:
Shows how to insert a paragraph into the document.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Font font = builder.getFont();
font.setSize(16.0);
font.setBold(true);
font.setColor(Color.BLUE);
font.setName("Arial");
font.setUnderline(Underline.DASH);
ParagraphFormat paragraphFormat = builder.getParagraphFormat();
paragraphFormat.setFirstLineIndent(8.0);
paragraphFormat.setAlignment(ParagraphAlignment.JUSTIFY);
paragraphFormat.setAddSpaceBetweenFarEastAndAlpha(true);
paragraphFormat.setAddSpaceBetweenFarEastAndDigit(true);
paragraphFormat.setKeepTogether(true);
// The "Writeln" method ends the paragraph after appending text
// and then starts a new line, adding a new paragraph.
builder.writeln("Hello world!");
Assert.assertTrue(builder.getCurrentParagraph().isEndOfDocument());
value - A flag indicating whether inter-character spacing is automatically adjusted between regions of Latin text and regions of East Asian text in the current paragraph.public boolean getAddSpaceBetweenFarEastAndDigit()
Examples:
Shows how to insert a paragraph into the document.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Font font = builder.getFont();
font.setSize(16.0);
font.setBold(true);
font.setColor(Color.BLUE);
font.setName("Arial");
font.setUnderline(Underline.DASH);
ParagraphFormat paragraphFormat = builder.getParagraphFormat();
paragraphFormat.setFirstLineIndent(8.0);
paragraphFormat.setAlignment(ParagraphAlignment.JUSTIFY);
paragraphFormat.setAddSpaceBetweenFarEastAndAlpha(true);
paragraphFormat.setAddSpaceBetweenFarEastAndDigit(true);
paragraphFormat.setKeepTogether(true);
// The "Writeln" method ends the paragraph after appending text
// and then starts a new line, adding a new paragraph.
builder.writeln("Hello world!");
Assert.assertTrue(builder.getCurrentParagraph().isEndOfDocument());
public void setAddSpaceBetweenFarEastAndDigit(boolean value)
Examples:
Shows how to insert a paragraph into the document.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Font font = builder.getFont();
font.setSize(16.0);
font.setBold(true);
font.setColor(Color.BLUE);
font.setName("Arial");
font.setUnderline(Underline.DASH);
ParagraphFormat paragraphFormat = builder.getParagraphFormat();
paragraphFormat.setFirstLineIndent(8.0);
paragraphFormat.setAlignment(ParagraphAlignment.JUSTIFY);
paragraphFormat.setAddSpaceBetweenFarEastAndAlpha(true);
paragraphFormat.setAddSpaceBetweenFarEastAndDigit(true);
paragraphFormat.setKeepTogether(true);
// The "Writeln" method ends the paragraph after appending text
// and then starts a new line, adding a new paragraph.
builder.writeln("Hello world!");
Assert.assertTrue(builder.getCurrentParagraph().isEndOfDocument());
value - A flag indicating whether inter-character spacing is automatically adjusted between regions of numbers and regions of East Asian text in the current paragraph.public boolean getFarEastLineBreakControl()
Examples:
Shows how to set special properties for Asian typography.
Document doc = new Document(getMyDir() + "Document.docx");
ParagraphFormat format = doc.getFirstSection().getBody().getFirstParagraph().getParagraphFormat();
format.setFarEastLineBreakControl(true);
format.setWordWrap(false);
format.setHangingPunctuation(true);
doc.save(getArtifactsDir() + "ParagraphFormat.AsianTypographyProperties.docx");
public void setFarEastLineBreakControl(boolean value)
Examples:
Shows how to set special properties for Asian typography.
Document doc = new Document(getMyDir() + "Document.docx");
ParagraphFormat format = doc.getFirstSection().getBody().getFirstParagraph().getParagraphFormat();
format.setFarEastLineBreakControl(true);
format.setWordWrap(false);
format.setHangingPunctuation(true);
doc.save(getArtifactsDir() + "ParagraphFormat.AsianTypographyProperties.docx");
value - A flag indicating whether East Asian line-breaking rules are applied to the current paragraph.public boolean getWordWrap()
false, Latin text in the middle of a word can be wrapped for the current paragraph. Otherwise Latin text is wrapped by whole words.
Examples:
Shows how to set special properties for Asian typography.
Document doc = new Document(getMyDir() + "Document.docx");
ParagraphFormat format = doc.getFirstSection().getBody().getFirstParagraph().getParagraphFormat();
format.setFarEastLineBreakControl(true);
format.setWordWrap(false);
format.setHangingPunctuation(true);
doc.save(getArtifactsDir() + "ParagraphFormat.AsianTypographyProperties.docx");
boolean value.public void setWordWrap(boolean value)
false, Latin text in the middle of a word can be wrapped for the current paragraph. Otherwise Latin text is wrapped by whole words.
Examples:
Shows how to set special properties for Asian typography.
Document doc = new Document(getMyDir() + "Document.docx");
ParagraphFormat format = doc.getFirstSection().getBody().getFirstParagraph().getParagraphFormat();
format.setFarEastLineBreakControl(true);
format.setWordWrap(false);
format.setHangingPunctuation(true);
doc.save(getArtifactsDir() + "ParagraphFormat.AsianTypographyProperties.docx");
value - The corresponding boolean value.public boolean getHangingPunctuation()
Examples:
Shows how to set special properties for Asian typography.
Document doc = new Document(getMyDir() + "Document.docx");
ParagraphFormat format = doc.getFirstSection().getBody().getFirstParagraph().getParagraphFormat();
format.setFarEastLineBreakControl(true);
format.setWordWrap(false);
format.setHangingPunctuation(true);
doc.save(getArtifactsDir() + "ParagraphFormat.AsianTypographyProperties.docx");
public void setHangingPunctuation(boolean value)
Examples:
Shows how to set special properties for Asian typography.
Document doc = new Document(getMyDir() + "Document.docx");
ParagraphFormat format = doc.getFirstSection().getBody().getFirstParagraph().getParagraphFormat();
format.setFarEastLineBreakControl(true);
format.setWordWrap(false);
format.setHangingPunctuation(true);
doc.save(getArtifactsDir() + "ParagraphFormat.AsianTypographyProperties.docx");
value - A flag indicating whether hanging punctuation is enabled for the current paragraph.public boolean getBidi()
Remarks:
When true, the runs and other inline objects in this paragraph are laid out right to left.
Examples:
Shows how to detect plaintext document text direction.
// Create a "TxtLoadOptions" object, which we can pass to a document's constructor
// to modify how we load a plaintext document.
TxtLoadOptions loadOptions = new TxtLoadOptions();
// Set the "DocumentDirection" property to "DocumentDirection.Auto" automatically detects
// the direction of every paragraph of text that Aspose.Words loads from plaintext.
// Each paragraph's "Bidi" property will store its direction.
loadOptions.setDocumentDirection(DocumentDirection.AUTO);
// Detect Hebrew text as right-to-left.
Document doc = new Document(getMyDir() + "Hebrew text.txt", loadOptions);
Assert.assertTrue(doc.getFirstSection().getBody().getFirstParagraph().getParagraphFormat().getBidi());
// Detect English text as right-to-left.
doc = new Document(getMyDir() + "English text.txt", loadOptions);
Assert.assertFalse(doc.getFirstSection().getBody().getFirstParagraph().getParagraphFormat().getBidi());
Shows how to create right-to-left language-compatible lists with BIDIOUTLINE fields.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// The BIDIOUTLINE field numbers paragraphs like the AUTONUM/LISTNUM fields,
// but is only visible when a right-to-left editing language is enabled, such as Hebrew or Arabic.
// The following field will display ".1", the RTL equivalent of list number "1.".
FieldBidiOutline field = (FieldBidiOutline) builder.insertField(FieldType.FIELD_BIDI_OUTLINE, true);
builder.writeln("שלום");
Assert.assertEquals(" BIDIOUTLINE ", field.getFieldCode());
// Add two more BIDIOUTLINE fields, which will display ".2" and ".3".
builder.insertField(FieldType.FIELD_BIDI_OUTLINE, true);
builder.writeln("שלום");
builder.insertField(FieldType.FIELD_BIDI_OUTLINE, true);
builder.writeln("שלום");
// Set the horizontal text alignment for every paragraph in the document to RTL.
for (Paragraph para : (Iterable<Paragraph>) doc.getChildNodes(NodeType.PARAGRAPH, true)) {
para.getParagraphFormat().setBidi(true);
}
// If we enable a right-to-left editing language in Microsoft Word, our fields will display numbers.
// Otherwise, they will display "###".
doc.save(getArtifactsDir() + "Field.BIDIOUTLINE.docx");
public void setBidi(boolean value)
Remarks:
When true, the runs and other inline objects in this paragraph are laid out right to left.
Examples:
Shows how to detect plaintext document text direction.
// Create a "TxtLoadOptions" object, which we can pass to a document's constructor
// to modify how we load a plaintext document.
TxtLoadOptions loadOptions = new TxtLoadOptions();
// Set the "DocumentDirection" property to "DocumentDirection.Auto" automatically detects
// the direction of every paragraph of text that Aspose.Words loads from plaintext.
// Each paragraph's "Bidi" property will store its direction.
loadOptions.setDocumentDirection(DocumentDirection.AUTO);
// Detect Hebrew text as right-to-left.
Document doc = new Document(getMyDir() + "Hebrew text.txt", loadOptions);
Assert.assertTrue(doc.getFirstSection().getBody().getFirstParagraph().getParagraphFormat().getBidi());
// Detect English text as right-to-left.
doc = new Document(getMyDir() + "English text.txt", loadOptions);
Assert.assertFalse(doc.getFirstSection().getBody().getFirstParagraph().getParagraphFormat().getBidi());
Shows how to create right-to-left language-compatible lists with BIDIOUTLINE fields.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// The BIDIOUTLINE field numbers paragraphs like the AUTONUM/LISTNUM fields,
// but is only visible when a right-to-left editing language is enabled, such as Hebrew or Arabic.
// The following field will display ".1", the RTL equivalent of list number "1.".
FieldBidiOutline field = (FieldBidiOutline) builder.insertField(FieldType.FIELD_BIDI_OUTLINE, true);
builder.writeln("שלום");
Assert.assertEquals(" BIDIOUTLINE ", field.getFieldCode());
// Add two more BIDIOUTLINE fields, which will display ".2" and ".3".
builder.insertField(FieldType.FIELD_BIDI_OUTLINE, true);
builder.writeln("שלום");
builder.insertField(FieldType.FIELD_BIDI_OUTLINE, true);
builder.writeln("שלום");
// Set the horizontal text alignment for every paragraph in the document to RTL.
for (Paragraph para : (Iterable<Paragraph>) doc.getChildNodes(NodeType.PARAGRAPH, true)) {
para.getParagraphFormat().setBidi(true);
}
// If we enable a right-to-left editing language in Microsoft Word, our fields will display numbers.
// Otherwise, they will display "###".
doc.save(getArtifactsDir() + "Field.BIDIOUTLINE.docx");
value - Whether this is a right-to-left paragraph.public double getLeftIndent()
Examples:
Shows how to configure paragraph formatting to create off-center text.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Center all text that the document builder writes, and set up indents.
// The indent configuration below will create a body of text that will sit asymmetrically on the page.
// The "center" that we align the text to will be the middle of the body of text, not the middle of the page.
ParagraphFormat paragraphFormat = builder.getParagraphFormat();
paragraphFormat.setAlignment(ParagraphAlignment.CENTER);
paragraphFormat.setLeftIndent(100.0);
paragraphFormat.setRightIndent(50.0);
paragraphFormat.setSpaceAfter(25.0);
builder.writeln(
"This paragraph demonstrates how left and right indentation affects word wrapping.");
builder.writeln(
"The space between the above paragraph and this one depends on the DocumentBuilder's paragraph format.");
doc.save(getArtifactsDir() + "DocumentBuilder.SetParagraphFormatting.docx");
public void setLeftIndent(double value)
Examples:
Shows how to configure paragraph formatting to create off-center text.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Center all text that the document builder writes, and set up indents.
// The indent configuration below will create a body of text that will sit asymmetrically on the page.
// The "center" that we align the text to will be the middle of the body of text, not the middle of the page.
ParagraphFormat paragraphFormat = builder.getParagraphFormat();
paragraphFormat.setAlignment(ParagraphAlignment.CENTER);
paragraphFormat.setLeftIndent(100.0);
paragraphFormat.setRightIndent(50.0);
paragraphFormat.setSpaceAfter(25.0);
builder.writeln(
"This paragraph demonstrates how left and right indentation affects word wrapping.");
builder.writeln(
"The space between the above paragraph and this one depends on the DocumentBuilder's paragraph format.");
doc.save(getArtifactsDir() + "DocumentBuilder.SetParagraphFormatting.docx");
value - The value (in points) that represents the left indent for paragraph.public double getCharacterUnitLeftIndent()
Examples:
Shows how to change paragraph spacing and indents.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
ParagraphFormat format = doc.getFirstSection().getBody().getFirstParagraph().getParagraphFormat();
// Below are five different spacing options, along with the properties that their configuration indirectly affects.
// 1 - Left indent:
Assert.assertEquals(format.getLeftIndent(), 0.0d);
format.setCharacterUnitLeftIndent(10.0);
Assert.assertEquals(format.getLeftIndent(), 120.0d);
// 2 - Right indent:
Assert.assertEquals(format.getRightIndent(), 0.0d);
format.setCharacterUnitRightIndent(-5.5);
Assert.assertEquals(format.getRightIndent(), -66.0d);
// 3 - Hanging indent:
Assert.assertEquals(format.getFirstLineIndent(), 0.0d);
format.setCharacterUnitFirstLineIndent(20.3);
Assert.assertEquals(format.getFirstLineIndent(), 243.59d, 0.1d);
// 4 - Line spacing before paragraphs:
Assert.assertEquals(format.getSpaceBefore(), 0.0d);
format.setLineUnitBefore(5.1);
Assert.assertEquals(format.getSpaceBefore(), 61.1d, 0.1d);
// 5 - Line spacing after paragraphs:
Assert.assertEquals(format.getSpaceAfter(), 0.0d);
format.setLineUnitAfter(10.9);
Assert.assertEquals(format.getSpaceAfter(), 130.8d, 0.1d);
builder.writeln("Lorem ipsum dolor sit amet, consectetur adipiscing elit, " +
"sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.");
builder.write("测试文档测试文档测试文档测试文档测试文档测试文档测试文档测试文档测试" +
"文档测试文档测试文档测试文档测试文档测试文档测试文档测试文档测试文档测试文档");
public void setCharacterUnitLeftIndent(double value)
Examples:
Shows how to change paragraph spacing and indents.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
ParagraphFormat format = doc.getFirstSection().getBody().getFirstParagraph().getParagraphFormat();
// Below are five different spacing options, along with the properties that their configuration indirectly affects.
// 1 - Left indent:
Assert.assertEquals(format.getLeftIndent(), 0.0d);
format.setCharacterUnitLeftIndent(10.0);
Assert.assertEquals(format.getLeftIndent(), 120.0d);
// 2 - Right indent:
Assert.assertEquals(format.getRightIndent(), 0.0d);
format.setCharacterUnitRightIndent(-5.5);
Assert.assertEquals(format.getRightIndent(), -66.0d);
// 3 - Hanging indent:
Assert.assertEquals(format.getFirstLineIndent(), 0.0d);
format.setCharacterUnitFirstLineIndent(20.3);
Assert.assertEquals(format.getFirstLineIndent(), 243.59d, 0.1d);
// 4 - Line spacing before paragraphs:
Assert.assertEquals(format.getSpaceBefore(), 0.0d);
format.setLineUnitBefore(5.1);
Assert.assertEquals(format.getSpaceBefore(), 61.1d, 0.1d);
// 5 - Line spacing after paragraphs:
Assert.assertEquals(format.getSpaceAfter(), 0.0d);
format.setLineUnitAfter(10.9);
Assert.assertEquals(format.getSpaceAfter(), 130.8d, 0.1d);
builder.writeln("Lorem ipsum dolor sit amet, consectetur adipiscing elit, " +
"sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.");
builder.write("测试文档测试文档测试文档测试文档测试文档测试文档测试文档测试文档测试" +
"文档测试文档测试文档测试文档测试文档测试文档测试文档测试文档测试文档测试文档");
value - The left indent value (in characters) for the specified paragraphs.public double getRightIndent()
Examples:
Shows how to configure paragraph formatting to create off-center text.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Center all text that the document builder writes, and set up indents.
// The indent configuration below will create a body of text that will sit asymmetrically on the page.
// The "center" that we align the text to will be the middle of the body of text, not the middle of the page.
ParagraphFormat paragraphFormat = builder.getParagraphFormat();
paragraphFormat.setAlignment(ParagraphAlignment.CENTER);
paragraphFormat.setLeftIndent(100.0);
paragraphFormat.setRightIndent(50.0);
paragraphFormat.setSpaceAfter(25.0);
builder.writeln(
"This paragraph demonstrates how left and right indentation affects word wrapping.");
builder.writeln(
"The space between the above paragraph and this one depends on the DocumentBuilder's paragraph format.");
doc.save(getArtifactsDir() + "DocumentBuilder.SetParagraphFormatting.docx");
public void setRightIndent(double value)
Examples:
Shows how to configure paragraph formatting to create off-center text.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Center all text that the document builder writes, and set up indents.
// The indent configuration below will create a body of text that will sit asymmetrically on the page.
// The "center" that we align the text to will be the middle of the body of text, not the middle of the page.
ParagraphFormat paragraphFormat = builder.getParagraphFormat();
paragraphFormat.setAlignment(ParagraphAlignment.CENTER);
paragraphFormat.setLeftIndent(100.0);
paragraphFormat.setRightIndent(50.0);
paragraphFormat.setSpaceAfter(25.0);
builder.writeln(
"This paragraph demonstrates how left and right indentation affects word wrapping.");
builder.writeln(
"The space between the above paragraph and this one depends on the DocumentBuilder's paragraph format.");
doc.save(getArtifactsDir() + "DocumentBuilder.SetParagraphFormatting.docx");
value - The value (in points) that represents the right indent for paragraph.public double getCharacterUnitRightIndent()
Examples:
Shows how to change paragraph spacing and indents.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
ParagraphFormat format = doc.getFirstSection().getBody().getFirstParagraph().getParagraphFormat();
// Below are five different spacing options, along with the properties that their configuration indirectly affects.
// 1 - Left indent:
Assert.assertEquals(format.getLeftIndent(), 0.0d);
format.setCharacterUnitLeftIndent(10.0);
Assert.assertEquals(format.getLeftIndent(), 120.0d);
// 2 - Right indent:
Assert.assertEquals(format.getRightIndent(), 0.0d);
format.setCharacterUnitRightIndent(-5.5);
Assert.assertEquals(format.getRightIndent(), -66.0d);
// 3 - Hanging indent:
Assert.assertEquals(format.getFirstLineIndent(), 0.0d);
format.setCharacterUnitFirstLineIndent(20.3);
Assert.assertEquals(format.getFirstLineIndent(), 243.59d, 0.1d);
// 4 - Line spacing before paragraphs:
Assert.assertEquals(format.getSpaceBefore(), 0.0d);
format.setLineUnitBefore(5.1);
Assert.assertEquals(format.getSpaceBefore(), 61.1d, 0.1d);
// 5 - Line spacing after paragraphs:
Assert.assertEquals(format.getSpaceAfter(), 0.0d);
format.setLineUnitAfter(10.9);
Assert.assertEquals(format.getSpaceAfter(), 130.8d, 0.1d);
builder.writeln("Lorem ipsum dolor sit amet, consectetur adipiscing elit, " +
"sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.");
builder.write("测试文档测试文档测试文档测试文档测试文档测试文档测试文档测试文档测试" +
"文档测试文档测试文档测试文档测试文档测试文档测试文档测试文档测试文档测试文档");
public void setCharacterUnitRightIndent(double value)
Examples:
Shows how to change paragraph spacing and indents.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
ParagraphFormat format = doc.getFirstSection().getBody().getFirstParagraph().getParagraphFormat();
// Below are five different spacing options, along with the properties that their configuration indirectly affects.
// 1 - Left indent:
Assert.assertEquals(format.getLeftIndent(), 0.0d);
format.setCharacterUnitLeftIndent(10.0);
Assert.assertEquals(format.getLeftIndent(), 120.0d);
// 2 - Right indent:
Assert.assertEquals(format.getRightIndent(), 0.0d);
format.setCharacterUnitRightIndent(-5.5);
Assert.assertEquals(format.getRightIndent(), -66.0d);
// 3 - Hanging indent:
Assert.assertEquals(format.getFirstLineIndent(), 0.0d);
format.setCharacterUnitFirstLineIndent(20.3);
Assert.assertEquals(format.getFirstLineIndent(), 243.59d, 0.1d);
// 4 - Line spacing before paragraphs:
Assert.assertEquals(format.getSpaceBefore(), 0.0d);
format.setLineUnitBefore(5.1);
Assert.assertEquals(format.getSpaceBefore(), 61.1d, 0.1d);
// 5 - Line spacing after paragraphs:
Assert.assertEquals(format.getSpaceAfter(), 0.0d);
format.setLineUnitAfter(10.9);
Assert.assertEquals(format.getSpaceAfter(), 130.8d, 0.1d);
builder.writeln("Lorem ipsum dolor sit amet, consectetur adipiscing elit, " +
"sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.");
builder.write("测试文档测试文档测试文档测试文档测试文档测试文档测试文档测试文档测试" +
"文档测试文档测试文档测试文档测试文档测试文档测试文档测试文档测试文档测试文档");
value - The right indent value (in characters) for the specified paragraphs.public double getFirstLineIndent()
Use positive values to set the first-line indent, and negative values to set the hanging indent.
Examples:
Shows how to insert a paragraph into the document.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Font font = builder.getFont();
font.setSize(16.0);
font.setBold(true);
font.setColor(Color.BLUE);
font.setName("Arial");
font.setUnderline(Underline.DASH);
ParagraphFormat paragraphFormat = builder.getParagraphFormat();
paragraphFormat.setFirstLineIndent(8.0);
paragraphFormat.setAlignment(ParagraphAlignment.JUSTIFY);
paragraphFormat.setAddSpaceBetweenFarEastAndAlpha(true);
paragraphFormat.setAddSpaceBetweenFarEastAndDigit(true);
paragraphFormat.setKeepTogether(true);
// The "Writeln" method ends the paragraph after appending text
// and then starts a new line, adding a new paragraph.
builder.writeln("Hello world!");
Assert.assertTrue(builder.getCurrentParagraph().isEndOfDocument());
public void setFirstLineIndent(double value)
Use positive values to set the first-line indent, and negative values to set the hanging indent.
Examples:
Shows how to insert a paragraph into the document.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Font font = builder.getFont();
font.setSize(16.0);
font.setBold(true);
font.setColor(Color.BLUE);
font.setName("Arial");
font.setUnderline(Underline.DASH);
ParagraphFormat paragraphFormat = builder.getParagraphFormat();
paragraphFormat.setFirstLineIndent(8.0);
paragraphFormat.setAlignment(ParagraphAlignment.JUSTIFY);
paragraphFormat.setAddSpaceBetweenFarEastAndAlpha(true);
paragraphFormat.setAddSpaceBetweenFarEastAndDigit(true);
paragraphFormat.setKeepTogether(true);
// The "Writeln" method ends the paragraph after appending text
// and then starts a new line, adding a new paragraph.
builder.writeln("Hello world!");
Assert.assertTrue(builder.getCurrentParagraph().isEndOfDocument());
value - The value (in points) for a first line or hanging indent.public double getCharacterUnitFirstLineIndent()
Use positive values to set the first-line indent, and negative values to set the hanging indent.
Examples:
Shows how to change paragraph spacing and indents.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
ParagraphFormat format = doc.getFirstSection().getBody().getFirstParagraph().getParagraphFormat();
// Below are five different spacing options, along with the properties that their configuration indirectly affects.
// 1 - Left indent:
Assert.assertEquals(format.getLeftIndent(), 0.0d);
format.setCharacterUnitLeftIndent(10.0);
Assert.assertEquals(format.getLeftIndent(), 120.0d);
// 2 - Right indent:
Assert.assertEquals(format.getRightIndent(), 0.0d);
format.setCharacterUnitRightIndent(-5.5);
Assert.assertEquals(format.getRightIndent(), -66.0d);
// 3 - Hanging indent:
Assert.assertEquals(format.getFirstLineIndent(), 0.0d);
format.setCharacterUnitFirstLineIndent(20.3);
Assert.assertEquals(format.getFirstLineIndent(), 243.59d, 0.1d);
// 4 - Line spacing before paragraphs:
Assert.assertEquals(format.getSpaceBefore(), 0.0d);
format.setLineUnitBefore(5.1);
Assert.assertEquals(format.getSpaceBefore(), 61.1d, 0.1d);
// 5 - Line spacing after paragraphs:
Assert.assertEquals(format.getSpaceAfter(), 0.0d);
format.setLineUnitAfter(10.9);
Assert.assertEquals(format.getSpaceAfter(), 130.8d, 0.1d);
builder.writeln("Lorem ipsum dolor sit amet, consectetur adipiscing elit, " +
"sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.");
builder.write("测试文档测试文档测试文档测试文档测试文档测试文档测试文档测试文档测试" +
"文档测试文档测试文档测试文档测试文档测试文档测试文档测试文档测试文档测试文档");
public void setCharacterUnitFirstLineIndent(double value)
Use positive values to set the first-line indent, and negative values to set the hanging indent.
Examples:
Shows how to change paragraph spacing and indents.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
ParagraphFormat format = doc.getFirstSection().getBody().getFirstParagraph().getParagraphFormat();
// Below are five different spacing options, along with the properties that their configuration indirectly affects.
// 1 - Left indent:
Assert.assertEquals(format.getLeftIndent(), 0.0d);
format.setCharacterUnitLeftIndent(10.0);
Assert.assertEquals(format.getLeftIndent(), 120.0d);
// 2 - Right indent:
Assert.assertEquals(format.getRightIndent(), 0.0d);
format.setCharacterUnitRightIndent(-5.5);
Assert.assertEquals(format.getRightIndent(), -66.0d);
// 3 - Hanging indent:
Assert.assertEquals(format.getFirstLineIndent(), 0.0d);
format.setCharacterUnitFirstLineIndent(20.3);
Assert.assertEquals(format.getFirstLineIndent(), 243.59d, 0.1d);
// 4 - Line spacing before paragraphs:
Assert.assertEquals(format.getSpaceBefore(), 0.0d);
format.setLineUnitBefore(5.1);
Assert.assertEquals(format.getSpaceBefore(), 61.1d, 0.1d);
// 5 - Line spacing after paragraphs:
Assert.assertEquals(format.getSpaceAfter(), 0.0d);
format.setLineUnitAfter(10.9);
Assert.assertEquals(format.getSpaceAfter(), 130.8d, 0.1d);
builder.writeln("Lorem ipsum dolor sit amet, consectetur adipiscing elit, " +
"sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.");
builder.write("测试文档测试文档测试文档测试文档测试文档测试文档测试文档测试文档测试" +
"文档测试文档测试文档测试文档测试文档测试文档测试文档测试文档测试文档测试文档");
value - The value (in characters) for the first-line or hanging indent.public boolean getSpaceBeforeAuto()
Remarks:
When set to true, overrides the effect of getSpaceBefore() / setSpaceBefore(double).
When you set paragraph Space Before and Space After to Auto, Microsoft Word adds 14 points spacing between paragraphs automatically according to the following rules:
Examples:
Shows how to set automatic paragraph spacing.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Apply a large amount of spacing before and after paragraphs that this builder will create.
builder.getParagraphFormat().setSpaceBefore(24.0);
builder.getParagraphFormat().setSpaceAfter(24.0);
// Set these flags to "true" to apply automatic spacing,
// effectively ignoring the spacing in the properties we set above.
// Leave them as "false" will apply our custom paragraph spacing.
builder.getParagraphFormat().setSpaceAfterAuto(autoSpacing);
builder.getParagraphFormat().setSpaceBeforeAuto(autoSpacing);
// Insert two paragraphs that will have spacing above and below them and save the document.
builder.writeln("Paragraph 1.");
builder.writeln("Paragraph 2.");
doc.save(getArtifactsDir() + "ParagraphFormat.ParagraphSpacingAuto.docx");
boolean value.public void setSpaceBeforeAuto(boolean value)
Remarks:
When set to true, overrides the effect of getSpaceBefore() / setSpaceBefore(double).
When you set paragraph Space Before and Space After to Auto, Microsoft Word adds 14 points spacing between paragraphs automatically according to the following rules:
Examples:
Shows how to set automatic paragraph spacing.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Apply a large amount of spacing before and after paragraphs that this builder will create.
builder.getParagraphFormat().setSpaceBefore(24.0);
builder.getParagraphFormat().setSpaceAfter(24.0);
// Set these flags to "true" to apply automatic spacing,
// effectively ignoring the spacing in the properties we set above.
// Leave them as "false" will apply our custom paragraph spacing.
builder.getParagraphFormat().setSpaceAfterAuto(autoSpacing);
builder.getParagraphFormat().setSpaceBeforeAuto(autoSpacing);
// Insert two paragraphs that will have spacing above and below them and save the document.
builder.writeln("Paragraph 1.");
builder.writeln("Paragraph 2.");
doc.save(getArtifactsDir() + "ParagraphFormat.ParagraphSpacingAuto.docx");
value - The corresponding boolean value.public boolean getSpaceAfterAuto()
Remarks:
When set to true, overrides the effect of getSpaceAfter() / setSpaceAfter(double).
When you set paragraph Space Before and Space After to Auto, Microsoft Word adds 14 points spacing between paragraphs automatically according to the following rules:
Examples:
Shows how to set automatic paragraph spacing.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Apply a large amount of spacing before and after paragraphs that this builder will create.
builder.getParagraphFormat().setSpaceBefore(24.0);
builder.getParagraphFormat().setSpaceAfter(24.0);
// Set these flags to "true" to apply automatic spacing,
// effectively ignoring the spacing in the properties we set above.
// Leave them as "false" will apply our custom paragraph spacing.
builder.getParagraphFormat().setSpaceAfterAuto(autoSpacing);
builder.getParagraphFormat().setSpaceBeforeAuto(autoSpacing);
// Insert two paragraphs that will have spacing above and below them and save the document.
builder.writeln("Paragraph 1.");
builder.writeln("Paragraph 2.");
doc.save(getArtifactsDir() + "ParagraphFormat.ParagraphSpacingAuto.docx");
boolean value.public void setSpaceAfterAuto(boolean value)
Remarks:
When set to true, overrides the effect of getSpaceAfter() / setSpaceAfter(double).
When you set paragraph Space Before and Space After to Auto, Microsoft Word adds 14 points spacing between paragraphs automatically according to the following rules:
Examples:
Shows how to set automatic paragraph spacing.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Apply a large amount of spacing before and after paragraphs that this builder will create.
builder.getParagraphFormat().setSpaceBefore(24.0);
builder.getParagraphFormat().setSpaceAfter(24.0);
// Set these flags to "true" to apply automatic spacing,
// effectively ignoring the spacing in the properties we set above.
// Leave them as "false" will apply our custom paragraph spacing.
builder.getParagraphFormat().setSpaceAfterAuto(autoSpacing);
builder.getParagraphFormat().setSpaceBeforeAuto(autoSpacing);
// Insert two paragraphs that will have spacing above and below them and save the document.
builder.writeln("Paragraph 1.");
builder.writeln("Paragraph 2.");
doc.save(getArtifactsDir() + "ParagraphFormat.ParagraphSpacingAuto.docx");
value - The corresponding boolean value.public double getSpaceBefore()
java.lang.IllegalArgumentException - Throws when argument was out of the range of valid values.
Remarks:
Has no effect when getSpaceBeforeAuto() / setSpaceBeforeAuto(boolean) is true.
Valid values range from 0 to 1584 inclusive.
Examples:
Shows how to set automatic paragraph spacing.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Apply a large amount of spacing before and after paragraphs that this builder will create.
builder.getParagraphFormat().setSpaceBefore(24.0);
builder.getParagraphFormat().setSpaceAfter(24.0);
// Set these flags to "true" to apply automatic spacing,
// effectively ignoring the spacing in the properties we set above.
// Leave them as "false" will apply our custom paragraph spacing.
builder.getParagraphFormat().setSpaceAfterAuto(autoSpacing);
builder.getParagraphFormat().setSpaceBeforeAuto(autoSpacing);
// Insert two paragraphs that will have spacing above and below them and save the document.
builder.writeln("Paragraph 1.");
builder.writeln("Paragraph 2.");
doc.save(getArtifactsDir() + "ParagraphFormat.ParagraphSpacingAuto.docx");
Shows how to apply no spacing between paragraphs with the same style.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Apply a large amount of spacing before and after paragraphs that this builder will create.
builder.getParagraphFormat().setSpaceBefore(24.0);
builder.getParagraphFormat().setSpaceAfter(24.0);
// Set the "NoSpaceBetweenParagraphsOfSameStyle" flag to "true" to apply
// no spacing between paragraphs with the same style, which will group similar paragraphs.
// Leave the "NoSpaceBetweenParagraphsOfSameStyle" flag as "false"
// to evenly apply spacing to every paragraph.
builder.getParagraphFormat().setNoSpaceBetweenParagraphsOfSameStyle(noSpaceBetweenParagraphsOfSameStyle);
builder.getParagraphFormat().setStyle(doc.getStyles().get("Normal"));
builder.writeln(MessageFormat.format("Paragraph in the \"{0}\" style.", builder.getParagraphFormat().getStyle().getName()));
builder.writeln(MessageFormat.format("Paragraph in the \"{0}\" style.", builder.getParagraphFormat().getStyle().getName()));
builder.writeln(MessageFormat.format("Paragraph in the \"{0}\" style.", builder.getParagraphFormat().getStyle().getName()));
builder.getParagraphFormat().setStyle(doc.getStyles().get("Quote"));
builder.writeln(MessageFormat.format("Paragraph in the \"{0}\" style.", builder.getParagraphFormat().getStyle().getName()));
builder.writeln(MessageFormat.format("Paragraph in the \"{0}\" style.", builder.getParagraphFormat().getStyle().getName()));
builder.getParagraphFormat().setStyle(doc.getStyles().get("Normal"));
builder.writeln(MessageFormat.format("Paragraph in the \"{0}\" style.", builder.getParagraphFormat().getStyle().getName()));
builder.writeln(MessageFormat.format("Paragraph in the \"{0}\" style.", builder.getParagraphFormat().getStyle().getName()));
doc.save(getArtifactsDir() + "ParagraphFormat.ParagraphSpacingSameStyle.docx");
public void setSpaceBefore(double value)
value - The amount of spacing (in points) before the paragraph.java.lang.IllegalArgumentException - Throws when argument was out of the range of valid values.
Remarks:
Has no effect when getSpaceBeforeAuto() / setSpaceBeforeAuto(boolean) is true.
Valid values range from 0 to 1584 inclusive.
Examples:
Shows how to set automatic paragraph spacing.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Apply a large amount of spacing before and after paragraphs that this builder will create.
builder.getParagraphFormat().setSpaceBefore(24.0);
builder.getParagraphFormat().setSpaceAfter(24.0);
// Set these flags to "true" to apply automatic spacing,
// effectively ignoring the spacing in the properties we set above.
// Leave them as "false" will apply our custom paragraph spacing.
builder.getParagraphFormat().setSpaceAfterAuto(autoSpacing);
builder.getParagraphFormat().setSpaceBeforeAuto(autoSpacing);
// Insert two paragraphs that will have spacing above and below them and save the document.
builder.writeln("Paragraph 1.");
builder.writeln("Paragraph 2.");
doc.save(getArtifactsDir() + "ParagraphFormat.ParagraphSpacingAuto.docx");
Shows how to apply no spacing between paragraphs with the same style.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Apply a large amount of spacing before and after paragraphs that this builder will create.
builder.getParagraphFormat().setSpaceBefore(24.0);
builder.getParagraphFormat().setSpaceAfter(24.0);
// Set the "NoSpaceBetweenParagraphsOfSameStyle" flag to "true" to apply
// no spacing between paragraphs with the same style, which will group similar paragraphs.
// Leave the "NoSpaceBetweenParagraphsOfSameStyle" flag as "false"
// to evenly apply spacing to every paragraph.
builder.getParagraphFormat().setNoSpaceBetweenParagraphsOfSameStyle(noSpaceBetweenParagraphsOfSameStyle);
builder.getParagraphFormat().setStyle(doc.getStyles().get("Normal"));
builder.writeln(MessageFormat.format("Paragraph in the \"{0}\" style.", builder.getParagraphFormat().getStyle().getName()));
builder.writeln(MessageFormat.format("Paragraph in the \"{0}\" style.", builder.getParagraphFormat().getStyle().getName()));
builder.writeln(MessageFormat.format("Paragraph in the \"{0}\" style.", builder.getParagraphFormat().getStyle().getName()));
builder.getParagraphFormat().setStyle(doc.getStyles().get("Quote"));
builder.writeln(MessageFormat.format("Paragraph in the \"{0}\" style.", builder.getParagraphFormat().getStyle().getName()));
builder.writeln(MessageFormat.format("Paragraph in the \"{0}\" style.", builder.getParagraphFormat().getStyle().getName()));
builder.getParagraphFormat().setStyle(doc.getStyles().get("Normal"));
builder.writeln(MessageFormat.format("Paragraph in the \"{0}\" style.", builder.getParagraphFormat().getStyle().getName()));
builder.writeln(MessageFormat.format("Paragraph in the \"{0}\" style.", builder.getParagraphFormat().getStyle().getName()));
doc.save(getArtifactsDir() + "ParagraphFormat.ParagraphSpacingSameStyle.docx");
public double getLineUnitBefore()
Examples:
Shows how to change paragraph spacing and indents.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
ParagraphFormat format = doc.getFirstSection().getBody().getFirstParagraph().getParagraphFormat();
// Below are five different spacing options, along with the properties that their configuration indirectly affects.
// 1 - Left indent:
Assert.assertEquals(format.getLeftIndent(), 0.0d);
format.setCharacterUnitLeftIndent(10.0);
Assert.assertEquals(format.getLeftIndent(), 120.0d);
// 2 - Right indent:
Assert.assertEquals(format.getRightIndent(), 0.0d);
format.setCharacterUnitRightIndent(-5.5);
Assert.assertEquals(format.getRightIndent(), -66.0d);
// 3 - Hanging indent:
Assert.assertEquals(format.getFirstLineIndent(), 0.0d);
format.setCharacterUnitFirstLineIndent(20.3);
Assert.assertEquals(format.getFirstLineIndent(), 243.59d, 0.1d);
// 4 - Line spacing before paragraphs:
Assert.assertEquals(format.getSpaceBefore(), 0.0d);
format.setLineUnitBefore(5.1);
Assert.assertEquals(format.getSpaceBefore(), 61.1d, 0.1d);
// 5 - Line spacing after paragraphs:
Assert.assertEquals(format.getSpaceAfter(), 0.0d);
format.setLineUnitAfter(10.9);
Assert.assertEquals(format.getSpaceAfter(), 130.8d, 0.1d);
builder.writeln("Lorem ipsum dolor sit amet, consectetur adipiscing elit, " +
"sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.");
builder.write("测试文档测试文档测试文档测试文档测试文档测试文档测试文档测试文档测试" +
"文档测试文档测试文档测试文档测试文档测试文档测试文档测试文档测试文档测试文档");
public void setLineUnitBefore(double value)
Examples:
Shows how to change paragraph spacing and indents.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
ParagraphFormat format = doc.getFirstSection().getBody().getFirstParagraph().getParagraphFormat();
// Below are five different spacing options, along with the properties that their configuration indirectly affects.
// 1 - Left indent:
Assert.assertEquals(format.getLeftIndent(), 0.0d);
format.setCharacterUnitLeftIndent(10.0);
Assert.assertEquals(format.getLeftIndent(), 120.0d);
// 2 - Right indent:
Assert.assertEquals(format.getRightIndent(), 0.0d);
format.setCharacterUnitRightIndent(-5.5);
Assert.assertEquals(format.getRightIndent(), -66.0d);
// 3 - Hanging indent:
Assert.assertEquals(format.getFirstLineIndent(), 0.0d);
format.setCharacterUnitFirstLineIndent(20.3);
Assert.assertEquals(format.getFirstLineIndent(), 243.59d, 0.1d);
// 4 - Line spacing before paragraphs:
Assert.assertEquals(format.getSpaceBefore(), 0.0d);
format.setLineUnitBefore(5.1);
Assert.assertEquals(format.getSpaceBefore(), 61.1d, 0.1d);
// 5 - Line spacing after paragraphs:
Assert.assertEquals(format.getSpaceAfter(), 0.0d);
format.setLineUnitAfter(10.9);
Assert.assertEquals(format.getSpaceAfter(), 130.8d, 0.1d);
builder.writeln("Lorem ipsum dolor sit amet, consectetur adipiscing elit, " +
"sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.");
builder.write("测试文档测试文档测试文档测试文档测试文档测试文档测试文档测试文档测试" +
"文档测试文档测试文档测试文档测试文档测试文档测试文档测试文档测试文档测试文档");
value - The amount of spacing (in gridlines) before the paragraphs.public double getSpaceAfter()
java.lang.IllegalArgumentException - Throws when argument was out of the range of valid values.
Remarks:
Has no effect when getSpaceAfterAuto() / setSpaceAfterAuto(boolean) is true.
Valid values range from 0 to 1584 inclusive.
Examples:
Shows how to set automatic paragraph spacing.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Apply a large amount of spacing before and after paragraphs that this builder will create.
builder.getParagraphFormat().setSpaceBefore(24.0);
builder.getParagraphFormat().setSpaceAfter(24.0);
// Set these flags to "true" to apply automatic spacing,
// effectively ignoring the spacing in the properties we set above.
// Leave them as "false" will apply our custom paragraph spacing.
builder.getParagraphFormat().setSpaceAfterAuto(autoSpacing);
builder.getParagraphFormat().setSpaceBeforeAuto(autoSpacing);
// Insert two paragraphs that will have spacing above and below them and save the document.
builder.writeln("Paragraph 1.");
builder.writeln("Paragraph 2.");
doc.save(getArtifactsDir() + "ParagraphFormat.ParagraphSpacingAuto.docx");
Shows how to apply no spacing between paragraphs with the same style.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Apply a large amount of spacing before and after paragraphs that this builder will create.
builder.getParagraphFormat().setSpaceBefore(24.0);
builder.getParagraphFormat().setSpaceAfter(24.0);
// Set the "NoSpaceBetweenParagraphsOfSameStyle" flag to "true" to apply
// no spacing between paragraphs with the same style, which will group similar paragraphs.
// Leave the "NoSpaceBetweenParagraphsOfSameStyle" flag as "false"
// to evenly apply spacing to every paragraph.
builder.getParagraphFormat().setNoSpaceBetweenParagraphsOfSameStyle(noSpaceBetweenParagraphsOfSameStyle);
builder.getParagraphFormat().setStyle(doc.getStyles().get("Normal"));
builder.writeln(MessageFormat.format("Paragraph in the \"{0}\" style.", builder.getParagraphFormat().getStyle().getName()));
builder.writeln(MessageFormat.format("Paragraph in the \"{0}\" style.", builder.getParagraphFormat().getStyle().getName()));
builder.writeln(MessageFormat.format("Paragraph in the \"{0}\" style.", builder.getParagraphFormat().getStyle().getName()));
builder.getParagraphFormat().setStyle(doc.getStyles().get("Quote"));
builder.writeln(MessageFormat.format("Paragraph in the \"{0}\" style.", builder.getParagraphFormat().getStyle().getName()));
builder.writeln(MessageFormat.format("Paragraph in the \"{0}\" style.", builder.getParagraphFormat().getStyle().getName()));
builder.getParagraphFormat().setStyle(doc.getStyles().get("Normal"));
builder.writeln(MessageFormat.format("Paragraph in the \"{0}\" style.", builder.getParagraphFormat().getStyle().getName()));
builder.writeln(MessageFormat.format("Paragraph in the \"{0}\" style.", builder.getParagraphFormat().getStyle().getName()));
doc.save(getArtifactsDir() + "ParagraphFormat.ParagraphSpacingSameStyle.docx");
public void setSpaceAfter(double value)
value - The amount of spacing (in points) after the paragraph.java.lang.IllegalArgumentException - Throws when argument was out of the range of valid values.
Remarks:
Has no effect when getSpaceAfterAuto() / setSpaceAfterAuto(boolean) is true.
Valid values range from 0 to 1584 inclusive.
Examples:
Shows how to set automatic paragraph spacing.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Apply a large amount of spacing before and after paragraphs that this builder will create.
builder.getParagraphFormat().setSpaceBefore(24.0);
builder.getParagraphFormat().setSpaceAfter(24.0);
// Set these flags to "true" to apply automatic spacing,
// effectively ignoring the spacing in the properties we set above.
// Leave them as "false" will apply our custom paragraph spacing.
builder.getParagraphFormat().setSpaceAfterAuto(autoSpacing);
builder.getParagraphFormat().setSpaceBeforeAuto(autoSpacing);
// Insert two paragraphs that will have spacing above and below them and save the document.
builder.writeln("Paragraph 1.");
builder.writeln("Paragraph 2.");
doc.save(getArtifactsDir() + "ParagraphFormat.ParagraphSpacingAuto.docx");
Shows how to apply no spacing between paragraphs with the same style.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Apply a large amount of spacing before and after paragraphs that this builder will create.
builder.getParagraphFormat().setSpaceBefore(24.0);
builder.getParagraphFormat().setSpaceAfter(24.0);
// Set the "NoSpaceBetweenParagraphsOfSameStyle" flag to "true" to apply
// no spacing between paragraphs with the same style, which will group similar paragraphs.
// Leave the "NoSpaceBetweenParagraphsOfSameStyle" flag as "false"
// to evenly apply spacing to every paragraph.
builder.getParagraphFormat().setNoSpaceBetweenParagraphsOfSameStyle(noSpaceBetweenParagraphsOfSameStyle);
builder.getParagraphFormat().setStyle(doc.getStyles().get("Normal"));
builder.writeln(MessageFormat.format("Paragraph in the \"{0}\" style.", builder.getParagraphFormat().getStyle().getName()));
builder.writeln(MessageFormat.format("Paragraph in the \"{0}\" style.", builder.getParagraphFormat().getStyle().getName()));
builder.writeln(MessageFormat.format("Paragraph in the \"{0}\" style.", builder.getParagraphFormat().getStyle().getName()));
builder.getParagraphFormat().setStyle(doc.getStyles().get("Quote"));
builder.writeln(MessageFormat.format("Paragraph in the \"{0}\" style.", builder.getParagraphFormat().getStyle().getName()));
builder.writeln(MessageFormat.format("Paragraph in the \"{0}\" style.", builder.getParagraphFormat().getStyle().getName()));
builder.getParagraphFormat().setStyle(doc.getStyles().get("Normal"));
builder.writeln(MessageFormat.format("Paragraph in the \"{0}\" style.", builder.getParagraphFormat().getStyle().getName()));
builder.writeln(MessageFormat.format("Paragraph in the \"{0}\" style.", builder.getParagraphFormat().getStyle().getName()));
doc.save(getArtifactsDir() + "ParagraphFormat.ParagraphSpacingSameStyle.docx");
public double getLineUnitAfter()
Examples:
Shows how to change paragraph spacing and indents.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
ParagraphFormat format = doc.getFirstSection().getBody().getFirstParagraph().getParagraphFormat();
// Below are five different spacing options, along with the properties that their configuration indirectly affects.
// 1 - Left indent:
Assert.assertEquals(format.getLeftIndent(), 0.0d);
format.setCharacterUnitLeftIndent(10.0);
Assert.assertEquals(format.getLeftIndent(), 120.0d);
// 2 - Right indent:
Assert.assertEquals(format.getRightIndent(), 0.0d);
format.setCharacterUnitRightIndent(-5.5);
Assert.assertEquals(format.getRightIndent(), -66.0d);
// 3 - Hanging indent:
Assert.assertEquals(format.getFirstLineIndent(), 0.0d);
format.setCharacterUnitFirstLineIndent(20.3);
Assert.assertEquals(format.getFirstLineIndent(), 243.59d, 0.1d);
// 4 - Line spacing before paragraphs:
Assert.assertEquals(format.getSpaceBefore(), 0.0d);
format.setLineUnitBefore(5.1);
Assert.assertEquals(format.getSpaceBefore(), 61.1d, 0.1d);
// 5 - Line spacing after paragraphs:
Assert.assertEquals(format.getSpaceAfter(), 0.0d);
format.setLineUnitAfter(10.9);
Assert.assertEquals(format.getSpaceAfter(), 130.8d, 0.1d);
builder.writeln("Lorem ipsum dolor sit amet, consectetur adipiscing elit, " +
"sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.");
builder.write("测试文档测试文档测试文档测试文档测试文档测试文档测试文档测试文档测试" +
"文档测试文档测试文档测试文档测试文档测试文档测试文档测试文档测试文档测试文档");
public void setLineUnitAfter(double value)
Examples:
Shows how to change paragraph spacing and indents.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
ParagraphFormat format = doc.getFirstSection().getBody().getFirstParagraph().getParagraphFormat();
// Below are five different spacing options, along with the properties that their configuration indirectly affects.
// 1 - Left indent:
Assert.assertEquals(format.getLeftIndent(), 0.0d);
format.setCharacterUnitLeftIndent(10.0);
Assert.assertEquals(format.getLeftIndent(), 120.0d);
// 2 - Right indent:
Assert.assertEquals(format.getRightIndent(), 0.0d);
format.setCharacterUnitRightIndent(-5.5);
Assert.assertEquals(format.getRightIndent(), -66.0d);
// 3 - Hanging indent:
Assert.assertEquals(format.getFirstLineIndent(), 0.0d);
format.setCharacterUnitFirstLineIndent(20.3);
Assert.assertEquals(format.getFirstLineIndent(), 243.59d, 0.1d);
// 4 - Line spacing before paragraphs:
Assert.assertEquals(format.getSpaceBefore(), 0.0d);
format.setLineUnitBefore(5.1);
Assert.assertEquals(format.getSpaceBefore(), 61.1d, 0.1d);
// 5 - Line spacing after paragraphs:
Assert.assertEquals(format.getSpaceAfter(), 0.0d);
format.setLineUnitAfter(10.9);
Assert.assertEquals(format.getSpaceAfter(), 130.8d, 0.1d);
builder.writeln("Lorem ipsum dolor sit amet, consectetur adipiscing elit, " +
"sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.");
builder.write("测试文档测试文档测试文档测试文档测试文档测试文档测试文档测试文档测试" +
"文档测试文档测试文档测试文档测试文档测试文档测试文档测试文档测试文档测试文档");
value - The amount of spacing (in gridlines) after the paragraphs.public int getLineSpacingRule()
Examples:
Shows how to work with line spacing.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Below are three line spacing rules that we can define using the
// paragraph's "LineSpacingRule" property to configure spacing between paragraphs.
// 1 - Set a minimum amount of spacing.
// This will give vertical padding to lines of text of any size
// that is too small to maintain the minimum line-height.
builder.getParagraphFormat().setLineSpacingRule(LineSpacingRule.AT_LEAST);
builder.getParagraphFormat().setLineSpacing(20.0);
builder.writeln("Minimum line spacing of 20.");
builder.writeln("Minimum line spacing of 20.");
// 2 - Set exact spacing.
// Using font sizes that are too large for the spacing will truncate the text.
builder.getParagraphFormat().setLineSpacingRule(LineSpacingRule.EXACTLY);
builder.getParagraphFormat().setLineSpacing(5.0);
builder.writeln("Line spacing of exactly 5.");
builder.writeln("Line spacing of exactly 5.");
// 3 - Set spacing as a multiple of default line spacing, which is 12 points by default.
// This kind of spacing will scale to different font sizes.
builder.getParagraphFormat().setLineSpacingRule(LineSpacingRule.MULTIPLE);
builder.getParagraphFormat().setLineSpacing(18.0);
builder.writeln("Line spacing of 1.5 default lines.");
builder.writeln("Line spacing of 1.5 default lines.");
doc.save(getArtifactsDir() + "ParagraphFormat.LineSpacing.docx");
LineSpacingRule constants.public void setLineSpacingRule(int value)
Examples:
Shows how to work with line spacing.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Below are three line spacing rules that we can define using the
// paragraph's "LineSpacingRule" property to configure spacing between paragraphs.
// 1 - Set a minimum amount of spacing.
// This will give vertical padding to lines of text of any size
// that is too small to maintain the minimum line-height.
builder.getParagraphFormat().setLineSpacingRule(LineSpacingRule.AT_LEAST);
builder.getParagraphFormat().setLineSpacing(20.0);
builder.writeln("Minimum line spacing of 20.");
builder.writeln("Minimum line spacing of 20.");
// 2 - Set exact spacing.
// Using font sizes that are too large for the spacing will truncate the text.
builder.getParagraphFormat().setLineSpacingRule(LineSpacingRule.EXACTLY);
builder.getParagraphFormat().setLineSpacing(5.0);
builder.writeln("Line spacing of exactly 5.");
builder.writeln("Line spacing of exactly 5.");
// 3 - Set spacing as a multiple of default line spacing, which is 12 points by default.
// This kind of spacing will scale to different font sizes.
builder.getParagraphFormat().setLineSpacingRule(LineSpacingRule.MULTIPLE);
builder.getParagraphFormat().setLineSpacing(18.0);
builder.writeln("Line spacing of 1.5 default lines.");
builder.writeln("Line spacing of 1.5 default lines.");
doc.save(getArtifactsDir() + "ParagraphFormat.LineSpacing.docx");
value - The line spacing for the paragraph. The value must be one of LineSpacingRule constants.public double getLineSpacing()
Remarks:
When getLineSpacingRule() / setLineSpacingRule(int) property is set to LineSpacingRule.AT_LEAST, the line spacing can be greater than or equal to, but never less than the specified getLineSpacing() / setLineSpacing(double) value.
When getLineSpacingRule() / setLineSpacingRule(int) property is set to LineSpacingRule.EXACTLY, the line spacing never changes from the specified getLineSpacing() / setLineSpacing(double) value, even if a larger font is used within the paragraph.
Examples:
Shows how to work with line spacing.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Below are three line spacing rules that we can define using the
// paragraph's "LineSpacingRule" property to configure spacing between paragraphs.
// 1 - Set a minimum amount of spacing.
// This will give vertical padding to lines of text of any size
// that is too small to maintain the minimum line-height.
builder.getParagraphFormat().setLineSpacingRule(LineSpacingRule.AT_LEAST);
builder.getParagraphFormat().setLineSpacing(20.0);
builder.writeln("Minimum line spacing of 20.");
builder.writeln("Minimum line spacing of 20.");
// 2 - Set exact spacing.
// Using font sizes that are too large for the spacing will truncate the text.
builder.getParagraphFormat().setLineSpacingRule(LineSpacingRule.EXACTLY);
builder.getParagraphFormat().setLineSpacing(5.0);
builder.writeln("Line spacing of exactly 5.");
builder.writeln("Line spacing of exactly 5.");
// 3 - Set spacing as a multiple of default line spacing, which is 12 points by default.
// This kind of spacing will scale to different font sizes.
builder.getParagraphFormat().setLineSpacingRule(LineSpacingRule.MULTIPLE);
builder.getParagraphFormat().setLineSpacing(18.0);
builder.writeln("Line spacing of 1.5 default lines.");
builder.writeln("Line spacing of 1.5 default lines.");
doc.save(getArtifactsDir() + "ParagraphFormat.LineSpacing.docx");
public void setLineSpacing(double value)
Remarks:
When getLineSpacingRule() / setLineSpacingRule(int) property is set to LineSpacingRule.AT_LEAST, the line spacing can be greater than or equal to, but never less than the specified getLineSpacing() / setLineSpacing(double) value.
When getLineSpacingRule() / setLineSpacingRule(int) property is set to LineSpacingRule.EXACTLY, the line spacing never changes from the specified getLineSpacing() / setLineSpacing(double) value, even if a larger font is used within the paragraph.
Examples:
Shows how to work with line spacing.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Below are three line spacing rules that we can define using the
// paragraph's "LineSpacingRule" property to configure spacing between paragraphs.
// 1 - Set a minimum amount of spacing.
// This will give vertical padding to lines of text of any size
// that is too small to maintain the minimum line-height.
builder.getParagraphFormat().setLineSpacingRule(LineSpacingRule.AT_LEAST);
builder.getParagraphFormat().setLineSpacing(20.0);
builder.writeln("Minimum line spacing of 20.");
builder.writeln("Minimum line spacing of 20.");
// 2 - Set exact spacing.
// Using font sizes that are too large for the spacing will truncate the text.
builder.getParagraphFormat().setLineSpacingRule(LineSpacingRule.EXACTLY);
builder.getParagraphFormat().setLineSpacing(5.0);
builder.writeln("Line spacing of exactly 5.");
builder.writeln("Line spacing of exactly 5.");
// 3 - Set spacing as a multiple of default line spacing, which is 12 points by default.
// This kind of spacing will scale to different font sizes.
builder.getParagraphFormat().setLineSpacingRule(LineSpacingRule.MULTIPLE);
builder.getParagraphFormat().setLineSpacing(18.0);
builder.writeln("Line spacing of 1.5 default lines.");
builder.writeln("Line spacing of 1.5 default lines.");
doc.save(getArtifactsDir() + "ParagraphFormat.LineSpacing.docx");
value - The line spacing (in points) for the paragraph.public boolean getMirrorIndents()
Examples:
Show how to make left and right indents the same.
Document doc = new Document(getMyDir() + "Document.docx");
ParagraphFormat format = doc.getFirstSection().getBody().getParagraphs().get(0).getParagraphFormat();
format.setMirrorIndents(true);
doc.save(getArtifactsDir() + "ParagraphFormat.MirrorIndents.docx");
public void setMirrorIndents(boolean value)
Examples:
Show how to make left and right indents the same.
Document doc = new Document(getMyDir() + "Document.docx");
ParagraphFormat format = doc.getFirstSection().getBody().getParagraphs().get(0).getParagraphFormat();
format.setMirrorIndents(true);
doc.save(getArtifactsDir() + "ParagraphFormat.MirrorIndents.docx");
value - A flag indicating whether the left and right indents are of the same width.public boolean isHeading()
Examples:
Shows how to limit the headings' level that will appear in the outline of a saved PDF document.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Insert headings that can serve as TOC entries of levels 1, 2, and then 3.
builder.getParagraphFormat().setStyleIdentifier(StyleIdentifier.HEADING_1);
Assert.assertTrue(builder.getParagraphFormat().isHeading());
builder.writeln("Heading 1");
builder.getParagraphFormat().setStyleIdentifier(StyleIdentifier.HEADING_2);
builder.writeln("Heading 1.1");
builder.writeln("Heading 1.2");
builder.getParagraphFormat().setStyleIdentifier(StyleIdentifier.HEADING_3);
builder.writeln("Heading 1.2.1");
builder.writeln("Heading 1.2.2");
// Create a "PdfSaveOptions" object that we can pass to the document's "Save" method
// to modify how that method converts the document to .PDF.
PdfSaveOptions saveOptions = new PdfSaveOptions();
saveOptions.setSaveFormat(SaveFormat.PDF);
// The output PDF document will contain an outline, which is a table of contents that lists headings in the document body.
// Clicking on an entry in this outline will take us to the location of its respective heading.
// Set the "HeadingsOutlineLevels" property to "2" to exclude all headings whose levels are above 2 from the outline.
// The last two headings we have inserted above will not appear.
saveOptions.getOutlineOptions().setHeadingsOutlineLevels(2);
doc.save(getArtifactsDir() + "PdfSaveOptions.HeadingsOutlineLevels.pdf", saveOptions);
boolean value.public boolean isListItem()
Examples:
Shows how to nest a list inside another list.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// A list allows us to organize and decorate sets of paragraphs with prefix symbols and indents.
// We can create nested lists by increasing the indent level.
// We can begin and end a list by using a document builder's "ListFormat" property.
// Each paragraph that we add between a list's start and the end will become an item in the list.
// Create an outline list for the headings.
List outlineList = doc.getLists().add(ListTemplate.OUTLINE_NUMBERS);
builder.getListFormat().setList(outlineList);
builder.getParagraphFormat().setStyleIdentifier(StyleIdentifier.HEADING_1);
builder.writeln("This is my Chapter 1");
// Create a numbered list.
List numberedList = doc.getLists().add(ListTemplate.NUMBER_DEFAULT);
builder.getListFormat().setList(numberedList);
builder.getParagraphFormat().setStyleIdentifier(StyleIdentifier.NORMAL);
builder.writeln("Numbered list item 1.");
// Every paragraph that comprises a list will have this flag.
Assert.assertTrue(builder.getCurrentParagraph().isListItem());
Assert.assertTrue(builder.getParagraphFormat().isListItem());
// Create a bulleted list.
List bulletedList = doc.getLists().add(ListTemplate.BULLET_DEFAULT);
builder.getListFormat().setList(bulletedList);
builder.getParagraphFormat().setLeftIndent(72.0);
builder.writeln("Bulleted list item 1.");
builder.writeln("Bulleted list item 2.");
builder.getParagraphFormat().clearFormatting();
// Revert to the numbered list.
builder.getListFormat().setList(numberedList);
builder.writeln("Numbered list item 2.");
builder.writeln("Numbered list item 3.");
// Revert to the outline list.
builder.getListFormat().setList(outlineList);
builder.getParagraphFormat().setStyleIdentifier(StyleIdentifier.HEADING_1);
builder.writeln("This is my Chapter 2");
builder.getParagraphFormat().clearFormatting();
builder.getDocument().save(getArtifactsDir() + "Lists.NestedLists.docx");
boolean value.public int getOutlineLevel()
Examples:
Shows how to configure paragraph outline levels to create collapsible text.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Each paragraph has an OutlineLevel, which could be any number from 1 to 9, or at the default "BodyText" value.
// Setting the property to one of the numbered values will show an arrow to the left
// of the beginning of the paragraph.
builder.getParagraphFormat().setOutlineLevel(OutlineLevel.LEVEL_1);
builder.writeln("Paragraph outline level 1.");
// Level 1 is the topmost level. If there is a paragraph with a lower level below a paragraph with a higher level,
// collapsing the higher-level paragraph will collapse the lower level paragraph.
builder.getParagraphFormat().setOutlineLevel(OutlineLevel.LEVEL_2);
builder.writeln("Paragraph outline level 2.");
// Two paragraphs of the same level will not collapse each other,
// and the arrows do not collapse the paragraphs they point to.
builder.getParagraphFormat().setOutlineLevel(OutlineLevel.LEVEL_3);
builder.writeln("Paragraph outline level 3.");
builder.writeln("Paragraph outline level 3.");
// The default "BodyText" value is the lowest, which a paragraph of any level can collapse.
builder.getParagraphFormat().setOutlineLevel(OutlineLevel.BODY_TEXT);
builder.writeln("Paragraph at main text level.");
doc.save(getArtifactsDir() + "ParagraphFormat.ParagraphOutlineLevel.docx");
int value. The returned value is one of OutlineLevel constants.public void setOutlineLevel(int value)
Examples:
Shows how to configure paragraph outline levels to create collapsible text.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Each paragraph has an OutlineLevel, which could be any number from 1 to 9, or at the default "BodyText" value.
// Setting the property to one of the numbered values will show an arrow to the left
// of the beginning of the paragraph.
builder.getParagraphFormat().setOutlineLevel(OutlineLevel.LEVEL_1);
builder.writeln("Paragraph outline level 1.");
// Level 1 is the topmost level. If there is a paragraph with a lower level below a paragraph with a higher level,
// collapsing the higher-level paragraph will collapse the lower level paragraph.
builder.getParagraphFormat().setOutlineLevel(OutlineLevel.LEVEL_2);
builder.writeln("Paragraph outline level 2.");
// Two paragraphs of the same level will not collapse each other,
// and the arrows do not collapse the paragraphs they point to.
builder.getParagraphFormat().setOutlineLevel(OutlineLevel.LEVEL_3);
builder.writeln("Paragraph outline level 3.");
builder.writeln("Paragraph outline level 3.");
// The default "BodyText" value is the lowest, which a paragraph of any level can collapse.
builder.getParagraphFormat().setOutlineLevel(OutlineLevel.BODY_TEXT);
builder.writeln("Paragraph at main text level.");
doc.save(getArtifactsDir() + "ParagraphFormat.ParagraphOutlineLevel.docx");
value - The corresponding int value. The value must be one of OutlineLevel constants.public int getLinesToDrop()
Examples:
Shows how to set the size of a drop cap.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Modify the "LinesToDrop" property to designate a paragraph as a drop cap,
// which will turn it into a large capital letter that will decorate the next paragraph.
// Give this property a value of 4 to give the drop cap the height of four text lines.
builder.getParagraphFormat().setLinesToDrop(4);
builder.writeln("H");
// Reset the "LinesToDrop" property to 0 to turn the next paragraph into an ordinary paragraph.
// The text in this paragraph will wrap around the drop cap.
builder.getParagraphFormat().setLinesToDrop(0);
builder.writeln("ello world!");
doc.save(getArtifactsDir() + "ParagraphFormat.LinesToDrop.odt");
public void setLinesToDrop(int value)
Examples:
Shows how to set the size of a drop cap.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Modify the "LinesToDrop" property to designate a paragraph as a drop cap,
// which will turn it into a large capital letter that will decorate the next paragraph.
// Give this property a value of 4 to give the drop cap the height of four text lines.
builder.getParagraphFormat().setLinesToDrop(4);
builder.writeln("H");
// Reset the "LinesToDrop" property to 0 to turn the next paragraph into an ordinary paragraph.
// The text in this paragraph will wrap around the drop cap.
builder.getParagraphFormat().setLinesToDrop(0);
builder.writeln("ello world!");
doc.save(getArtifactsDir() + "ParagraphFormat.LinesToDrop.odt");
value - The number of lines of the paragraph text used to calculate the drop cap height.public int getDropCapPosition()
Examples:
Shows how to nest a list inside another list.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// A list allows us to organize and decorate sets of paragraphs with prefix symbols and indents.
// We can create nested lists by increasing the indent level.
// We can begin and end a list by using a document builder's "ListFormat" property.
// Each paragraph that we add between a list's start and the end will become an item in the list.
// Create an outline list for the headings.
List outlineList = doc.getLists().add(ListTemplate.OUTLINE_NUMBERS);
builder.getListFormat().setList(outlineList);
builder.getParagraphFormat().setStyleIdentifier(StyleIdentifier.HEADING_1);
builder.writeln("This is my Chapter 1");
// Create a numbered list.
List numberedList = doc.getLists().add(ListTemplate.NUMBER_DEFAULT);
builder.getListFormat().setList(numberedList);
builder.getParagraphFormat().setStyleIdentifier(StyleIdentifier.NORMAL);
builder.writeln("Numbered list item 1.");
// Every paragraph that comprises a list will have this flag.
Assert.assertTrue(builder.getCurrentParagraph().isListItem());
Assert.assertTrue(builder.getParagraphFormat().isListItem());
// Create a bulleted list.
List bulletedList = doc.getLists().add(ListTemplate.BULLET_DEFAULT);
builder.getListFormat().setList(bulletedList);
builder.getParagraphFormat().setLeftIndent(72.0);
builder.writeln("Bulleted list item 1.");
builder.writeln("Bulleted list item 2.");
builder.getParagraphFormat().clearFormatting();
// Revert to the numbered list.
builder.getListFormat().setList(numberedList);
builder.writeln("Numbered list item 2.");
builder.writeln("Numbered list item 3.");
// Revert to the outline list.
builder.getListFormat().setList(outlineList);
builder.getParagraphFormat().setStyleIdentifier(StyleIdentifier.HEADING_1);
builder.writeln("This is my Chapter 2");
builder.getParagraphFormat().clearFormatting();
builder.getDocument().save(getArtifactsDir() + "Lists.NestedLists.docx");
DropCapPosition constants.public void setDropCapPosition(int value)
Examples:
Shows how to nest a list inside another list.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// A list allows us to organize and decorate sets of paragraphs with prefix symbols and indents.
// We can create nested lists by increasing the indent level.
// We can begin and end a list by using a document builder's "ListFormat" property.
// Each paragraph that we add between a list's start and the end will become an item in the list.
// Create an outline list for the headings.
List outlineList = doc.getLists().add(ListTemplate.OUTLINE_NUMBERS);
builder.getListFormat().setList(outlineList);
builder.getParagraphFormat().setStyleIdentifier(StyleIdentifier.HEADING_1);
builder.writeln("This is my Chapter 1");
// Create a numbered list.
List numberedList = doc.getLists().add(ListTemplate.NUMBER_DEFAULT);
builder.getListFormat().setList(numberedList);
builder.getParagraphFormat().setStyleIdentifier(StyleIdentifier.NORMAL);
builder.writeln("Numbered list item 1.");
// Every paragraph that comprises a list will have this flag.
Assert.assertTrue(builder.getCurrentParagraph().isListItem());
Assert.assertTrue(builder.getParagraphFormat().isListItem());
// Create a bulleted list.
List bulletedList = doc.getLists().add(ListTemplate.BULLET_DEFAULT);
builder.getListFormat().setList(bulletedList);
builder.getParagraphFormat().setLeftIndent(72.0);
builder.writeln("Bulleted list item 1.");
builder.writeln("Bulleted list item 2.");
builder.getParagraphFormat().clearFormatting();
// Revert to the numbered list.
builder.getListFormat().setList(numberedList);
builder.writeln("Numbered list item 2.");
builder.writeln("Numbered list item 3.");
// Revert to the outline list.
builder.getListFormat().setList(outlineList);
builder.getParagraphFormat().setStyleIdentifier(StyleIdentifier.HEADING_1);
builder.writeln("This is my Chapter 2");
builder.getParagraphFormat().clearFormatting();
builder.getDocument().save(getArtifactsDir() + "Lists.NestedLists.docx");
value - The position for a drop cap text. The value must be one of DropCapPosition constants.public Shading getShading()
Shading object that refers to the shading formatting for the paragraph.
Examples:
Shows how to decorate text with borders and shading.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
BorderCollection borders = builder.getParagraphFormat().getBorders();
borders.setDistanceFromText(20.0);
borders.getByBorderType(BorderType.LEFT).setLineStyle(LineStyle.DOUBLE);
borders.getByBorderType(BorderType.RIGHT).setLineStyle(LineStyle.DOUBLE);
borders.getByBorderType(BorderType.TOP).setLineStyle(LineStyle.DOUBLE);
borders.getByBorderType(BorderType.BOTTOM).setLineStyle(LineStyle.DOUBLE);
Shading shading = builder.getParagraphFormat().getShading();
shading.setTexture(TextureIndex.TEXTURE_DIAGONAL_CROSS);
shading.setBackgroundPatternColor(new Color(240, 128, 128)); // Light Coral
shading.setForegroundPatternColor(new Color(255, 160, 122)); // Light Salmon
builder.write("This paragraph is formatted with a double border and shading.");
doc.save(getArtifactsDir() + "DocumentBuilder.ApplyBordersAndShading.docx");
Shading object that refers to the shading formatting for the paragraph.public BorderCollection getBorders()
Examples:
Shows how to insert a paragraph with a top border.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Border topBorder = builder.getParagraphFormat().getBorders().getByBorderType(BorderType.TOP);
topBorder.setLineWidth(4.0d);
topBorder.setLineStyle(LineStyle.DASH_SMALL_GAP);
// Set ThemeColor only when LineWidth or LineStyle setted.
topBorder.setThemeColor(ThemeColor.ACCENT_1);
topBorder.setTintAndShade(0.25d);
builder.writeln("Text with a top border.");
doc.save(getArtifactsDir() + "Border.ParagraphTopBorder.docx");
public Style getStyle()
Examples:
Shows how to create and use a paragraph style with list formatting.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Create a custom paragraph style.
Style style = doc.getStyles().add(StyleType.PARAGRAPH, "MyStyle1");
style.getFont().setSize(24.0);
style.getFont().setName("Verdana");
style.getParagraphFormat().setSpaceAfter(12.0);
// Create a list and make sure the paragraphs that use this style will use this list.
style.getListFormat().setList(doc.getLists().add(ListTemplate.BULLET_DEFAULT));
style.getListFormat().setListLevelNumber(0);
// Apply the paragraph style to the document builder's current paragraph, and then add some text.
builder.getParagraphFormat().setStyle(style);
builder.writeln("Hello World: MyStyle1, bulleted list.");
// Change the document builder's style to one that has no list formatting and write another paragraph.
builder.getParagraphFormat().setStyle(doc.getStyles().get("Normal"));
builder.writeln("Hello World: Normal.");
builder.getDocument().save(getArtifactsDir() + "Styles.ParagraphStyleBulletedList.docx");
public void setStyle(Style value)
Examples:
Shows how to create and use a paragraph style with list formatting.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Create a custom paragraph style.
Style style = doc.getStyles().add(StyleType.PARAGRAPH, "MyStyle1");
style.getFont().setSize(24.0);
style.getFont().setName("Verdana");
style.getParagraphFormat().setSpaceAfter(12.0);
// Create a list and make sure the paragraphs that use this style will use this list.
style.getListFormat().setList(doc.getLists().add(ListTemplate.BULLET_DEFAULT));
style.getListFormat().setListLevelNumber(0);
// Apply the paragraph style to the document builder's current paragraph, and then add some text.
builder.getParagraphFormat().setStyle(style);
builder.writeln("Hello World: MyStyle1, bulleted list.");
// Change the document builder's style to one that has no list formatting and write another paragraph.
builder.getParagraphFormat().setStyle(doc.getStyles().get("Normal"));
builder.writeln("Hello World: Normal.");
builder.getDocument().save(getArtifactsDir() + "Styles.ParagraphStyleBulletedList.docx");
value - The paragraph style applied to this formatting.public java.lang.String getStyleName()
Examples:
Shows how to construct an Aspose.Words document by hand.
Document doc = new Document();
// A blank document contains one section, one body and one paragraph.
// Call the "RemoveAllChildren" method to remove all those nodes,
// and end up with a document node with no children.
doc.removeAllChildren();
// This document now has no composite child nodes that we can add content to.
// If we wish to edit it, we will need to repopulate its node collection.
// First, create a new section, and then append it as a child to the root document node.
Section section = new Section(doc);
doc.appendChild(section);
// Set some page setup properties for the section.
section.getPageSetup().setSectionStart(SectionStart.NEW_PAGE);
section.getPageSetup().setPaperSize(PaperSize.LETTER);
// A section needs a body, which will contain and display all its contents
// on the page between the section's header and footer.
Body body = new Body(doc);
section.appendChild(body);
// Create a paragraph, set some formatting properties, and then append it as a child to the body.
Paragraph para = new Paragraph(doc);
para.getParagraphFormat().setStyleName("Heading 1");
para.getParagraphFormat().setAlignment(ParagraphAlignment.CENTER);
body.appendChild(para);
// Finally, add some content to do the document. Create a run,
// set its appearance and contents, and then append it as a child to the paragraph.
Run run = new Run(doc);
run.setText("Hello World!");
run.getFont().setColor(Color.RED);
para.appendChild(run);
Assert.assertEquals("Hello World!", doc.getText().trim());
doc.save(getArtifactsDir() + "Section.CreateManually.docx");
public void setStyleName(java.lang.String value)
Examples:
Shows how to construct an Aspose.Words document by hand.
Document doc = new Document();
// A blank document contains one section, one body and one paragraph.
// Call the "RemoveAllChildren" method to remove all those nodes,
// and end up with a document node with no children.
doc.removeAllChildren();
// This document now has no composite child nodes that we can add content to.
// If we wish to edit it, we will need to repopulate its node collection.
// First, create a new section, and then append it as a child to the root document node.
Section section = new Section(doc);
doc.appendChild(section);
// Set some page setup properties for the section.
section.getPageSetup().setSectionStart(SectionStart.NEW_PAGE);
section.getPageSetup().setPaperSize(PaperSize.LETTER);
// A section needs a body, which will contain and display all its contents
// on the page between the section's header and footer.
Body body = new Body(doc);
section.appendChild(body);
// Create a paragraph, set some formatting properties, and then append it as a child to the body.
Paragraph para = new Paragraph(doc);
para.getParagraphFormat().setStyleName("Heading 1");
para.getParagraphFormat().setAlignment(ParagraphAlignment.CENTER);
body.appendChild(para);
// Finally, add some content to do the document. Create a run,
// set its appearance and contents, and then append it as a child to the paragraph.
Run run = new Run(doc);
run.setText("Hello World!");
run.getFont().setColor(Color.RED);
para.appendChild(run);
Assert.assertEquals("Hello World!", doc.getText().trim());
doc.save(getArtifactsDir() + "Section.CreateManually.docx");
value - The name of the paragraph style applied to this formatting.public int getStyleIdentifier()
Examples:
Shows how to insert a Table of contents (TOC) into a document using heading styles as entries.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Insert a table of contents for the first page of the document.
// Configure the table to pick up paragraphs with headings of levels 1 to 3.
// Also, set its entries to be hyperlinks that will take us
// to the location of the heading when left-clicked in Microsoft Word.
builder.insertTableOfContents("\\o \"1-3\" \\h \\z \\u");
builder.insertBreak(BreakType.PAGE_BREAK);
// Populate the table of contents by adding paragraphs with heading styles.
// Each such heading with a level between 1 and 3 will create an entry in the table.
builder.getParagraphFormat().setStyleIdentifier(StyleIdentifier.HEADING_1);
builder.writeln("Heading 1");
builder.getParagraphFormat().setStyleIdentifier(StyleIdentifier.HEADING_2);
builder.writeln("Heading 1.1");
builder.writeln("Heading 1.2");
builder.getParagraphFormat().setStyleIdentifier(StyleIdentifier.HEADING_1);
builder.writeln("Heading 2");
builder.writeln("Heading 3");
builder.getParagraphFormat().setStyleIdentifier(StyleIdentifier.HEADING_2);
builder.writeln("Heading 3.1");
builder.getParagraphFormat().setStyleIdentifier(StyleIdentifier.HEADING_3);
builder.writeln("Heading 3.1.1");
builder.writeln("Heading 3.1.2");
builder.writeln("Heading 3.1.3");
builder.getParagraphFormat().setStyleIdentifier(StyleIdentifier.HEADING_4);
builder.writeln("Heading 3.1.3.1");
builder.writeln("Heading 3.1.3.2");
builder.getParagraphFormat().setStyleIdentifier(StyleIdentifier.HEADING_2);
builder.writeln("Heading 3.2");
builder.writeln("Heading 3.3");
// A table of contents is a field of a type that needs to be updated to show an up-to-date result.
doc.updateFields();
doc.save(getArtifactsDir() + "DocumentBuilder.InsertToc.docx");
StyleIdentifier constants.public void setStyleIdentifier(int value)
Examples:
Shows how to insert a Table of contents (TOC) into a document using heading styles as entries.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Insert a table of contents for the first page of the document.
// Configure the table to pick up paragraphs with headings of levels 1 to 3.
// Also, set its entries to be hyperlinks that will take us
// to the location of the heading when left-clicked in Microsoft Word.
builder.insertTableOfContents("\\o \"1-3\" \\h \\z \\u");
builder.insertBreak(BreakType.PAGE_BREAK);
// Populate the table of contents by adding paragraphs with heading styles.
// Each such heading with a level between 1 and 3 will create an entry in the table.
builder.getParagraphFormat().setStyleIdentifier(StyleIdentifier.HEADING_1);
builder.writeln("Heading 1");
builder.getParagraphFormat().setStyleIdentifier(StyleIdentifier.HEADING_2);
builder.writeln("Heading 1.1");
builder.writeln("Heading 1.2");
builder.getParagraphFormat().setStyleIdentifier(StyleIdentifier.HEADING_1);
builder.writeln("Heading 2");
builder.writeln("Heading 3");
builder.getParagraphFormat().setStyleIdentifier(StyleIdentifier.HEADING_2);
builder.writeln("Heading 3.1");
builder.getParagraphFormat().setStyleIdentifier(StyleIdentifier.HEADING_3);
builder.writeln("Heading 3.1.1");
builder.writeln("Heading 3.1.2");
builder.writeln("Heading 3.1.3");
builder.getParagraphFormat().setStyleIdentifier(StyleIdentifier.HEADING_4);
builder.writeln("Heading 3.1.3.1");
builder.writeln("Heading 3.1.3.2");
builder.getParagraphFormat().setStyleIdentifier(StyleIdentifier.HEADING_2);
builder.writeln("Heading 3.2");
builder.writeln("Heading 3.3");
// A table of contents is a field of a type that needs to be updated to show an up-to-date result.
doc.updateFields();
doc.save(getArtifactsDir() + "DocumentBuilder.InsertToc.docx");
value - The locale independent style identifier of the paragraph style applied to this formatting. The value must be one of StyleIdentifier constants.public boolean getSnapToGrid()
Examples:
Shows how to specify a limit for the number of lines that each page may have.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Enable pitching, and then use it to set the number of lines per page in this section.
// A large enough font size will push some lines down onto the next page to avoid overlapping characters.
builder.getPageSetup().setLayoutMode(SectionLayoutMode.LINE_GRID);
builder.getPageSetup().setLinesPerPage(15);
builder.getParagraphFormat().setSnapToGrid(true);
for (int i = 0; i < 30; i++)
builder.write("Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. ");
doc.save(getArtifactsDir() + "PageSetup.LinesPerPage.docx");
boolean value.public void setSnapToGrid(boolean value)
Examples:
Shows how to specify a limit for the number of lines that each page may have.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Enable pitching, and then use it to set the number of lines per page in this section.
// A large enough font size will push some lines down onto the next page to avoid overlapping characters.
builder.getPageSetup().setLayoutMode(SectionLayoutMode.LINE_GRID);
builder.getPageSetup().setLinesPerPage(15);
builder.getParagraphFormat().setSnapToGrid(true);
for (int i = 0; i < 30; i++)
builder.write("Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. ");
doc.save(getArtifactsDir() + "PageSetup.LinesPerPage.docx");
value - The corresponding boolean value.public TabStopCollection getTabStops()
Examples:
Shows how to modify the position of the right tab stop in TOC related paragraphs.
Document doc = new Document(getMyDir() + "Table of contents.docx");
// Iterate through all paragraphs with TOC result-based styles; this is any style between TOC and TOC9.
for (Paragraph para : (Iterable<Paragraph>) doc.getChildNodes(NodeType.PARAGRAPH, true)) {
if (para.getParagraphFormat().getStyle().getStyleIdentifier() >= StyleIdentifier.TOC_1
&& para.getParagraphFormat().getStyle().getStyleIdentifier() <= StyleIdentifier.TOC_9) {
// Get the first tab used in this paragraph, this should be the tab used to align the page numbers.
TabStop tab = para.getParagraphFormat().getTabStops().get(0);
// Replace the first default tab, stop with a custom tab stop.
para.getParagraphFormat().getTabStops().removeByPosition(tab.getPosition());
para.getParagraphFormat().getTabStops().add(tab.getPosition() - 50.0, tab.getAlignment(), tab.getLeader());
}
}
doc.save(getArtifactsDir() + "Styles.ChangeTocsTabStops.docx");
public java.lang.Object getDirectBorderAttr(int key)
public java.lang.Object fetchInheritedBorderAttr(int key)
public void setBorderAttr(int key,
java.lang.Object value)
public java.lang.Object fetchInheritedShadingAttr(int key)