Aspose.Words for Java是功能豐富的Word處理API，允許開發人員在不使用Microsoft Word的情況下嵌入在自己的Java應用程序中生成，修改，轉換，呈現和打印文檔的功能。

很高興與大家分享Java平臺的Aspose.Words迎來了2020.4月更新，該版本具有.NET版同樣的7大新升級體驗，包括Java平臺現在支持OpenGL渲染，日志記錄系統已更新和改進，圖表數據標簽和系列的擴展API等等。本文將用示例為大家演示這些新功能，幫助你快速上手。

主要特點

• Java平臺現在支持OpenGL渲染（使用外部庫）。
• 日志記錄系統已更新和改進。
• Sonarqube測試通過。
• 提供了更改亞洲段落間距和縮進的功能。
• 為PDF渲染添加了圖像插值選項（新的公共屬性PdfSaveOptions.InterpolateImages）。
• 添加了新的模式3D形狀渲染。
• 圖表數據標簽和系列的擴展API。

增加了更改亞洲段落間距和縮進的功能

添加了以下ParagraphFormat屬性：

用例（.NET）

請注意，設置單位的縮進和間距將更新適當的公共縮進或間距屬性。例如，設置ParagraphFormat.CharacterUnitLeftIndent將更新ParagraphFormat.LeftIndent。

Document doc = new Document()
ParagraphFormat format = doc.FirstSection.Body.FirstParagraph.ParagraphFormat;
  
format.CharacterUnitLeftIndent = 10;       // ParagraphFormat.LeftIndent will be updated
  
format.CharacterUnitRightIndent = 10;      // ParagraphFormat.RightIndent will be updated
  
format.CharacterUnitFirstLineIndent = 20;  // ParagraphFormat.FirstLineIndent will be updated
  
format.LineUnitBefore = 5;                 // ParagraphFormat.SpaceBefore will be updated
  
format.LineUnitAfter= 10;                  // ParagraphFormat.SpaceAfter will be updated

添加了新模式的3D形狀渲染

添加了新的公共屬性SaveOptions.Dml3DEffectsRenderingMode ：

用例（.NET）

Document doc = new Document(docPath);
SaveOptions saveOptions = new PdfSaveOptions();
saveOptions.Dml3DEffectsRenderingMode = Dml3DEffectsRenderingMode.Advanced;
doc.Save(pdfPath, saveOptions);

請注意：為了使“高級”模式正常工作，必須將系統中的比例設置為100％。下表顯示了兩種模式之間的差異：

添加了一個選項，允許客戶指定比較粒度

添加了以下屬性：

用例（.NET）

DocumentBuilder builderA = new DocumentBuilder(new Document());
DocumentBuilder builderB = new DocumentBuilder(new Document());
  
builderA.Writeln("This is A simple word");
builderB.Writeln("This is B simple words");
  
CompareOptions co = new CompareOptions();
co.Granularity = Granularity.CharLevel;
  
builderA.Document.Compare(builderB.Document, "author", DateTime.Now, co);

添加了用于設置浮動表定位的功能（HorizontalAnchor和VerticalAnchor）

用于以下屬性的設置器已添加到Table類中：

注意，HorizontalAnchor設置器中僅允許使用以下值。對于任何其他值，將引發ArgumentException。

注意，VerticalAnchor設置器中僅允許使用以下值。對于任何其他值，將引發ArgumentException。

用例（.NET）

Document doc = new Documnet(file_with_table);
Table table = doc.FirstSection.Body.Tables[0];
  
table.HorizontalAnchor = RelativeHorizontalPosition.Column;
table.VerticalAnchor = RelativeVerticalPosition.Page;

為PDF渲染添加了圖像插值選項

為PDF渲染添加了圖像插值選項，可以通過PdfSaveOptions.InterpolateImages屬性指定。

用例（.NET）

Document doc = new Document(docPath);
PdfSaveOptions saveOptions = new PdfSaveOptions();
saveOptions.InterpolateImages = true;
doc.Save(pdfPath, saveOptions);

圖表數據標簽和系列的API的更改

圖表數據標簽API中的以下更改已實現（WORDSNET-19124）：

• 屬性HasDataLabels已添加到ChartSeries類。
• 方法ClearFormat已添加到ChartDataLabelCollection類。
• ChartDataLabelCollection類的Count屬性返回一系列系列的所有數據標簽，而不僅僅是像以前版本的軟件那樣具有非默認格式的數據標簽。
• Add，RemoveAt和Clear方法已標記為過時。設置Series.HasDataLabels = true之后，該集合現在包含該系列的所有數據標簽，并且無需向其添加標簽。方法RemoveAt和Clear實際上將數據標簽的格式重置為ChartDataLabelCollection對象的屬性中定義的默認值。現在應改為使用ChartDataLabel.ClearFormat和ChartDataLabelCollection.ClearFormat方法。
• 方法ClearFormat已添加到ChartDataLabel類。
• 屬性IsHidden已添加到ChartDataLabel類。

public class ChartSeries
{
    /// <summary>
    /// Gets or sets a flag indicating whether data labels are displayed for the series.
    /// </summary>
    public bool HasDataLabels { get; set; }
}
  
public class ChartDataLabelCollection
{
    /// <summary>
    /// Adds new <see cref="ChartDataLabel"/> at the specified index.
    /// </summary>
    [Obsolete("When ChartSeries.HasDataLabels is 'true', all data labels are available in this collection.")]
    public ChartDataLabel Add(int index);
  
    /// <summary>
    /// Clears format of a <see cref="ChartDataLabel"/> at the specified index.
    /// </summary>
    [Obsolete("Use the ChartDataLabel.ClearFormat method instead.")]
    public void RemoveAt(int index);
  
    /// <summary>
    /// Clears format of all <see cref="ChartDataLabel"/> in this collection.
    /// </summary>
    [Obsolete("Use the ClearFormat method instead.")]
    public void Clear();
  
    /// <summary>
    /// Clears format of all <see cref="ChartDataLabel"/> in this collection.
    /// </summary>
    public void ClearFormat();
}
  
public class ChartDataLabel
{
    /// <summary>
    /// Clears format of this data label. The properties are set to the default values defined in the parent data label collection.
    /// </summary>
    public void ClearFormat();
  
    /// <summary>
    /// Gets/sets a flag indicating whether this label is hidden.
    /// The default value is <b>false</b>.
    /// </summary>
    public bool IsHidden { get; set; }
}

用例（.NET）

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
  
Shape shape = builder.InsertChart(ChartType.Line, 432, 252);
Chart chart = shape.Chart;
  
// Delete default generated series.
chart.Series.Clear();
  
ChartSeries series1 = chart.Series.Add("Series 1", 
    new string[] { "Category 1", "Category 2", "Category 3" }, 
    new double[] { 1, 5, 4 });
  
series1.HasDataLabels = true;
series1.DataLabels.ShowValue = true;
series1.DataLabels[1].ShowCategoryName = true;
series1.DataLabels[1].ShowValue = true;
series1.DataLabels[2].IsHidden = true;
  
doc.Save(dir + "DataLabels.docx");

在ECMA376和ISO29500標準文檔之間實現了多個PageBorderArt名稱的相互轉換

實驗表明，“ Tribal *” 邊框藝術樣式與ISO29500特定邊框藝術樣式之間存在相互對應關系，范圍從 “ Triangle1 ”到“ Shapes2 ”。在此版本中，根據下表實現了所提到的BorderArt樣式名稱的直接轉換：