public class Font
You do not create instances of the Example: Example: Example:
DocumentBuilder builder = new DocumentBuilder();
builder.getFont().getBorder().setColor(Color.GREEN);
builder.getFont().getBorder().setLineWidth(2.5);
builder.getFont().getBorder().setLineStyle(LineStyle.DASH_DOT_STROKER);
builder.write("run of text in a green border");
// Create an empty document. It contains one empty paragraph.
Document doc = new Document();
// Create a new run of text.
Run run = new Run(doc, "Hello");
// Specify character formatting for the run of text.
Font f = run.getFont();
f.setName("Courier New");
f.setSize(36);
f.setHighlightColor(Color.YELLOW);
// Append the run of text to the end of the first paragraph
// in the body of the first section of the document.
doc.getFirstSection().getBody().getFirstParagraph().appendChild(run);
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Create a paragraph style and specify some formatting for it.
Style style = doc.getStyles().add(StyleType.PARAGRAPH, "MyStyle1");
style.getFont().setSize(24);
style.getFont().setName("Verdana");
style.getParagraphFormat().setSpaceAfter(12);
// 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 current paragraph in the document and add some text.
builder.getParagraphFormat().setStyle(style);
builder.writeln("Hello World: MyStyle1, bulleted.");
// Change to a paragraph style that has no list formatting.
builder.getParagraphFormat().setStyle(doc.getStyles().get("Normal"));
builder.writeln("Hello World: Normal.");
builder.getDocument().save(getArtifactsDir() + "Lists.ParagraphStyleBulleted.doc");
Property Getters/Setters Summary | ||
---|---|---|
boolean | getAllCaps() | |
void | setAllCaps(booleanvalue) | |
True if the font is formatted as all capital letters. | ||
java.awt.Color | getAutoColor() | |
Returns the present calculated color of the text (black or white) to be used for 'auto color'.
If the color is not 'auto' then returns |
||
boolean | getBidi() | |
void | setBidi(booleanvalue) | |
Specifies whether the contents of this run shall have right-to-left characteristics. | ||
boolean | getBold() | |
void | setBold(booleanvalue) | |
True if the font is formatted as bold. | ||
boolean | getBoldBi() | |
void | setBoldBi(booleanvalue) | |
True if the right-to-left text is formatted as bold. | ||
Border | getBorder() | |
Returns a Border object that specifies border for the font.
|
||
java.awt.Color | getColor() | |
void | setColor(java.awt.Colorvalue) | |
Gets or sets the color of the font. | ||
boolean | getComplexScript() | |
void | setComplexScript(booleanvalue) | |
Specifies whether the contents of this run shall be treated as complex script text regardless of their Unicode character values when determining the formatting for this run. | ||
boolean | getDoubleStrikeThrough() | |
void | setDoubleStrikeThrough(booleanvalue) | |
True if the font is formatted as double strikethrough text. | ||
boolean | getEmboss() | |
void | setEmboss(booleanvalue) | |
True if the font is formatted as embossed. | ||
boolean | getEngrave() | |
void | setEngrave(booleanvalue) | |
True if the font is formatted as engraved. | ||
boolean | getHidden() | |
void | setHidden(booleanvalue) | |
True if the font is formatted as hidden text. | ||
java.awt.Color | getHighlightColor() | |
void | setHighlightColor(java.awt.Colorvalue) | |
Gets or sets the highlight (marker) color. | ||
boolean | getItalic() | |
void | setItalic(booleanvalue) | |
True if the font is formatted as italic. | ||
boolean | getItalicBi() | |
void | setItalicBi(booleanvalue) | |
True if the right-to-left text is formatted as italic. | ||
double | getKerning() | |
void | setKerning(doublevalue) | |
Gets or sets the font size at which kerning starts. | ||
double | getLineSpacing() | |
Returns line spacing of this font (in points).
|
||
int | getLocaleId() | |
void | setLocaleId(intvalue) | |
Gets or sets the locale identifier (language) of the formatted characters. | ||
int | getLocaleIdBi() | |
void | setLocaleIdBi(intvalue) | |
Gets or sets the locale identifier (language) of the formatted right-to-left characters. | ||
int | getLocaleIdFarEast() | |
void | setLocaleIdFarEast(intvalue) | |
Gets or sets the locale identifier (language) of the formatted Asian characters. | ||
java.lang.String | getName() | |
void | setName(java.lang.Stringvalue) | |
Gets or sets the name of the font. | ||
java.lang.String | getNameAscii() | |
void | setNameAscii(java.lang.Stringvalue) | |
Returns or sets the font used for Latin text (characters with character codes from 0 (zero) through 127). | ||
java.lang.String | getNameBi() | |
void | setNameBi(java.lang.Stringvalue) | |
Returns or sets the name of the font in a right-to-left language document. | ||
java.lang.String | getNameFarEast() | |
void | setNameFarEast(java.lang.Stringvalue) | |
Returns or sets an East Asian font name. | ||
java.lang.String | getNameOther() | |
void | setNameOther(java.lang.Stringvalue) | |
Returns or sets the font used for characters with character codes from 128 through 255. | ||
boolean | getNoProofing() | |
void | setNoProofing(booleanvalue) | |
True when the formatted characters are not to be spell checked. | ||
boolean | getOutline() | |
void | setOutline(booleanvalue) | |
True if the font is formatted as outline. | ||
double | getPosition() | |
void | setPosition(doublevalue) | |
Gets or sets the position of text (in points) relative to the base line. A positive number raises the text, and a negative number lowers it. | ||
int | getScaling() | |
void | setScaling(intvalue) | |
Gets or sets character width scaling in percent. | ||
Shading | getShading() | |
Returns a Shading object that refers to the shading formatting for the font.
|
||
boolean | getShadow() | |
void | setShadow(booleanvalue) | |
True if the font is formatted as shadowed. | ||
double | getSize() | |
void | setSize(doublevalue) | |
Gets or sets the font size in points. | ||
double | getSizeBi() | |
void | setSizeBi(doublevalue) | |
Gets or sets the font size in points used in a right-to-left document. | ||
boolean | getSmallCaps() | |
void | setSmallCaps(booleanvalue) | |
True if the font is formatted as small capital letters. | ||
double | getSpacing() | |
void | setSpacing(doublevalue) | |
Returns or sets the spacing (in points) between characters . | ||
boolean | getStrikeThrough() | |
void | setStrikeThrough(booleanvalue) | |
True if the font is formatted as strikethrough text. | ||
Style | getStyle() | |
void | ||
Gets or sets the character style applied to this formatting. | ||
int | getStyleIdentifier() | |
void | setStyleIdentifier(intvalue) | |
Gets or sets the locale independent style identifier of the character style applied to this formatting. The value of the property is StyleIdentifier integer constant. | ||
java.lang.String | getStyleName() | |
void | setStyleName(java.lang.Stringvalue) | |
Gets or sets the name of the character style applied to this formatting. | ||
boolean | getSubscript() | |
void | setSubscript(booleanvalue) | |
True if the font is formatted as subscript. | ||
boolean | getSuperscript() | |
void | setSuperscript(booleanvalue) | |
True if the font is formatted as superscript. | ||
int | getTextEffect() | |
void | setTextEffect(intvalue) | |
Gets or sets the font animation effect. The value of the property is TextEffect integer constant. | ||
int | getUnderline() | |
void | setUnderline(intvalue) | |
Gets or sets the type of underline applied to the font. The value of the property is Underline integer constant. | ||
java.awt.Color | getUnderlineColor() | |
void | setUnderlineColor(java.awt.Colorvalue) | |
Gets or sets the color of the underline applied to the font. |
Method Summary | ||
---|---|---|
void | clearFormatting() | |
Resets to default font formatting.
|
||
boolean | hasDmlEffect(int dmlEffectType) | |
Checks if particular DrawingML text effect is applied.
|
public boolean getAllCaps() / public void setAllCaps(boolean value)
Example:
Shows how to use all capitals and small capitals character formatting properties.// Create an empty document. It contains one empty paragraph. Document doc = new Document(); // Get the paragraph from the document, we will be adding runs of text to it. Paragraph para = (Paragraph) doc.getChild(NodeType.PARAGRAPH, 0, true); Run run = new Run(doc, "All capitals"); run.getFont().setAllCaps(true); para.appendChild(run); run = new Run(doc, "SMALL CAPITALS"); run.getFont().setSmallCaps(true); para.appendChild(run);
public java.awt.Color getAutoColor()
When text has 'automatic color', the actual color of text is calculated automatically so that it is readable against the background color. As you change the background color, the text color will automatically switch to black or white in MS Word to maximize legibility.
Example:
Shows how calculated color of the text (black or white) to be used for 'auto color'Run run = new Run(new Document()); // Remove direct color, so it can be calculated automatically with Font.AutoColor. run.getFont().setColor(new Color(0, 0, 0, 0)); // When we set black color for background, autocolor for font must be white run.getFont().getShading().setBackgroundPatternColor(Color.BLACK); Assert.assertEquals(run.getFont().getAutoColor(), Color.WHITE); // When we set white color for background, autocolor for font must be black run.getFont().getShading().setBackgroundPatternColor(Color.WHITE); Assert.assertEquals(run.getFont().getAutoColor(), Color.BLACK);
public boolean getBidi() / public void setBidi(boolean value)
This property, when on, shall not be used with strongly left-to-right text. Any behavior under that condition is unspecified. This property, when off, shall not be used with strong right-to-left text. Any behavior under that condition is unspecified.
When the contents of this run are displayed, all characters shall be treated as complex script characters for formatting
purposes. This means that
Also, when the contents of this run are displayed, this property acts as a right-to-left override for characters which are classified as "weak types" and "neutral types".
Example:
Shows how to insert and format right-to-left text.DocumentBuilder builder = new DocumentBuilder(); // Signal to Microsoft Word that this run of text contains right-to-left text. builder.getFont().setBidi(true); // Specify the font and font size to be used for the right-to-left text. builder.getFont().setNameBi("Andalus"); builder.getFont().setSizeBi(48); // Specify that the right-to-left text in this run is bold and italic. builder.getFont().setItalicBi(true); builder.getFont().setBoldBi(true); // Specify the locale so Microsoft Word recognizes this text as Arabic - Saudi Arabia. // For the list of locale identifiers see https://docs.microsoft.com/en-us/deployoffice/office2016/language-identifiers-and-optionstate-id-values-in-office-2016 builder.getFont().setLocaleIdBi(1025); // Insert some Arabic text. builder.writeln("مرحبًا"); builder.getDocument().save(getArtifactsDir() + "Font.Bidi.doc");
public boolean getBold() / public void setBold(boolean value)
Example:
Inserts formatted text using DocumentBuilder.DocumentBuilder builder = new DocumentBuilder(); // Specify font formatting before adding text. Font font = builder.getFont(); font.setSize(16); font.setBold(true); font.setColor(Color.BLUE); font.setName("Arial"); font.setUnderline(Underline.DASH); builder.write("Sample text.");
public boolean getBoldBi() / public void setBoldBi(boolean value)
Example:
Shows how to insert and format right-to-left text.DocumentBuilder builder = new DocumentBuilder(); // Signal to Microsoft Word that this run of text contains right-to-left text. builder.getFont().setBidi(true); // Specify the font and font size to be used for the right-to-left text. builder.getFont().setNameBi("Andalus"); builder.getFont().setSizeBi(48); // Specify that the right-to-left text in this run is bold and italic. builder.getFont().setItalicBi(true); builder.getFont().setBoldBi(true); // Specify the locale so Microsoft Word recognizes this text as Arabic - Saudi Arabia. // For the list of locale identifiers see https://docs.microsoft.com/en-us/deployoffice/office2016/language-identifiers-and-optionstate-id-values-in-office-2016 builder.getFont().setLocaleIdBi(1025); // Insert some Arabic text. builder.writeln("مرحبًا"); builder.getDocument().save(getArtifactsDir() + "Font.Bidi.doc");
public Border getBorder()
Example:
Inserts a String surrounded by a border into a document.DocumentBuilder builder = new DocumentBuilder(); builder.getFont().getBorder().setColor(Color.GREEN); builder.getFont().getBorder().setLineWidth(2.5); builder.getFont().getBorder().setLineStyle(LineStyle.DASH_DOT_STROKER); builder.write("run of text in a green border");
public java.awt.Color getColor() / public void setColor(java.awt.Color value)
Example:
Inserts formatted text using DocumentBuilder.DocumentBuilder builder = new DocumentBuilder(); // Specify font formatting before adding text. Font font = builder.getFont(); font.setSize(16); font.setBold(true); font.setColor(Color.BLUE); font.setName("Arial"); font.setUnderline(Underline.DASH); builder.write("Sample text.");
Example:
Inserts a hyperlink into a document using DocumentBuilder.Document doc = new Document(); DocumentBuilder builder = new DocumentBuilder(doc); builder.write("Please make sure to visit "); // Specify font formatting for the hyperlink. builder.getFont().setColor(Color.BLUE); builder.getFont().setUnderline(Underline.SINGLE); // Insert the link. builder.insertHyperlink("Aspose Website", "http://www.aspose.com", false); // Revert to default formatting. builder.getFont().clearFormatting(); builder.write(" for more information."); doc.save(getArtifactsDir() + "DocumentBuilder.InsertHyperlink.doc");
public boolean getComplexScript() / public void setComplexScript(boolean value)
Example:
Shows how to make a run that's always treated as complex script.Run run = new Run(doc, "Complex script"); run.getFont().setComplexScript(true);
public boolean getDoubleStrikeThrough() / public void setDoubleStrikeThrough(boolean value)
Example:
Shows how to use strike-through character formatting properties.// Create an empty document. It contains one empty paragraph. Document doc = new Document(); // Get the paragraph from the document, we will be adding runs of text to it. Paragraph para = (Paragraph) doc.getChild(NodeType.PARAGRAPH, 0, true); Run run = new Run(doc, "Double strike through text"); run.getFont().setDoubleStrikeThrough(true); para.appendChild(run); run = new Run(doc, "Single strike through text"); run.getFont().setStrikeThrough(true); para.appendChild(run);
public boolean getEmboss() / public void setEmboss(boolean value)
Example:
Shows how to create a run of formatted text.Run run = new Run(doc, "Hello"); run.getFont().setEmboss(true); run.getFont().setItalic(true);
public boolean getEngrave() / public void setEngrave(boolean value)
Example:
Shows how to create a run of text formatted as engraved.Run run = new Run(doc, "Hello"); run.getFont().setEngrave(true);
public boolean getHidden() / public void setHidden(boolean value)
Example:
Shows how to create a hidden run of text.Run run = new Run(doc, "Hello"); run.getFont().setHidden(true);
Example:
Implements the Visitor Pattern to remove all content formatted as hidden from the document.public void removeHiddenContentFromDocument() throws Exception { // Open the document we want to remove hidden content from. Document doc = new Document(getMyDir() + "Font.Hidden.doc"); // Create an object that inherits from the DocumentVisitor class. RemoveHiddenContentVisitor hiddenContentRemover = new RemoveHiddenContentVisitor(); // This is the well known Visitor pattern. Get the model to accept a visitor. // The model will iterate through itself by calling the corresponding methods // on the visitor object (this is called visiting). // We can run it over the entire the document like so: doc.accept(hiddenContentRemover); // Or we can run it on only a specific node. Paragraph para = (Paragraph) doc.getChild(NodeType.PARAGRAPH, 4, true); para.accept(hiddenContentRemover); // Or over a different type of node like below. Table table = (Table) doc.getChild(NodeType.TABLE, 0, true); table.accept(hiddenContentRemover); doc.save(getArtifactsDir() + "Font.Hidden.doc"); } /** * This class when executed will remove all hidden content from the Document. Implemented as a Visitor. */ private class RemoveHiddenContentVisitor extends DocumentVisitor { /** * Called when a FieldStart node is encountered in the document. */ public int visitFieldStart(final FieldStart fieldStart) throws Exception { // If this node is hidden, then remove it. if (isHidden(fieldStart)) { fieldStart.remove(); } return VisitorAction.CONTINUE; } /** * Called when a FieldEnd node is encountered in the document. */ public int visitFieldEnd(final FieldEnd fieldEnd) throws Exception { if (isHidden(fieldEnd)) { fieldEnd.remove(); } return VisitorAction.CONTINUE; } /** * Called when a FieldSeparator node is encountered in the document. */ public int visitFieldSeparator(final FieldSeparator fieldSeparator) throws Exception { if (isHidden(fieldSeparator)) { fieldSeparator.remove(); } return VisitorAction.CONTINUE; } /** * Called when a Run node is encountered in the document. */ public int visitRun(final Run run) throws Exception { if (isHidden(run)) { run.remove(); } return VisitorAction.CONTINUE; } /** * Called when a Paragraph node is encountered in the document. */ public int visitParagraphStart(final Paragraph paragraph) throws Exception { if (isHidden(paragraph)) { paragraph.remove(); } return VisitorAction.CONTINUE; } /** * Called when a FormField is encountered in the document. */ public int visitFormField(final FormField field) throws Exception { if (isHidden(field)) { field.remove(); } return VisitorAction.CONTINUE; } /** * Called when a GroupShape is encountered in the document. */ public int visitGroupShapeStart(final GroupShape groupShape) throws Exception { if (isHidden(groupShape)) { groupShape.remove(); } return VisitorAction.CONTINUE; } /** * Called when a Shape is encountered in the document. */ public int visitShapeStart(final Shape shape) throws Exception { if (isHidden(shape)) { shape.remove(); } return VisitorAction.CONTINUE; } /** * Called when a Comment is encountered in the document. */ public int visitCommentStart(final Comment comment) throws Exception { if (isHidden(comment)) { comment.remove(); } return VisitorAction.CONTINUE; } /** * Called when a Footnote is encountered in the document. */ public int visitFootnoteStart(final Footnote footnote) throws Exception { if (isHidden(footnote)) { footnote.remove(); } return VisitorAction.CONTINUE; } /** * Called when visiting of a Table node is ended in the document. */ public int visitTableEnd(final Table table) { // At the moment there is no way to tell if a particular Table/Row/Cell is hidden. // Instead, if the content of a table is hidden, then all inline child nodes of the table should be // hidden and thus removed by previous visits as well. This will result in the container being empty // so if this is the case we know to remove the table node. // // Note that a table which is not hidden but simply has no content will not be affected by this algorthim, // as technically they are not completely empty (for example a properly formed Cell will have at least // an empty paragraph in it) if (!table.hasChildNodes()) { table.remove(); } return VisitorAction.CONTINUE; } /** * Called when visiting of a Cell node is ended in the document. */ public int visitCellEnd(final Cell cell) { if (!cell.hasChildNodes() && cell.getParentNode() != null) { cell.remove(); } return VisitorAction.CONTINUE; } /** * Called when visiting of a Row node is ended in the document. */ public int visitRowEnd(final Row row) { if (!row.hasChildNodes() && row.getParentNode() != null) { row.remove(); } return VisitorAction.CONTINUE; } /** * Called when a SpecialCharacter is encountered in the document. */ public int visitSpecialChar(final SpecialChar character) throws Exception { if (isHidden(character)) { character.remove(); } return VisitorAction.CONTINUE; } /** * Returns true if the node passed is set as hidden, returns false if it is visible. */ private boolean isHidden(final Node node) { if (node instanceof Inline) { // If the node is Inline then cast it to retrieve the Font property which contains the hidden property Inline currentNode = (Inline) node; return currentNode.getFont().getHidden(); } else if (node.getNodeType() == NodeType.PARAGRAPH) { // If the node is a paragraph cast it to retrieve the ParagraphBreakFont which contains the hidden property Paragraph para = (Paragraph) node; return para.getParagraphBreakFont().getHidden(); } else if (node instanceof ShapeBase) { // Node is a shape or groupshape. ShapeBase shape = (ShapeBase) node; return shape.getFont().getHidden(); } else if (node instanceof InlineStory) { // Node is a comment or footnote. InlineStory inlineStory = (InlineStory) node; return inlineStory.getFont().getHidden(); } // A node that is passed to this method which does not contain a hidden property will end up here. // By default nodes are not hidden so return false. return false; } }
public java.awt.Color getHighlightColor() / public void setHighlightColor(java.awt.Color value)
Example:
Shows how to add a formatted run of text to a document using the object model.// Create an empty document. It contains one empty paragraph. Document doc = new Document(); // Create a new run of text. Run run = new Run(doc, "Hello"); // Specify character formatting for the run of text. Font f = run.getFont(); f.setName("Courier New"); f.setSize(36); f.setHighlightColor(Color.YELLOW); // Append the run of text to the end of the first paragraph // in the body of the first section of the document. doc.getFirstSection().getBody().getFirstParagraph().appendChild(run);
public boolean getItalic() / public void setItalic(boolean value)
Example:
Shows how to create a run of formatted text.Run run = new Run(doc, "Hello"); run.getFont().setEmboss(true); run.getFont().setItalic(true);
public boolean getItalicBi() / public void setItalicBi(boolean value)
Example:
Shows how to insert and format right-to-left text.DocumentBuilder builder = new DocumentBuilder(); // Signal to Microsoft Word that this run of text contains right-to-left text. builder.getFont().setBidi(true); // Specify the font and font size to be used for the right-to-left text. builder.getFont().setNameBi("Andalus"); builder.getFont().setSizeBi(48); // Specify that the right-to-left text in this run is bold and italic. builder.getFont().setItalicBi(true); builder.getFont().setBoldBi(true); // Specify the locale so Microsoft Word recognizes this text as Arabic - Saudi Arabia. // For the list of locale identifiers see https://docs.microsoft.com/en-us/deployoffice/office2016/language-identifiers-and-optionstate-id-values-in-office-2016 builder.getFont().setLocaleIdBi(1025); // Insert some Arabic text. builder.writeln("مرحبًا"); builder.getDocument().save(getArtifactsDir() + "Font.Bidi.doc");
public double getKerning() / public void setKerning(double value)
Example:
Shows how to specify the font size at which kerning starts.Run run = new Run(doc, "Hello"); run.getFont().setKerning(24);
public double getLineSpacing()
Example:
Shows how to get line spacing of current font (in points)DocumentBuilder builder = new DocumentBuilder(new Document()); builder.getFont().setName("Calibri"); builder.writeln("qText"); // Obtain line spacing. Font font = builder.getDocument().getFirstSection().getBody().getFirstParagraph().getRuns().get(0).getFont(); System.out.println(MessageFormat.format("lineSpacing = {0}", font.getLineSpacing()));
public int getLocaleId() / public void setLocaleId(int value)
Example:
Shows how to specify the language of a text run so Microsoft Word can use a proper spell checker.//Create a run of text that contains Russian text. Run run = new Run(doc, "Привет"); //Specify the locale so Microsoft Word recognizes this text as Russian. //For the list of locale identifiers see https://docs.microsoft.com/en-us/deployoffice/office2016/language-identifiers-and-optionstate-id-values-in-office-2016 run.getFont().setLocaleId(1049);
public int getLocaleIdBi() / public void setLocaleIdBi(int value)
Example:
Shows how to insert and format right-to-left text.DocumentBuilder builder = new DocumentBuilder(); // Signal to Microsoft Word that this run of text contains right-to-left text. builder.getFont().setBidi(true); // Specify the font and font size to be used for the right-to-left text. builder.getFont().setNameBi("Andalus"); builder.getFont().setSizeBi(48); // Specify that the right-to-left text in this run is bold and italic. builder.getFont().setItalicBi(true); builder.getFont().setBoldBi(true); // Specify the locale so Microsoft Word recognizes this text as Arabic - Saudi Arabia. // For the list of locale identifiers see https://docs.microsoft.com/en-us/deployoffice/office2016/language-identifiers-and-optionstate-id-values-in-office-2016 builder.getFont().setLocaleIdBi(1025); // Insert some Arabic text. builder.writeln("مرحبًا"); builder.getDocument().save(getArtifactsDir() + "Font.Bidi.doc");
public int getLocaleIdFarEast() / public void setLocaleIdFarEast(int value)
Example:
Shows how to insert and format text in Chinese or any other Far East language.DocumentBuilder builder = new DocumentBuilder(); builder.getFont().setSize(48); // Specify the font name. Make sure it the font has the glyphs that you want to display. builder.getFont().setNameFarEast("SimSun"); // Specify the locale so Microsoft Word recognizes this text as Chinese. // For the list of locale identifiers see https://docs.microsoft.com/en-us/deployoffice/office2016/language-identifiers-and-optionstate-id-values-in-office-2016 builder.getFont().setLocaleIdFarEast(2052); // Insert some Chinese text. builder.writeln("你好世界"); builder.getDocument().save(getArtifactsDir() + "Font.FarEast.doc");
public java.lang.String getName() / public void setName(java.lang.String value)
When getting, returns
When setting, sets
Example:
Inserts formatted text using DocumentBuilder.DocumentBuilder builder = new DocumentBuilder(); // Specify font formatting before adding text. Font font = builder.getFont(); font.setSize(16); font.setBold(true); font.setColor(Color.BLUE); font.setName("Arial"); font.setUnderline(Underline.DASH); builder.write("Sample text.");
Example:
Shows how to add a formatted run of text to a document using the object model.// Create an empty document. It contains one empty paragraph. Document doc = new Document(); // Create a new run of text. Run run = new Run(doc, "Hello"); // Specify character formatting for the run of text. Font f = run.getFont(); f.setName("Courier New"); f.setSize(36); f.setHighlightColor(Color.YELLOW); // Append the run of text to the end of the first paragraph // in the body of the first section of the document. doc.getFirstSection().getBody().getFirstParagraph().appendChild(run);
public java.lang.String getNameAscii() / public void setNameAscii(java.lang.String value)
Example:
A pretty unusual example of how Microsoft Word can combine two different fonts in one run.DocumentBuilder builder = new DocumentBuilder(); // This tells Microsoft Word to use Arial for characters 0..127 and // Times New Roman for characters 128..255. // Looks like a pretty strange case to me, but it is possible. builder.getFont().setNameAscii("Arial"); builder.getFont().setNameOther("Times New Roman"); builder.writeln("Hello, Привет"); builder.getDocument().save(getArtifactsDir() + "Font.Names.doc");
public java.lang.String getNameBi() / public void setNameBi(java.lang.String value)
Example:
Shows how to insert and format right-to-left text.DocumentBuilder builder = new DocumentBuilder(); // Signal to Microsoft Word that this run of text contains right-to-left text. builder.getFont().setBidi(true); // Specify the font and font size to be used for the right-to-left text. builder.getFont().setNameBi("Andalus"); builder.getFont().setSizeBi(48); // Specify that the right-to-left text in this run is bold and italic. builder.getFont().setItalicBi(true); builder.getFont().setBoldBi(true); // Specify the locale so Microsoft Word recognizes this text as Arabic - Saudi Arabia. // For the list of locale identifiers see https://docs.microsoft.com/en-us/deployoffice/office2016/language-identifiers-and-optionstate-id-values-in-office-2016 builder.getFont().setLocaleIdBi(1025); // Insert some Arabic text. builder.writeln("مرحبًا"); builder.getDocument().save(getArtifactsDir() + "Font.Bidi.doc");
public java.lang.String getNameFarEast() / public void setNameFarEast(java.lang.String value)
Example:
Shows how to insert and format text in Chinese or any other Far East language.DocumentBuilder builder = new DocumentBuilder(); builder.getFont().setSize(48); // Specify the font name. Make sure it the font has the glyphs that you want to display. builder.getFont().setNameFarEast("SimSun"); // Specify the locale so Microsoft Word recognizes this text as Chinese. // For the list of locale identifiers see https://docs.microsoft.com/en-us/deployoffice/office2016/language-identifiers-and-optionstate-id-values-in-office-2016 builder.getFont().setLocaleIdFarEast(2052); // Insert some Chinese text. builder.writeln("你好世界"); builder.getDocument().save(getArtifactsDir() + "Font.FarEast.doc");
public java.lang.String getNameOther() / public void setNameOther(java.lang.String value)
Example:
A pretty unusual example of how Microsoft Word can combine two different fonts in one run.DocumentBuilder builder = new DocumentBuilder(); // This tells Microsoft Word to use Arial for characters 0..127 and // Times New Roman for characters 128..255. // Looks like a pretty strange case to me, but it is possible. builder.getFont().setNameAscii("Arial"); builder.getFont().setNameOther("Times New Roman"); builder.writeln("Hello, Привет"); builder.getDocument().save(getArtifactsDir() + "Font.Names.doc");
public boolean getNoProofing() / public void setNoProofing(boolean value)
Example:
Shows how to specify that the run of text is not to be spell checked by Microsoft Word.Run run = new Run(doc, "Hello"); run.getFont().setNoProofing(true);
public boolean getOutline() / public void setOutline(boolean value)
Example:
Shows how to create a run of text formatted as outline.Run run = new Run(doc, "Hello"); run.getFont().setOutline(true);
public double getPosition() / public void setPosition(double value)
Example:
Shows how to use subscript, superscript, complex script, text effects, and baseline text position properties.// Create an empty document. It contains one empty paragraph. Document doc = new Document(); // Get the paragraph from the document, we will be adding runs of text to it. Paragraph para = (Paragraph) doc.getChild(NodeType.PARAGRAPH, 0, true); // Add a run of text that is raised 5 points above the baseline. Run run = new Run(doc, "Raised text"); run.getFont().setPosition(5); para.appendChild(run); // Add a run of normal text. run = new Run(doc, "Normal text"); para.appendChild(run); // Add a run of text that appears as subscript. run = new Run(doc, "Subscript"); run.getFont().setSubscript(true); para.appendChild(run); // Add a run of text that appears as superscript. run = new Run(doc, "Superscript"); run.getFont().setSuperscript(true); para.appendChild(run);
public int getScaling() / public void setScaling(int value)
Example:
Shows how to use character scaling and spacing properties.// Create an empty document. It contains one empty paragraph. Document doc = new Document(); // Get the paragraph from the document, we will be adding runs of text to it. Paragraph para = (Paragraph) doc.getChild(NodeType.PARAGRAPH, 0, true); // Add a run of text with characters 150% width of normal characters. Run run = new Run(doc, "Wide characters"); run.getFont().setScaling(150); para.appendChild(run); // Add a run of text with extra 1pt space between characters. run = new Run(doc, "Expanded by 1pt"); run.getFont().setSpacing(1); para.appendChild(run); // Add a run of text with space between characters reduced by 1pt. run = new Run(doc, "Condensed by 1pt"); run.getFont().setSpacing(-1); para.appendChild(run);
public Shading getShading()
Example:
Shows how to apply shading for a run of text.DocumentBuilder builder = new DocumentBuilder(); Shading shd = builder.getFont().getShading(); shd.setTexture(TextureIndex.TEXTURE_DIAGONAL_CROSS); shd.setBackgroundPatternColor(Color.BLUE); shd.setForegroundPatternColor(new Color(138, 43, 226)); // Violet-blue builder.getFont().setColor(Color.WHITE); builder.writeln("White text on a blue background with texture.");
public boolean getShadow() / public void setShadow(boolean value)
Example:
Shows how to create a run of text formatted with a shadow.Run run = new Run(doc, "Hello"); run.getFont().setShadow(true);
public double getSize() / public void setSize(double value)
Example:
Inserts formatted text using DocumentBuilder.DocumentBuilder builder = new DocumentBuilder(); // Specify font formatting before adding text. Font font = builder.getFont(); font.setSize(16); font.setBold(true); font.setColor(Color.BLUE); font.setName("Arial"); font.setUnderline(Underline.DASH); builder.write("Sample text.");
Example:
Shows how to add a formatted run of text to a document using the object model.// Create an empty document. It contains one empty paragraph. Document doc = new Document(); // Create a new run of text. Run run = new Run(doc, "Hello"); // Specify character formatting for the run of text. Font f = run.getFont(); f.setName("Courier New"); f.setSize(36); f.setHighlightColor(Color.YELLOW); // Append the run of text to the end of the first paragraph // in the body of the first section of the document. doc.getFirstSection().getBody().getFirstParagraph().appendChild(run);
public double getSizeBi() / public void setSizeBi(double value)
Example:
Shows how to insert and format right-to-left text.DocumentBuilder builder = new DocumentBuilder(); // Signal to Microsoft Word that this run of text contains right-to-left text. builder.getFont().setBidi(true); // Specify the font and font size to be used for the right-to-left text. builder.getFont().setNameBi("Andalus"); builder.getFont().setSizeBi(48); // Specify that the right-to-left text in this run is bold and italic. builder.getFont().setItalicBi(true); builder.getFont().setBoldBi(true); // Specify the locale so Microsoft Word recognizes this text as Arabic - Saudi Arabia. // For the list of locale identifiers see https://docs.microsoft.com/en-us/deployoffice/office2016/language-identifiers-and-optionstate-id-values-in-office-2016 builder.getFont().setLocaleIdBi(1025); // Insert some Arabic text. builder.writeln("مرحبًا"); builder.getDocument().save(getArtifactsDir() + "Font.Bidi.doc");
public boolean getSmallCaps() / public void setSmallCaps(boolean value)
Example:
Shows how to use all capitals and small capitals character formatting properties.// Create an empty document. It contains one empty paragraph. Document doc = new Document(); // Get the paragraph from the document, we will be adding runs of text to it. Paragraph para = (Paragraph) doc.getChild(NodeType.PARAGRAPH, 0, true); Run run = new Run(doc, "All capitals"); run.getFont().setAllCaps(true); para.appendChild(run); run = new Run(doc, "SMALL CAPITALS"); run.getFont().setSmallCaps(true); para.appendChild(run);
public double getSpacing() / public void setSpacing(double value)
Example:
Shows how to use character scaling and spacing properties.// Create an empty document. It contains one empty paragraph. Document doc = new Document(); // Get the paragraph from the document, we will be adding runs of text to it. Paragraph para = (Paragraph) doc.getChild(NodeType.PARAGRAPH, 0, true); // Add a run of text with characters 150% width of normal characters. Run run = new Run(doc, "Wide characters"); run.getFont().setScaling(150); para.appendChild(run); // Add a run of text with extra 1pt space between characters. run = new Run(doc, "Expanded by 1pt"); run.getFont().setSpacing(1); para.appendChild(run); // Add a run of text with space between characters reduced by 1pt. run = new Run(doc, "Condensed by 1pt"); run.getFont().setSpacing(-1); para.appendChild(run);
public boolean getStrikeThrough() / public void setStrikeThrough(boolean value)
Example:
Shows how to use strike-through character formatting properties.// Create an empty document. It contains one empty paragraph. Document doc = new Document(); // Get the paragraph from the document, we will be adding runs of text to it. Paragraph para = (Paragraph) doc.getChild(NodeType.PARAGRAPH, 0, true); Run run = new Run(doc, "Double strike through text"); run.getFont().setDoubleStrikeThrough(true); para.appendChild(run); run = new Run(doc, "Single strike through text"); run.getFont().setStrikeThrough(true); para.appendChild(run);
public Style getStyle() / public void setStyle(Style value)
Example:
Applies double underline to all runs in a document that are formatted with custom character styles.Document doc = new Document(getMyDir() + "Font.Style.doc"); // Select all run nodes in the document. NodeCollection runs = doc.getChildNodes(NodeType.RUN, true); // Loop through every run node. for (Run run : (Iterable<Run>) runs) { Style charStyle = run.getFont().getStyle(); // If the style of the run is not a built-in character style, apply double underline. if (!charStyle.getBuiltIn()) { run.getFont().setUnderline(Underline.DOUBLE); } } doc.save(getArtifactsDir() + "Font.Style.doc");
public int getStyleIdentifier() / public void setStyleIdentifier(int value)
Example:
Shows how to use style identifier to find text formatted with a specific character style and apply different character style.Document doc = new Document(getMyDir() + "Font.StyleIdentifier.doc"); // Select all run nodes in the document. NodeCollection runs = doc.getChildNodes(NodeType.RUN, true); // Loop through every run node. for (Run run : (Iterable<Run>) runs) { // If the character style of the run is what we want, do what we need. Change the style in this case. // Note that using StyleIdentifier we can identify a built-in style regardless // of the language of Microsoft Word used to create the document. if (run.getFont().getStyleIdentifier() == StyleIdentifier.EMPHASIS) { run.getFont().setStyleIdentifier(StyleIdentifier.STRONG); } } doc.save(getArtifactsDir() + "Font.StyleIdentifier.doc");
public java.lang.String getStyleName() / public void setStyleName(java.lang.String value)
Example:
Shows how to use style name to find text formatted with a specific character style and apply different character style.Document doc = new Document(getMyDir() + "Font.StyleName.doc"); // Select all run nodes in the document. NodeCollection runs = doc.getChildNodes(NodeType.RUN, true); // Loop through every run node. for (Run run : (Iterable<Run>) runs) { // If the character style of the run is what we want, do what we need. Change the style in this case. // Note that names of built in styles could be different in documents // created by Microsoft Word versions for different languages. if (run.getFont().getStyleName().equals("Emphasis")) { run.getFont().setStyleName("Strong"); } } doc.save(getArtifactsDir() + "Font.StyleName.doc");
public boolean getSubscript() / public void setSubscript(boolean value)
Example:
Shows how to use subscript, superscript, complex script, text effects, and baseline text position properties.// Create an empty document. It contains one empty paragraph. Document doc = new Document(); // Get the paragraph from the document, we will be adding runs of text to it. Paragraph para = (Paragraph) doc.getChild(NodeType.PARAGRAPH, 0, true); // Add a run of text that is raised 5 points above the baseline. Run run = new Run(doc, "Raised text"); run.getFont().setPosition(5); para.appendChild(run); // Add a run of normal text. run = new Run(doc, "Normal text"); para.appendChild(run); // Add a run of text that appears as subscript. run = new Run(doc, "Subscript"); run.getFont().setSubscript(true); para.appendChild(run); // Add a run of text that appears as superscript. run = new Run(doc, "Superscript"); run.getFont().setSuperscript(true); para.appendChild(run);
public boolean getSuperscript() / public void setSuperscript(boolean value)
Example:
Shows how to use subscript, superscript, complex script, text effects, and baseline text position properties.// Create an empty document. It contains one empty paragraph. Document doc = new Document(); // Get the paragraph from the document, we will be adding runs of text to it. Paragraph para = (Paragraph) doc.getChild(NodeType.PARAGRAPH, 0, true); // Add a run of text that is raised 5 points above the baseline. Run run = new Run(doc, "Raised text"); run.getFont().setPosition(5); para.appendChild(run); // Add a run of normal text. run = new Run(doc, "Normal text"); para.appendChild(run); // Add a run of text that appears as subscript. run = new Run(doc, "Subscript"); run.getFont().setSubscript(true); para.appendChild(run); // Add a run of text that appears as superscript. run = new Run(doc, "Superscript"); run.getFont().setSuperscript(true); para.appendChild(run);
public int getTextEffect() / public void setTextEffect(int value)
Example:
Shows how to apply a visual effect to a run.Run run = new Run(doc, "Text with effect"); run.getFont().setTextEffect(TextEffect.SPARKLE_TEXT);
public int getUnderline() / public void setUnderline(int value)
Example:
Shows how use the underline character formatting properties.Run run = new Run(doc, "Hello"); run.getFont().setUnderline(Underline.DOTTED); run.getFont().setUnderlineColor(Color.RED);
Example:
Inserts formatted text using DocumentBuilder.DocumentBuilder builder = new DocumentBuilder(); // Specify font formatting before adding text. Font font = builder.getFont(); font.setSize(16); font.setBold(true); font.setColor(Color.BLUE); font.setName("Arial"); font.setUnderline(Underline.DASH); builder.write("Sample text.");
Example:
Inserts a hyperlink into a document using DocumentBuilder.Document doc = new Document(); DocumentBuilder builder = new DocumentBuilder(doc); builder.write("Please make sure to visit "); // Specify font formatting for the hyperlink. builder.getFont().setColor(Color.BLUE); builder.getFont().setUnderline(Underline.SINGLE); // Insert the link. builder.insertHyperlink("Aspose Website", "http://www.aspose.com", false); // Revert to default formatting. builder.getFont().clearFormatting(); builder.write(" for more information."); doc.save(getArtifactsDir() + "DocumentBuilder.InsertHyperlink.doc");
public java.awt.Color getUnderlineColor() / public void setUnderlineColor(java.awt.Color value)
Example:
Shows how use the underline character formatting properties.Run run = new Run(doc, "Hello"); run.getFont().setUnderline(Underline.DOTTED); run.getFont().setUnderlineColor(Color.RED);
public void clearFormatting()
Removes all font formatting specified explicitly on the object from which Font was obtained so the font formatting will be inherited from the appropriate parent.
Example:
Inserts a hyperlink into a document using DocumentBuilder.Document doc = new Document(); DocumentBuilder builder = new DocumentBuilder(doc); builder.write("Please make sure to visit "); // Specify font formatting for the hyperlink. builder.getFont().setColor(Color.BLUE); builder.getFont().setUnderline(Underline.SINGLE); // Insert the link. builder.insertHyperlink("Aspose Website", "http://www.aspose.com", false); // Revert to default formatting. builder.getFont().clearFormatting(); builder.write(" for more information."); doc.save(getArtifactsDir() + "DocumentBuilder.InsertHyperlink.doc");
public boolean hasDmlEffect(int dmlEffectType)
dmlEffectType
- A Example:
Shows how to checks if particular Dml text effect is applied.Document doc = new Document(getMyDir() + "Font.HasDmlEffect.docx"); RunCollection runs = doc.getFirstSection().getBody().getFirstParagraph().getRuns(); Assert.assertTrue(runs.get(0).getFont().hasDmlEffect(TextDmlEffect.SHADOW)); Assert.assertTrue(runs.get(1).getFont().hasDmlEffect(TextDmlEffect.SHADOW)); Assert.assertTrue(runs.get(2).getFont().hasDmlEffect(TextDmlEffect.REFLECTION)); Assert.assertTrue(runs.get(3).getFont().hasDmlEffect(TextDmlEffect.EFFECT_3_D)); Assert.assertTrue(runs.get(4).getFont().hasDmlEffect(TextDmlEffect.FILL));