Aspose.Cells 8.8.1 da Genel API Değişiklikleri
Eklenen API’lar
Yükleme için Verileri Filtrele
Aspose.Cells for Java 8.8.1, LoadDataFilterOptions numaratörünü ve LoadOptions.LoadDataFilterOptions özelliğini sergiledi. Bu, bir şablon dosyasından çalışma kitabını oluşturulurken yüklenmesi gereken veri türünü belirtmek için kullanılabilir. Yüklenmiş verilerin filtrelenmesi özellikle LightCells API’lerini kullanırken performansı özel amaçlar için artırabilir.
LoadDataFilterOptions numaratörü aşağıdaki seçenekleri sağlar.
- SPREADSHEET’ten her şeyi yüklemek için TÜM.
- SPREADSHEET’ten hiçbir şey yüklemek için HİÇBİR.
- BLANK_CELL, değerleri boş olan hücreleri yükler.
- BOOL_CELL, değerleri Boolean olan hücreleri yükler.
- DATA_CELL, değerleri, formülleri ve biçimlendirmeyi içeren hücre verilerini yükler.
- ERROR_CELL, değerleri hata olan hücreleri yükler.
- NUMERIC_CELL, değerleri sayısal olan hücreleri yükler (Tarih ve Saat dahil).
- STRING_CELL, değerleri metin/dize olan hücreleri yükler.
- VALUE_CELL, yalnızca hücre değerlerini yükler (tüm türler).
- GRAFİK, yalnızca grafikleri yükler.
- KOŞULLU_FORMAT, yalnızca koşullu biçimlendirme kurallarını yükler.
- VERI_DOGRULAMA, yalnızca veri doğrulama kurallarını yükler.
- BELGE_ÖZELLIKLERİ, yalnızca belge özelliklerini yükler.
- FORMÜL, tanımlı adları içeren formülleri yükler.
- BİRLEŞTİRİLMİŞ_ALAN, yalnızca birleştirilmiş hücreleri yükler.
- PIVOT_TABLO, Pivot Tabloları yükler.
- AYARLAR, yalnızca Çalışma Kitabı ve Çalışsayfa ayarlarını yükler.
- ŞEKİL, yalnızca şekilleri yükler.
- STIL, hücre biçimlendirmesini yükler.
- TABLO, Excel tablolarını/Liste Nesnelerini yükler.
Basit kullanım senaryosu aşağıda gösterilmektedir.
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);
Doğrudan Grafikleri PDF’e Dönüştür
Aspose.Cells API’leri zaten Chart.toPdf yöntemini kullanarak grafikleri PDF’ye dönüştürme olanağı sağlamıştır. Bu sürümle birlikte, API, anılan yöntemin başka bir aşırı yüklenmiş versiyonunu sergilemiştir. Bu sayede kullanıcılar, grafiklerin PDF’ini ByteArrayOutputStream örneğinde kaydedebilirler.
Basit kullanım senaryosu aşağıda gösterilmektedir.
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 Özelliği Eklendi
Aspose.Cells for Java 8.8.1, tüm çalışma kitabı için varsayılan baskı kağıdı boyutunu ayarlamak için WorkbookSettings.PaperSize özelliğini sergiledi. WorkbookSettings.PaperSize özelliği, en yaygın kullanılan baskı kağıdı tipleri için önceden tanımlanmış boyutları içeren PaperSizeType numaratöründen bir değer alır.
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 Özelliği Eklendi
Aspose.Cells for Java API’nin bu sürümü, metin şekillerinde metnin özelliklerini manipüle etmek için Shape.TextBody’i açığa çıkardı. Aşağıdaki kod parçası, belirtilen özelliği kullanarak bir TextBox’taki metnin gölge etkisini ayarlamak için kullanılır.
Java
//Create an instance of Workbook
Workbook book = new Workbook();
//Access first worksheet of the Workbook
Worksheet sheet = book.getWorksheets().get(0);
//Add a TextBox to the ShapeCollection
int index = sheet.getTextBoxes().add(2, 2, 100, 400);
TextBox textBox = sheet.getTextBoxes().get(index);
//Set the text of the TextBox
textBox.setText("This text has the following settings.\n\nText Effects > Shadow > Offset Bottom");
//Set shadow effect for text
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) Yöntemi Eklendi
Aspose.Cells for Java 8.8.1, hesap formülünü özel seçeneklerle doğrudan hesaplama yeteneği sağlayan Worksheet.calculateFormula yönteminin başka bir yüklemesini açığa çıkardı.
GridCell.createValidation Yöntemi Eklendi
Aspose.Cells.GridWeb, GridCell.createValidation yöntemini kullanarak tek bir hücreye doğrudan doğrulama kuralı eklemeyi sağladı. Söz konusu yöntem 2 parametre gerektirir. İlk parametre, doğrulama türünü belirleyen GridValidationType türündedir, ikinci parametre (isRequied) ise Boolean türündedir.
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 Yöntemi Eklendi
Aspose.Cells.GridWeb, GridCell.removeValidation yöntemi kullanılarak bir GridCell’den veri doğrulama kuralını kaldırma yeteneği de sağladı.
Eskimiş API’lar
Eskimiş Shape.TextFrame Özelliği
Bu yerine Shape.TextBody.TextAlignment özelliğinin kullanılması tavsiye edilir.