パブリック API Aspose.Cells 8.8.1 の変更点

このドキュメントでは、モジュール/アプリケーション開発者にとって興味深い、バージョン 8.8.0 から 8.8.1 への Aspose.Cells API への変更について説明します。新規および更新されたパブリックメソッド、追加および削除されたクラスなどだけでなく、Aspose.Cells の舞台裏での動作の変更の説明も含まれています。

追加された API

ロードするデータをフィルタリングする

Aspose.Cells for Java 8.8.1 は、LoadOptions.LoadDataFilterOptions プロパティと共に LoadDataFilterOptions 列挙を公開しました。これを使用して、テンプレートファイルからワークブックを作成するときにロードするデータ型を指定できます。ロードされたデータをフィルタリングすると、特に LightCells API を使用する場合に、特別な目的でパフォーマンスを向上させることができます。

LoadDataFilterOptions 列挙体は、次の選択肢を提供します。

ALL : スプレッドシートからすべてをロードします。
スプレッドシートから何もロードしない場合は NONE。
CELL_BLANK は、値が空白のセルをロードします。
CELL_BOOL は、値がブール値のセルをロードします。
CELL_DATA は、値、数式、フォーマットを含むセルデータを読み込みます。
CELL_ERROR は、値がエラーであるセルをロードします。
CELL_NUMERIC は、値が数値 (日付と時刻を含む) であるセルを読み込みます。
CELL_STRING は、値がテキスト/文字列であるセルをロードします。
CELL_VALUE は、セル値 (すべての型) のみをロードします。
CHART はチャートのみをロードします。
CONDITIONAL_FORMATTING は、条件付き書式ルールのみをロードします。
DATA_VALIDATION は、データ検証ルールのみをロードします。
DOCUMENT_PROPERTIES は、ドキュメントプロパティのみを読み込みます。
FORMULA は、定義された名前を含む式をロードします。
MERGED_AREA は、結合されたセルのみをロードします。
PIVOT_TABLE は、ピボットテーブルを読み込みます。
SETTINGS は、ワークブックとワークシートの設定のみを読み込みます。
SHAPE は形状のみをロードします。
STYLE は、セルの書式設定を読み込みます。
TABLE は、Excel テーブル/リストオブジェクトを読み込みます。

この機能の詳細については、次の詳細記事を参照してください。ロードするデータのフィルタリング.

以下は、簡単な使用シナリオです。

Java

 //Create an instance of LoadOptions & initialize it with type of template to be loaded

LoadOptions options = new LoadOptions(LoadFormat.XLSX);

//Set LoadDataFilterOptions to load only shapes

options.setLoadDataFilterOptions(LoadDataFilterOptions.SHAPE);

//Create an instance of Workbook from a existing spreadsheet using instance of LoadOptions

Workbook book = new Workbook(filePath, options);

チャートをPDFに直接変換

Aspose.Cells API は、Chart.toPdf メソッドを使用して PDF にグラフをレンダリングする機能を既に提供しています。このリリースでは、API は、OutputStream のインスタンスを受け入れることができる、前述のメソッドの別のオーバーロードされたバージョンを公開し、ユーザーがチャートの PDF を ByteArrayOutputStream のインスタンスに保存できるようにしました。

以下は、簡単な使用シナリオです。

Java

 //Create an instance of Workbook and load an existing spreadsheet with a chart

Workbook workbook = new Workbook(filePath);

//Access first worksheet containing a chart

Worksheet worksheet = workbook.getWorksheets().get(0);

//Access first chart from the worksheet

Chart chart = worksheet.getCharts().get(0);

//Save the chart to PDF as Stream

ByteArrayOutputStream outStream = new ByteArrayOutputStream();

chart.toPdf(outStream);

WorkbookSettings.PaperSize プロパティを追加

Aspose.Cells for Java 8.8.1 は、スプレッドシート全体のデフォルトの印刷用紙サイズを設定するために WorkbookSettings.PaperSize プロパティを公開しました。 WorkbookSettings.PaperSize プロパティは、最も広く使用されている印刷用紙の種類の定義済みサイズを含む PaperSizeType 列挙からの値を受け入れます。

Java

 //Create an instance of Workbook

//Optionally load an existing spreadsheet

Workbook book = new Workbook();

//Access WorkbookSettings from the Workbook

WorkbookSettings settings = book.getSettings();

//Set the default printing paper size for the Workbook

settings.setPaperSize(PaperSizeType.PAPER_A_4);

Shape.TextBody プロパティを追加

Aspose.Cells for Java API のこのリリースでは、シェイプ内のテキストの側面を操作するために、Shape.TextBody が公開されています。次のスニペットは、前述のプロパティを使用して、TextBox 内のテキストの影の効果を設定します。

この機能の詳細については、次の詳細記事を参照してください。テキストの影効果を設定する.

Java

// Workbook のインスタンスを作成します

ワークブック book = new Workbook();

//ワークブックの最初のワークシートにアクセス

ワークシート シート = book.getWorksheets().get(0);

//ShapeCollection に TextBox を追加します

int index = sheet.getTextBoxes().add(2, 2, 100, 400);

TextBox textBox = sheet.getTextBoxes().get(index);

// TextBox のテキストを設定します

textBox.setText("このテキストには次の設定があります。\n\nテキスト効果 > 影 > オフセット下");

//テキストの影効果を設定

for (int i = 0; i< textBox.getTextBody().getCount(); i++)

{

  textBox.getTextBody().get(i).getShapeFont().getFillFormat().getShadowEffect().setPresetType(PresetShadowType.OFFSET_BOTTOM);

}

Worksheet.calculateFormula(string formula, CalculationOptions opts) メソッドを追加

Aspose.Cells for Java 8.8.1 では、Worksheet.calculateFormula メソッドの別のオーバーロードが公開されました。このメソッドは、カスタムオプションを使用して特定の数式を直接計算する機能を提供します。

この機能の詳細については、次の詳細記事を参照してください。カスタム関数の直接計算.

GridCell.createValidation メソッドを追加

Aspose.Cells.GridWeb は、GridCell.createValidation メソッドを使用して、検証ルールを単一のセルに直接追加する機能を提供しました。上記のメソッドには 2 つのパラメーターが必要です。最初のパラメーターは検証タイプを決定する GridValidationType 型で、2 番目のパラメーター (isRequied) は Boolean 型です。

Java

 //Access first worksheet

GridWorksheet sheet = gridweb.getWorkSheets().get(0);

//Access cell B3

GridCell cell = sheet.getCells().get("B3");

//Add validation inside the GridCell

//Any value which is not between 20 and 40 will cause error in a GridCell

GridValidation val = cell.createValidation(GridValidationType.WHOLE_NUMBER, true);

val.setFormula1("=20");

val.setFormula2("=40");

val.setOperator(OperatorType.BETWEEN);

val.setShowError(true);

val.setShowInput(true);

GridCell.removeValidation メソッドを追加

Aspose.Cells.GridWeb は、GridCell.removeValidation メソッドを使用して、GridCell からデータ検証ルールを削除する機能も提供しています。

廃止された API

廃止された Shape.TextFrame プロパティ

代わりに Shape.TextBody.TextAlignment プロパティを使用することをお勧めします。

パブリック API Aspose.Cells 8.8.0 の変更点パブリック API Aspose.Cells の変更点 8.8.2