Genel API Aspose.Cells 8.4.0'daki değişiklikler

Bu belge, Aspose.Cells API sürüm 8.3.2’den 8.4.0’a modül/uygulama geliştiricilerin ilgisini çekebilecek değişiklikleri açıklamaktadır. Yalnızca yeni ve güncellenmiş genel yöntemleri içermez,eklenen sınıflar vb. vekaldırılan sınıflar vb., aynı zamanda Aspose.Cells’deki perde arkasındaki davranış değişikliklerinin açıklaması.

Eklenen API’ler

Elektronik Tablolardaki VBA/Makro Kodunu Değiştirme Mekanizması

özelliğini sağlamak içinVBA/Makro Kod ManipülasyonuAspose.Cells for Java 8.4.0, com.aspose.cells.Vba paketinde bir dizi yeni sınıf ve özellik ortaya çıkardı. Bu yeni sınıfların önemli detaylarından birkaçı aşağıdaki gibidir.

VbaProject sınıfı, belirli bir elektronik tablodan VBA projesini getirmek için kullanılabilir.
VbaModuleCollection sınıfı, belirli bir VbaProject’in parçası olan VBA modüllerinin koleksiyonunu temsil eder.
VbaModule sınıfı, VbaModuleCollection’dan tek bir modülü temsil eder.

Aşağıdaki kod parçacığı, VBA kod bölümlerinin dinamik olarak nasıl değiştirileceğini gösterir.

Java

 Çalışma kitabı çalışma kitabı = yeni Çalışma Kitabı("source.xlsm");

//VBA Modül Kodunu Değiştirin

VbaModuleCollection modülleri = workbook.getVbaProject().getModules();

 for(int i=0; ben< modules.getCount(); i++)

{

	VbaModule module = modules.get(i);

    String code = module.getCodes();

    //Replace the original message with the modified message

    if (code.contains("This is test message."))

    {

        code = code.replace("This is test message.", "This is Aspose.Cells message.");

        module.setCodes(code);

    }

}

//Save the output Excel file

workbook.save("output.xlsm");

Pivot Tabloyu Kaldırma Yeteneği

Aspose.Cells for Java 8.4.0, PivotTableCollection’ın belirli bir e-tablodan Pivot Tablo kaldırma özelliği sağlaması için iki yöntem ortaya çıkardı. Bahsi geçen yöntemlerin detayları aşağıdaki gibidir.

PivotTableCollection.remove yöntemi, PivotTable’ın bir nesnesini kabul eder ve onu koleksiyondan kaldırır.
PivotTableCollection.removeAt yöntemi, sıfır dizin tabanlı bir tamsayı değeri kabul eder ve belirli PivotTable’ı koleksiyondan kaldırır.

Aşağıdaki kod parçacığı, PivotTable’ın yukarıda belirtilen her iki yöntemi de kullanarak nasıl kaldırılacağını gösterir.

Java

 //Create workbook object from source Excel file

Workbook workbook = new Workbook("source.xlsx");

//Access the first worksheet

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

//Access the first pivot table object

PivotTable pivotTable = worksheet.getPivotTables().get(0);

//Remove pivot table using pivot table object

worksheet.getPivotTables().remove(pivotTable);

//Remove pivot table using pivot table position

worksheet.getPivotTables().removeAt(0);

//Save the workbook

workbook.save("output.xlsx");

Farklı Pivot Tablo Düzenleri için Destek

Aspose.Cells for Java 8.4.0, Pivot Tablolar için önceden tanımlanmış farklı düzenler için destek sağlar. Bu özelliği sağlamak için Aspose.Cells API’leri, PivotTable sınıfı için aşağıda ayrıntılı olarak açıklanan üç yöntemi kullanıma sunmuştur.

PivotTable.showInCompactForm yöntemi, Pivot Tabloyu Kompakt mizanpajda işler.
PivotTable.showInOutlineForm yöntemi, Pivot Tabloyu Anahat düzeninde işler.
PivotTable.showInTabularForm yöntemi, Pivot Tabloyu Tablo düzeninde işler.

Yukarıda belirtilen düzenlerden herhangi birini ayarladıktan sonra PivotTable.refreshData & PivotTable.calculateData’yı çağırmak önemlidir.

Aşağıdaki örnek kod, Pivot Tablo için farklı düzenler ayarlar ve sonucu diskte depolar.

Java

 //Create workbook object from source excel file

Workbook workbook = new Workbook("source.xlsx");

//Access first worksheet

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

//Access first pivot table

PivotTable pivotTable = worksheet.getPivotTables().get(0);

//1 - Show the pivot table in compact form

pivotTable.showInCompactForm();

//Refresh the pivot table

pivotTable.refreshData();

pivotTable.calculateData();

//Save the output

workbook.save("CompactForm.xlsx");

//2 - Show the pivot table in outline form

pivotTable.showInOutlineForm();

//Refresh the pivot table

pivotTable.refreshData();

pivotTable.calculateData();

//Save the output

workbook.save("OutlineForm.xlsx");

//3 - Show the pivot table in tabular form

pivotTable.showInTabularForm();

//Refresh the pivot table

pivotTable.refreshData();

pivotTable.calculateData();

//Save the output

workbook.save("TabularForm.xlsx");

Sınıf TxtLoadStyleStrategy ve Özellik TxtLoadOptions.LoadStyleStrategy Eklendi

Aspose.Cells for Java 8.4.0, dize değerini sayıya veya tarih saatine dönüştürürken ayrıştırılan değerleri biçimlendirme stratejisini belirtmek için TxtLoadStyleStrategy sınıfını ve TxtLoadOptions.LoadStyleStrategy özelliğini kullanıma sundu.

Yöntem DataBar.ToImage Eklendi

v8.4.0’ın piyasaya sürülmesiyle, Aspose.Cells API, koşullu olarak biçimlendirilmiş DataBar’ı görüntü biçiminde kaydetmek için DataBar.toImage yöntemini sağladı. {DataBar.toImage}} yöntemi, aşağıda ayrıntıları verilen iki parametreyi kabul eder.

İlk parametre, koşullu biçimlendirmenin uygulandığı com.aspose.cells.Cell türündedir.
Elde edilen görüntünün farklı parametrelerini ayarlamak için ikinci parametre com.aspose.cells.rendering.ImageOrPrintOptions türündedir.

Aşağıdaki örnek kod, DataBar’ı görüntü biçiminde işlemek için DataBar.toImage yönteminin kullanımını gösterir.

Java

 //Create workbook object from source excel file

Workbook workbook = new Workbook("source.xlsx");

//Access first worksheet

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

//Access the cell which contains conditional formatting databar

Cell cell = worksheet.getCells().get("C1");

//Get the conditional formatting of the cell

FormatConditionCollection fcc = cell.getFormatConditions();

//Access the conditional formatting databar

DataBar dbar = fcc.get(0).getDataBar();

//Create image or print options

ImageOrPrintOptions opts = new ImageOrPrintOptions();

opts.setImageFormat(ImageFormat.getPng());

//Get the image bytes of the databar

byte[]imgBytes = dbar.toImage(cell, opts);

//Write image bytes on the disk

FileOutputStream out = new FileOutputStream("databar.png");

out.write(imgBytes);

out.close();

Özellik Border.ThemeColor Eklendi

Aspose.Cells API’ler, elektronik tablolardan temayla ilgili verilerin çıkarılmasına izin verir. Aspose.Cells for Java 8.4.0 sürümüyle birlikte API, Cell kenarlıklarının tema rengi özniteliklerini almak için kullanılabilecek Border.ThemeColor özelliğini kullanıma sundu.

Özellik DrawObject.ImageBytes Eklendi

Aspose.Cells for Java 8.4.0, Grafik veya Şekil’den resim verilerini almak için DrawObject.ImageBytes özelliğini kullanıma sundu.

Özellik HtmlSaveOptions.ExportBogusRowData Eklendi

Aspose.Cells for Java 8.4.0, {HtmlSaveOptions.ExportBogusRowData}} özelliğini sağladı. Boole tipi özelliği, elektronik tabloyu HTML biçimine dışa aktarırken API’in sahte alt sıra verileri enjekte edip etmeyeceğini belirler.

Varsayılan değer doğrudur.

Aşağıdaki örnek kod, yukarıda bahsedilen özelliğin kullanımını göstermektedir.

Java

 //Create an object of HtmlSaveOptions class

HtmlSaveOptions options = new HtmlSaveOptions();

//Set the ExportBogusRowData to true

options.ExportBogusRowData = true;

//Create workbook object from source excel file

Workbook workbook = new Workbook("source.xlsx");

//Save the workbook

workbook.save("output.xlsx");

Özellik HtmlSaveOptions.CellCssPrefix Eklendi

Yeni eklenen özellik HtmlSaveOptions.CellCssPrefix, e-tabloları HTML biçiminde dışa aktarırken CSS dosyaları için önek ayarlamanıza olanak tanır.

Varsayılan değer boş bir dizedir).

Eski API’ler

Yöntemler Cells.getCellByIndex & Row.getCellByIndex Kullanımdan Kaldırıldı

Bunun yerine tüm hücreleri yinelemek için getEnumerator yöntemini kullanın.

DrawObject.Image Özelliği Kullanımdan Kaldırıldı

Bunun yerine resim verilerini almak için DrawObject.ImageBytes özelliğini kullanın.

Genel API Aspose.Cells 8.3.2'deki değişiklikler Genel API Aspose.Cells 8.4.1'deki değişiklikler