パブリック API Aspose.Cells 16.12.0 の変更点
追加された API
読み込み時にオブジェクトをフィルタリングする
Aspose.Cells 16.12.0 は、テンプレート ファイルから Workbook のインスタンスを初期化する際にロードするデータのタイプを一緒に制御できる LoadOptions.LoadFilter プロパティと共に LoadFilter クラスを公開しました。
テンプレート ファイルからドキュメント プロパティのみを読み込む簡単な使用シナリオを次に示します。
Java
//Create an instance of LoadOptions class
LoadOptions options = new LoadOptions();
//Create an instance of LoadFilter class
//Select to load document properties by passing LoadDataFilterOptions.DocumentProperties to constructor
LoadFilter filter = new LoadFilter(LoadDataFilterOptions.DOCUMENT_PROPERTIES);
//Set the LoadFilter property of LoadOptions object to the instance of LoadFilter class created above
options.setLoadFilter(filter);
//Load a template file by passing file path as well as instance of LoadOptions class
Workbook book = new Workbook(dir + "sample.xlsx", options);
次のスニペットは、チャートを除く既存のスプレッドシートからすべてを読み込みます。
Java
//Create an instance of LoadOptions class
LoadOptions options = new LoadOptions();
//Create an instance of LoadFilter class
//Select to load document properties by passing parameter to the constructor
LoadFilter filter = new LoadFilter(LoadDataFilterOptions.ALL & ~LoadDataFilterOptions.CHART);
//Set the LoadFilter property of LoadOptions object to the instance of LoadFilter class created above
options.setLoadFilter(filter);
//Load a template file by passing file path as well as instance of LoadOptions class
Workbook book = new Workbook(dir + "sample.xlsx", options);
次のコードは、既存のスプレッドシートからセル データ (数式と共に) と書式設定のみを読み込みます。
Java
//Create an instance of LoadOptions class
LoadOptions options = new LoadOptions();
//Create an instance of LoadFilter class
//Select to load document properties by passing parameter to the constructor
LoadFilter filter = new LoadFilter(LoadDataFilterOptions.CELL_DATA);
//Set the LoadFilter property of LoadOptions object to the instance of LoadFilter class created above
options.setLoadFilter(filter);
//Load a template file by passing file path as well as instance of LoadOptions class
Workbook book = new Workbook(dir + "sample.xlsx", options);
FileFormatType.OTS 列挙を追加
Aspose.Cells 16.12.0 では、OTS ファイルの形式を検出するために、FileFormatType 列挙に OTS エントリが追加されました。
次のスニペットは、FileFormatType.OTS を利用しています。
Java
//Detect the format of the file
FileFormatInfo fileFormatInfo = FileFormatUtil.detectFileFormat(dir + "sample.ots");
//Check if stream is of type OTS
if(fileFormatInfo.getFileFormatType() == FileFormatType.OTS);
{
System.out.println("It is an OTS file");
}
BuiltInDocumentPropertyCollection.ScaleCrop プロパティを追加
Aspose.Cells 16.12.0 では、ScaleCrop プロパティが BuiltInDocumentPropertyCollection クラスに追加されました。 ScaleCrop は、ドキュメント サムネイルの表示モードを示します。この要素を true に設定すると、ディスプレイごとにドキュメント サムネイルのスケーリングが有効になります。false に設定すると、ドキュメント サムネイルのトリミングが有効になり、ディスプレイに合わせてセクションが表示されます。
BuiltInDocumentPropertyCollection.LinksUpToDate プロパティを追加
Aspose.Cells 16.12.0 では、BuiltInDocumentPropertyCollection クラスの LinksUpToDate プロパティも公開されています。 LinksUpToDate プロパティは、ドキュメント内のハイパーリンクが最新かどうかを示します。
Workbook.exportXml メソッドを追加
Aspose.Cells 16.12.0 では、指定したファイル パスに XML マップ データを保存できる Workbook.exportXml メソッドが公開されました。 Workbook.exportXml メソッドは 2 つのパラメーターを受け入れます。最初の文字列型のパラメーターは XML マップ名で、2 番目のパラメーターは XML データを保存するファイル パスの場所である必要があります。
WorksheetCollection.createRange メソッドを追加
Aspose.Cells 16.12.0 では、アドレス (セル領域参照) とワークシート インデックスに基づいて範囲を作成できる WorksheetCollection.createRange メソッドが追加されました。
次のスニペットでは、WorksheetCollection.createRange メソッドを使用して、最初の (既定の) ワークシートで A1 から A2 にまたがるセル範囲を作成します。
Java
//Create an instance of Workbook
Workbook book = new Workbook();
//Access WorksheetCollection from the Workbook
WorksheetCollection sheets = book.getWorksheets();
//Create a range in first worksheet
Range range = sheets.createRange("A1:A2", 0);
廃止された API
廃止された LoadOptions.LoadDataOptions プロパティ
代わりに LoadOptions.LoadFilter プロパティを使用してください。
廃止された LoadOptions.LoadDataFilterOptions プロパティ
代わりに LoadOptions.LoadFilter プロパティを使用してください。
廃止された LoadOptions.OnlyLoadDocumentProperties プロパティ
代わりに LoadOptions.LoadFilter プロパティを使用してください。
廃止された LoadOptions.LoadDataAndFormatting プロパティ
代わりに LoadOptions.LoadFilter プロパティを使用してください。
削除された API
削除された DataLabels.Rotation プロパティ
代わりに DataLabels.RotationAngle プロパティを使用してください。
削除された Title.Rotation プロパティ
代わりに Title.RotationAngle プロパティを使用してください。
削除された DataLabels.Background プロパティ
代わりに DataLabels.BackgroundMode プロパティを使用することをお勧めします。
DisplayUnitLabel.Rotation プロパティを削除
同じ目標を達成するために DisplayUnitLabel.RotationAngle プロパティの使用を検討してください。
Title.getCharacters メソッドの削除
代わりに Title.characters メソッドを使用してください。