Öffentlich API Änderungen in Aspose.Cells 8.8.1

Dieses Dokument beschreibt die Änderungen an Aspose.Cells API von Version 8.8.0 zu 8.8.1, die für Modul-/Anwendungsentwickler von Interesse sein könnten. Es enthält nicht nur neue und aktualisierte öffentliche Methoden, hinzugefügte und entfernte Klassen usw., sondern auch eine Beschreibung aller Änderungen im Verhalten hinter den Kulissen in Aspose.Cells.

APIs hinzugefügt

Filtern Sie die Daten zum Laden

Aspose.Cells for Java 8.8.1 hat die LoadDataFilterOptions-Enumeration zusammen mit der LoadOptions.LoadDataFilterOptions-Eigenschaft verfügbar gemacht, die verwendet werden kann, um den Datentyp anzugeben, der geladen werden soll, wenn die Arbeitsmappe aus einer Vorlagendatei erstellt wird. Das Filtern geladener Daten kann die Leistung für spezielle Zwecke verbessern, insbesondere bei Verwendung von LightCells-APIs.

Die LoadDataFilterOptions-Enumeration bietet die folgende Auswahl.

1. ALL, um alles aus der Tabelle zu laden.
2. NONE, um nichts aus der Tabelle zu laden.
3. CELL_BLANK lädt die Zellen, deren Werte leer sind.
4. CELL_BOOL lädt Zellen, deren Werte boolesch sind.
5. CELL_DATA lädt Zellendaten einschließlich Werte, Formeln und Formatierungen.
6. CELL_ERROR lädt Zellen, deren Werte fehlerhaft sind.
7. CELL_NUMERIC lädt Zellen, deren Werte numerisch sind (einschließlich Datum und Uhrzeit).
8. CELL_STRING lädt Zellen, deren Werte Text/String sind.
9. CELL_VALUE lädt nur Zellwerte (alle Typen).
10. CHART lädt nur Diagramme.
11. CONDITIONAL_FORMATTING lädt nur bedingte Formatierungsregeln.
12. DATA_VALIDATION lädt nur Datenvalidierungsregeln.
13. DOCUMENT_PROPERTIES lädt nur Dokumenteigenschaften.
14. FORMULA lädt Formeln mit definierten Namen.
15. MERGED_AREA lädt nur verbundene Zellen.
16. PIVOT_TABLE lädt Pivot-Tabellen.
17. EINSTELLUNGEN lädt nur Arbeitsmappen- und Arbeitsblatteinstellungen.
18. SHAPE lädt nur Shapes.
19. STYLE lädt die Zellenformatierung.
20. TABLE lädt Excel-Tabellen/Listenobjekte.

Weitere Einzelheiten zu dieser Funktion finden Sie im ausführlichen Artikel unterDaten zum Laden filtern.

Es folgt das einfache Nutzungsszenario.

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);

Konvertieren Sie das Diagramm direkt in PDF

Aspose.Cells-APIs haben bereits die Möglichkeit bereitgestellt, Diagramme in PDF zu rendern, während die Chart.toPdf-Methode verwendet wird. Mit dieser Version hat API eine weitere überladene Version der genannten Methode bereitgestellt, die eine Instanz von OutputStream akzeptieren könnte, sodass Benutzer PDF des Diagramms in einer Instanz von ByteArrayOutputStream speichern können.

Es folgt das einfache Nutzungsszenario.

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-Eigenschaft hinzugefügt

Aspose.Cells for Java 8.8.1 hat die WorkbookSettings.PaperSize-Eigenschaft verfügbar gemacht, um die standardmäßige Druckpapiergröße für die gesamte Tabelle festzulegen. Die WorkbookSettings.PaperSize-Eigenschaft akzeptiert einen Wert aus der PaperSizeType-Enumeration, die die vordefinierten Größen für die am häufigsten verwendeten Druckpapiertypen enthält.

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-Eigenschaft hinzugefügt

Diese Version von Aspose.Cells for Java API hat Shape.TextBody verfügbar gemacht, um die Aspekte des Textes in einer Form zu manipulieren. Das folgende Snippet verwendet die besagte Eigenschaft, um den Schatteneffekt des Textes in einer TextBox festzulegen.

Weitere Einzelheiten zu dieser Funktion finden Sie im ausführlichen Artikel unterSchatteneffekt für Text einstellen.

Java

 //Eine Instanz von Workbook erstellen

Arbeitsmappenbuch = neue Arbeitsmappe();

//Zugriff auf das erste Arbeitsblatt der Arbeitsmappe

Arbeitsblatt sheet = book.getWorksheets().get(0);

//TextBox zur ShapeCollection hinzufügen

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

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

//Setzen Sie den Text der TextBox

textBox.setText("Dieser Text hat die folgenden Einstellungen.\n\nTexteffekte > Schatten > Versatz unten");

//Schatteneffekt für Text festlegen

 für (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) Methode hinzugefügt

Aspose.Cells for Java 8.8.1 hat eine weitere Überladung für die Worksheet.calculateFormula-Methode verfügbar gemacht, die die Möglichkeit bietet, eine bestimmte Formel direkt mit benutzerdefinierten Optionen zu berechnen.

Weitere Einzelheiten zu dieser Funktion finden Sie im ausführlichen Artikel unterDirekte Berechnung der benutzerdefinierten Funktion.

GridCell.createValidation-Methode hinzugefügt

Aspose.Cells. GridWeb bietet die Möglichkeit, die Validierungsregel direkt zu einer einzelnen Zelle hinzuzufügen, während die GridCell.createValidation-Methode verwendet wird. Das genannte Verfahren erfordert 2 Parameter. Der erste ist vom Typ GridValidationType, der den Validierungstyp bestimmt, während der zweite Parameter (isRequied) vom Typ Boolean ist.

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-Methode hinzugefügt

Aspose.Cells. GridWeb bietet auch die Möglichkeit, die Datenvalidierungsregel aus einer GridCell zu entfernen, während die GridCell.removeValidation-Methode verwendet wird.

Veraltete APIs

Veraltete Shape.TextFrame-Eigenschaft

Es wird empfohlen, stattdessen die Shape.TextBody.TextAlignment-Eigenschaft zu verwenden.