Aspose.Cells for Java 17.02.0 Notes de mise à jour

Public API et modifications incompatibles avec les versions antérieures

Voici une liste de toutes les modifications apportées au public API, telles que les membres ajoutés, renommés, supprimés ou obsolètes, ainsi que toute modification non rétrocompatible apportée à Aspose.Cells for Java. Si vous avez des inquiétudes concernant l’un des changements répertoriés, veuillez le signaler sur le forum d’assistance Aspose.Cells.

Ajout de la propriété HTMLLoadOptions.AutoFitColsAndRows

Cette version du Aspose.Cells for Java API a ajouté la propriété HTMLLoadOptions.AutoFitColsAndRows qui indique si le API doit ajuster automatiquement les colonnes et les lignes lors de l’importation du HTML dans son mode objet. La propriété de type booléen a la valeur par défaut false, ce qui signifie que les hauteurs et largeurs de cellule seront importées telles quelles. Cependant, lorsque la propriété susmentionnée est définie sur true, le API essaie d’ajuster les largeurs de colonne et les hauteurs de ligne en fonction du contenu. .

Voici le scénario d’utilisation simple de la propriété HTMLLoadOptions.AutoFitColsAndRows.

 // Create an instance of HTMLLoadOptions

HTMLLoadOptions loadOptions = new HTMLLoadOptions();

// Set the AutoFitColsAndRows property to true

loadOptions.setAutoFitColsAndRows(true);

// Create an instance of Workbook and load HTML while passing

// the object of HTMLLoadOptions class created above

Workbook book = new Workbook(dir + "sample.htm", loadOptions);

Ajout des propriétés WorkbookSettings.WarningCallback & LoadOptions.WarningCallback

Aspose.Cells for Java 17.02.0 a exposé la propriété WarningCallback aux classes LoadOptions et WorkbookSettings afin d’obtenir ou de définir le rappel d’avertissement. Les développeurs doivent implémenter l’interface IWarningCallback afin d’obtenir des avertissements personnalisés dans leurs applications.

Voici un scénario d’utilisation simple de la propriété LoadOptions.WarningCallback pour obtenir des avertissements lorsqu’une feuille de calcul d’entrée contient des plages nommées en double.

 public class WarningCallback implements IWarningCallback

{

	public void warning(WarningInfo warningInfo)

    {

        if (warningInfo.getWarningType() == WarningType.DUPLICATE_DEFINED_NAME)

        {

            System.out.println("Duplicate Defined Names Found as " + warningInfo.getDescription());

        }

    }

}

Voici comment utiliser la classe personnalisée définie ci-dessus.

 // Create an instance of LoadOptions class

LoadOptions options = new LoadOptions();

// Set the WarningCallback property to custom class

options.setWarningCallback(new WarningCallback());

// Load a sample spreadsheet in an instance of Workbook while 

// passing the object of LoadOptions class as defined above

Workbook book = new Workbook(dir + "sample.xlsx", options);

Ajout de la méthode Cells.textToColumns

La dernière révision des API Aspose.Cells for Java a exposé la méthode Cells.textToColumns afin d’imiter celle d’Excel.Texte aux colonnescaractéristique. Excel fournit cette fonctionnalité à partir deOutils de donnéessous leDonnéeslanguette. Veuillez noter que pour diviser le contenu d’une colonne en plusieurs colonnes, les données doivent contenir un délimiteur spécifique tel qu’une virgule (ou tout autre caractère) sur la base duquel le API essaie de diviser le contenu d’une cellule en plusieurs cellules.

Voici un scénario d’utilisation simple pour démontrer l’utilisation de API nouvellement exposé.

 // Create an instance of Workbook and load a sample

Workbook book = new Workbook(dir + "sample.xlsx");

// Retrieve the cells collection of the first worksheet in the sample

Cells cells = book.getWorksheets().get(0).getCells();

// Create an instance of TxtLoadOptions

TxtLoadOptions options = new TxtLoadOptions();

// Specify the separator

options.setSeparator(',');

// Split the data in range B2:B4

cells.textToColumns(1, 1, 3, options);

Ajout de la méthode Workbook.getFonts

Aspose.Cells for Java 17.02.0 a exposé la méthode getFonts pour la classe Workbook. La méthode Workbook.getFonts renvoie la liste des polices individuelles utilisées pour formater le contenu des cellules d’une feuille de calcul donnée. Le type de retour de la méthode susmentionnée est un tableau de la classe typeFont.

L’extrait de code suivant illustre l’utilisation de la méthode Workbook.getFonts.

 // Crée une instance de Workbook et charge un échantillon

Workbook book = new Workbook(dir + "sample.xlsx");

// Récupère la liste des polices utilisées dans le tableur

Font[]fonts = livre.getFonts();

// Itérer la liste et écrire le nom de la police

 pour (int je = 0; je< fonts.length; i ++)

{

	Font font = fonts[i];

	System.out.println(font.getName());

}

Ajout de la propriété TxtSaveOptions.TrimLeadingBlankRowAndColumn

Cette révision de Aspose.Cells for Java a exposé la propriété de type booléen TrimLeadingBlankRowAndColumn pour la classe TxtSaveOptions qui indique si les premières lignes et colonnes vides doivent être coupées comme le fait Excel lors de l’exportation de données vers CSV ou des formats délimités par des tabulations. La valeur par défaut de la propriété susmentionnée est false. Si les données de la feuille de calcul ne commencent pas à partir de la première cellule, c’est-à-dire : A1, l’application Excel supprime les premières lignes et colonnes vides lors de l’exportation des données vers les formats CSV ou délimités par des tabulations. Cependant, les API Aspose.Cells par défaut conservent les lignes et colonnes vides pour le même échantillon afin de conserver l’emplacement des données si les fichiers exportés CSV ou délimités par des tabulations doivent être réimportés à l’aide des API Aspose.Cells.

Voici un scénario d’utilisation simple de la propriété TrimLeadingBlankRowAndColumn.

 // Create an instance of Workbook and load a sample

Workbook book = new Workbook(dir + "sample.xlsx");

// Create an instance of TxtSaveOptions

TxtSaveOptions options = new TxtSaveOptions();

// Set TrimLeadingBlankRowAndColumn property to true

options.setTrimLeadingBlankRowAndColumn(true);

// Export to CSV format while removing the leading blank rows & columns

book.save(dir + "output.csv", options);

Ajout de la propriété BuiltInDocumentPropertyCollection.Revision et de la propriété obsolète BuiltInDocumentPropertyCollection.RevisionNumber

Veuillez utiliser la propriété BuiltInDocumentPropertyCollection.Revision à la place.

Ajout de la propriété Shape.TextShapeType

La propriété Shape.TextShapeType obtient ou définit le type de forme de texte prédéfini à partir d’une liste de types prédéfinis stockés dans l’énumération AutoShapeType.

Exemples d’utilisation

Veuillez consulter la liste des rubriques d’aide ajoutées dans les documents Wiki Aspose.Cells :

1. Ajustement automatique des colonnes et des lignes lors du chargement de HTML dans le classeur
2. Convertir du texte en colonnes à l’aide de Aspose.Cells
3. Obtenir une liste des polices utilisées dans une feuille de calcul ou un classeur
4. Obtenir des avertissements lors du chargement du fichier Excel
5. Lire et manipuler des graphiques Excel 2016
6. Coupez les premières lignes et colonnes vides lors de l’exportation des feuilles de calcul au format CSV