Público API e alterações incompatíveis com versões anteriores

A seguir está uma lista de quaisquer alterações feitas no API público, como membros adicionados, renomeados, removidos ou obsoletos, bem como qualquer alteração não compatível com versões anteriores feita em Aspose.Cells for Java. Se você tiver dúvidas sobre qualquer alteração listada, por favor, levante-a em o fórum de suporte Aspose.Cells.

Adicionada propriedade HTMLLoadOptions.AutoFitColsAndRows

Esta versão do Aspose.Cells for Java API adicionou a propriedade HTMLLoadOptions.AutoFitColsAndRows que indica se o API deve ajustar automaticamente colunas e linhas ao importar o HTML em seu modo de objeto. A propriedade do tipo Boolean tem como valor padrão false o que significa que as alturas e larguras das células serão importadas como estão, porém, quando a propriedade mencionada é definida como true, o API tenta ajustar as larguras das colunas e alturas das linhas de acordo com o conteúdo .

Aqui está o cenário de uso simples da propriedade 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);

Adicionadas propriedades WorkbookSettings.WarningCallback e LoadOptions.WarningCallback

Aspose.Cells for Java 17.02.0 expôs a propriedade WarningCallback às classes LoadOptions e WorkbookSettings para obter ou definir o retorno de chamada de aviso. Os desenvolvedores precisam implementar a interface IWarningCallback para obter avisos personalizados em seus aplicativos.

Aqui está um cenário de uso simples da propriedade LoadOptions.WarningCallback para obter avisos quando uma planilha de entrada contém intervalos nomeados duplicados.

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

        }

    }

}

Aqui está como usar a classe personalizada definida acima.

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

Método Cells.textToColumns adicionado

A última revisão das APIs Aspose.Cells for Java expôs o método Cells.textToColumns para imitar o ExcelTexto para colunasrecurso. O Excel fornece esse recurso deFerramentas de dadosdebaixo deDadosaba. Observe que, para dividir o conteúdo de uma coluna em várias colunas, os dados devem conter um delimitador específico, como uma vírgula (ou qualquer outro caractere), com base no qual o API tenta dividir o conteúdo de uma célula em várias células.

Aqui está um cenário de uso simples para demonstrar o uso do API recém-exposto.

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

Método Workbook.getFonts adicionado

Aspose.Cells for Java 17.02.0 expôs o método getFonts para a classe Workbook. O método Workbook.getFonts retorna a lista de fontes individuais usadas para formatar o conteúdo das células de uma determinada planilha. O tipo de retorno do método mencionado acima é um array da classe typeFont.

O trecho de código a seguir demonstra o uso do método Workbook.getFonts.

 // Cria uma instância do Workbook e carrega uma amostra

Pasta de trabalho = nova pasta de trabalho (dir + "sample.xlsx");

// Recupera a lista de fontes usadas na planilha

Fonte[] fontes = book.getFonts();

// Itera a lista e escreve o nome da fonte

 para (int eu = 0; eu< fonts.length; i ++)

{

	Font font = fonts[i];

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

}

Adicionada propriedade TxtSaveOptions.TrimLeadingBlankRowAndColumn

Esta revisão de Aspose.Cells for Java expôs a propriedade TrimLeadingBlankRowAndColumn do tipo booleano para a classe TxtSaveOptions que indica se as linhas e colunas em branco iniciais devem ser aparadas como o Excel faz ao exportar dados para CSV ou formatos delimitados por tabulação. Caso os dados da planilha não comecem na primeira célula, ou seja: A1, o aplicativo Excel remove as linhas e colunas em branco iniciais ao exportar os dados para os formatos CSV ou delimitado por tabulação, porém, as APIs Aspose.Cells por padrão, retêm as linhas e colunas em branco para a mesma amostra, a fim de manter o local dos dados retido se os arquivos CSV exportados ou delimitados por tabulação precisarem ser importados de volta usando APIs Aspose.Cells.

Aqui está um cenário de uso simples da propriedade 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);

Adicionada propriedade BuiltInDocumentPropertyCollection.Revision e propriedade obsoleta BuiltInDocumentPropertyCollection.RevisionNumber

Em vez disso, use a propriedade BuiltInDocumentPropertyCollection.Revision.

Adicionada propriedade Shape.TextShapeType

A propriedade Shape.TextShapeType obtém ou define o tipo de forma de texto predefinido de uma lista de tipos predefinidos armazenados na enumeração AutoShapeType.

Exemplos de uso

Por favor, verifique a lista de tópicos de ajuda adicionados nos documentos Wiki Aspose.Cells:

1. Colunas e linhas de ajuste automático ao carregar HTML na pasta de trabalho
2. Converter texto em colunas usando Aspose.Cells
3. Obtenha uma lista de fontes usadas em uma planilha ou pasta de trabalho
4. Receba avisos ao carregar arquivo Excel
5. Ler e manipular gráficos do Excel 2016
6. Corte linhas e colunas em branco iniciais ao exportar planilhas para o formato CSV