Trabalhando com Gráficos
Trabalhando com Gráficos
Aspose.Cells FOSS for Java preserves embedded charts when loading and saving XLSX workbooks. You can inspect existing charts, query their type and position, and add new standard-type charts programmatically. ChartEx types such as Waterfall, Treemap, Sunburst, Histogram, Box and Whisker, Funnel, and Map are preserved on round-trip but cannot be created through the API.
Resumo geral
Os gráficos numa folha de cálculo são gerenciados através do sistema de gestão da informação. ChartCollection acesso através de: Worksheet.getCharts().Cada um . Chart instância expõe o seu nome, tipo de gráfico, A nova tabela é inserida com a seguinte redacção: ChartCollection.add(type, dataRange, upperLeftRow, upperLeftColumn, lowerRightRow, lowerRightColumn), que retorna o índice do gráfico recém-criado.
A Comissão ChartType enum identifica a variante do gráfico (barra, linha, tarte etc.). Métodos auxiliares ChartCollection.parseChartType(string) e a) ChartCollection.chartTypeToString(ChartType) converter entre o enum e A representação de cadeias para casos de uso da serialização.
Classe-chave
| Classe: | Descrição: |
|---|---|
Chart | Representa um gráfico incorporado em uma folha de cálculo. Leia o acesso ao nome, tipo e posição da âncora da célula. |
ChartCollection | Coleção de todos os gráficos em uma planilha. Suporta assistentes de contagem, acesso a índices, adição e conversão do tipo gráfico. |
ChartType | Enum identificando a variante do gráfico (barras, colunas, linhas, pie, scatter, etc.). |
ChartModel | Modelo de serialização interna para um gráfico. Exponha os campos XML brutos usados durante o carregamento/salvo. |
Acesso a gráficos em uma planilha
Recuperar o ChartCollection de qualquer Worksheet objeto via Worksheet.getCharts().- Usar . ChartCollection.getCount() para determinar quantos Os gráficos individuais são acessados por índice baseado em zero através de um sistema de cálculo. ChartCollection.get(index).
Uma vez que você segurar um Chart referências que pode ler:
Chart.getName()a cadeia de nomes interna do gráfico.Chart.getChartType()oChartTypevalor enum.Chart.getUpperLeftRow()/Chart.getUpperLeftColumn()A célula de ancoragem superior esquerda.Chart.getLowerRightRow()/Chart.getLowerRightColumn()A célula de ancoragem inferior direita.Chart.getExtentCx()/Chart.getExtentCy()o gráfico se estende em UEM.
Adicionando um novo gráfico
Utilização: ChartCollection.add(type, dataRange, upperLeftRow, upperLeftColumn, lowerRightRow, lowerRightColumn) O método retorna o índice inteiro do gráfico dentro de: A colecção. ChartType valor para o type argumento e uma célula. linha de intervalo (por exemplo: A1:B5) para o período de 1 de Dezembro de 2000 a 31 de Janeiro de 2001: dataRange.
Nota: Os tipos da família ChartEx (Waterfall, Treemap, Sunburst, Histogram, Box e Whisker, Funnel, Map) são preservados ao carregar arquivos XLSX, mas não podem ser criados programaticamente através desta API.
Resumo de referência da API
Gráfico
| Método de avaliação | Tipo de devolução | Descrição: |
|---|---|---|
getName() | String | Nome interno do gráfico. |
getChartType() | ChartType | O valor de enum variante do gráfico. |
getUpperLeftRow() | int | Índice da linha de ancoragem superior esquerda. |
getUpperLeftColumn() | int | Índice da coluna na âncora superior esquerda. |
getLowerRightRow() | int | Índice de linha da âncora inferior direita. |
getLowerRightColumn() | int | Índice da coluna de ancoragem inferior direita. |
getExtentCx() | long | Largura do gráfico em UEM. |
getExtentCy() | long | Altura do gráfico em UEM. |
ChartCollection
| Método de avaliação | Tipo de devolução | Descrição: |
|---|---|---|
getCount() | int | Número de gráficos na folha de cálculo. |
get(index) | Chart | Retorna o gráfico no índice baseado em zero dado. |
add(type, dataRange, ...) | int | Adiciona um novo gráfico; retorna o seu índice. |
parseChartType(string) | ChartType | Converte um nome de cadeia para uma ChartType valor enum. |
chartTypeToString(type) | String | Converte a ChartType enum valor para o seu nome de string. |
Limitações
- Os tipos ChartEx (Waterfall, Treemap, Sunburst, Histogram, Box and Whisker, Funnel, Map) são rotativos literalmente mas não podem ser criados via API.
- As ligações de séries de dados do gráfico não são modificáveis nesta versão; o gráfica é renderizada com base no intervalo original de informações fornecido na hora da criação.
