Aspose.Words for .NET 18.10 Release Notes

/// <summary>
/// Specifies that the engine should remove paragraphs becoming empty after template syntax tags are
/// removed or replaced with empty values.
/// </summary>
RemoveEmptyParagraphs

Prefix
<<[""]>>
Suffix

Prefix
Suffix

Prefix
Suffix

Prefix
<<if [false]>>
Text to be removed
<</if>>
Suffix

Prefix
Suffix

Prefix
Suffix

Prefix
<<foreach [in persons]>>
<<[Name]>>
<</foreach>>
Suffix

Prefix
John Doe
Jane Doe
John Smith
Suffix

Prefix
John Doe
Jane Doe
John Smith
Suffix

/// <summary>
/// Gets the actual bounds of the shape in points.
/// </summary>
/// <remarks>
/// This property returns the actual (as rendered on the page) bounding box of the shape.
/// The bounds takes into account shape rotation (if any).
/// </remarks>
public RectangleF BoundsInPoints

public class FontSettings
{
    /// <summary>
    /// Settings related to font fallback mechanism.
    /// </summary>
    public FontFallbackSettings FallbackSettings
    {
        get { return mFallbackSettings; }
    }
}
/// <summary>
/// Specifies font fallback mechanism settings.
/// </summary>
/// <remarks>
/// By default fallback settings are initialized with predefined settings which mimics the Microsoft Word fallback.
/// </remarks>
public class FontFallbackSettings
{
	/// <summary>
	/// Loads font fallback settings from XML file.
	/// </summary>
	/// <param name="fileName">Input file name.</param>
	public void Load(string fileName);
	/// <summary>
	/// Loads fallback settings from XML stream.
	/// </summary>
	/// <param name="stream">Input stream.</param>
	public void Load(Stream stream);
	/// <summary>
	/// Loads predefined fallback settings which mimics the Microsoft Word fallback and uses Microsoft office fonts.
	/// </summary>
	public void LoadMsOfficeFallbackSettings();
	/// <summary>
	/// Saves the current fallback settings to stream.
	/// </summary>
	/// <param name="outputStream">Output stream.</param>
	public void Save(Stream outputStream);
	/// <summary>
	/// Saves the current fallback settings to file.
	/// </summary>
	/// <param name="fileName">Output file name.</param>
	public void Save(string fileName);
	/// <summary>
	/// Automatically builds the fallback settings by scanning available fonts.
	/// </summary>
	/// <remarks>
	/// This method may produce non-optimal fallback settings. Fonts are checked by <a href="https://docs.microsoft.com/en-us/typography/opentype/spec/os2#ur">
	/// Unicode Character Range</a> fields and not by the actual glyphs presence. Also Unicode ranges are checked individually
	/// and several ranges related to single language/script may use different fallback fonts.
	/// </remarks>
	public void BuildAutomatic();
}

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<FontFallbackSettings xmlns="Aspose.Words">
    <FallbackTable>
		<!-- Fallback table consists of the rules. Each rule defines the fallback fonts which Aspose.Words should use for specified Unicode ranges and base fonts. Rules are checked one by one and the first applicable fallback font is used. If none of the rules are applicable then ".notdef" glyph (missing glyph) from the base font will be used. -->
		<!-- This rule defines that "Vijaya" fallback font should be used for "U+0B80..U+0BFF Tamil" Unicode block. -->
        <Rule Ranges="0B80-0BFF" FallbackFonts="Vijaya"/>
		<!-- This rule defines that "Segoe UI Emoji" and "Segoe UI Symbol" fallback fonts should be used for "U+1F300..U+1F5FF Miscellaneous Symbols and Pictographs", "U+1F600..U+1F64F Emoticons" Unicode blocks. If "Segoe UI Emoji" font does not contains the glyph for the requested Unicode code point then "Segoe UI Symbol" will be checked. -->
		<Rule Ranges="1F300-1F64F" FallbackFonts="Segoe UI Emoji, Segoe UI Symbol"/>
		<!-- This rule defines that "Arial" fallback font should be used for "U+2000..U+206F General Punctuation", "U+2070..U+209F Superscripts and Subscripts" Unicode blocks and specific "U+20B9 INDIAN RUPEE SIGN" code point. -->
		<Rule Ranges="2000-206F, 2070-209F, 20B9" FallbackFonts="Arial">
		<!-- These rules defines that for "U+3040..U+309F Hiragana" Unicode block "MS Gothic" fallback font should be used if base font is "Times New Roman" and "MS Mincho" fallback font for all other base fonts. -->
        <Rule Ranges="3040-309F" FallbackFonts="MS Gothic" BaseFonts="Times New Roman"/>
		<Rule Ranges="3040-309F" FallbackFonts="MS Mincho"/>
		<!-- This rule defines that "Arial Unicode MS" fallback font should be used if applicable fallback font was not found by previous rules. -->
		<Rule FallbackFonts="Arial Unicode MS"/>
    </FallbackTable>
</FontFallbackSettings>

/// <summary>
/// Gets or sets the style applied to this SDT.
/// </summary>
public Style Style

/// <summary>
/// Gets or sets the name of the table style applied to this SDT.
/// </summary>
public string StyleName

StructuredDocumentTag sdt = ...
Style style = doc.Styles[styleName];
sdt.Style = style;

StructuredDocumentTag sdt = ...
sdt.StyleName = "Quote";

StructuredDocumentTag sdt = ...
sdt.StyleName = "Default Paragraph Font";

StructuredDocumentTag sdt = ...
Style style = sdt.Style; //paragraph style name will be returned if it's linked with a character style

StructuredDocumentTag sdt = ...
string styleName = sdt.StyleName; //paragraph style name will be returned if it's linked with a character style

StructuredDocumentTag sdt = ...
//... style was not defined before
Style style = sdt.Style;
//style should be "Default Paragraph Font"

public void Document.CopyStylesFromTemplate(string template)
public void Document.CopyStylesFromTemplate(Document template)

string templateFileName = "template file name";
Document target = new Document("target document file name");
target.CopyStylesFromTemplate(templateFileName);

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.InsertField(FieldType.FieldNone, false);

/// <summary>
/// Implements an unknown or unrecognized field.
/// </summary>
public class FieldUnknown : Field

DocumentBuilder builder = new DocumentBuilder();
FieldUnknown field = (FieldUnknown)builder.InsertField(FieldType.FieldNone, false);

/// <summary>
/// Gets or sets the "Allow spacing between cells" option.
/// </summary>
public bool AllowCellSpacing

// Remove spacing between cells
table.AllowCellSpacing = false;

/// <summary>
/// Inserts a horizontal rule shape into the document.
/// </summary>
public void InsertHorizontalRule()

builder.InsertHorizontalRule();