Aspose.Cells FOSS for Python
Informações do Pacote
| pacote PyPI | aspose-cells-foss |
| importação Python | from aspose.cells_foss import ... |
| ImageRenderOptions | 26.3.1 |
| ImageRenderOptions | MIT |
| requisito Python | >= 3.7 |
| ImageRenderOptions | pycryptodome>=3.15.0, olefile>=0.46 |
ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions |
|---|---|
| aspose.cells_foss | API principal de planilhas: pastas de trabalho, planilhas, células, estilos, gráficos, manipuladores de formato |
ImageRenderOptions: Não há aspose.pydrawing módulo em Aspose.Cells FOSS. As cores são expressas como strings hexadecimais de 8 dígitos AARRGGBB (por exemplo,., "FFFF0000" para vermelho opaco).
aspose.cells_foss
ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
Workbook | pasta de trabalho | Ponto de entrada para criar, carregar e salvar arquivos de planilha |
Worksheet | planilha | Representa uma única planilha; fornece acesso a células, gráficos e imagens |
Cells | células | Coleção semelhante a dicionário de Cell objetos dentro de um Worksheet |
Cell | célula | Representa uma célula individual; valor, fórmula e estilo |
Style | estilo | Formatação de célula: fonte, preenchimento, bordas, alinhamento, formato numérico, proteção |
Font | estilo | Propriedades da fonte: nome, tamanho, cor, negrito, itálico, sublinhado, tachado |
Fill | estilo | Preenchimento de fundo: sólido, gradiente ou padrão |
NumberFormat | estilo | Utilitários incorporados de pesquisa de formato numérico |
SaveFormat | pasta de trabalho | Enumeração dos formatos de saída suportados (XLSX, CSV, MARKDOWN, JSON) |
Chart | gráfico | Representa um gráfico incorporado em uma planilha |
ChartType | gráfico | Enum: LINE, BAR, PIE, AREA, STOCK e mais |
NSeries | gráfico | Coleção de séries de dados em um gráfico |
ChartSeries | gráfico | Uma única série de dados com valores, categorias e barras de erro |
ChartAxis | gráfico | Configurações do eixo: escala, formato, título |
ChartView3D | gráfico | 3D rotation and perspective settings |
ChartErrorBars | gráfico | Configuração de barra de erro para uma série |
DataValidation | validação de dados | Regra única de validação em um intervalo de células |
DataValidationCollection | validação de dados | Todas as regras de validação para uma planilha |
DataValidationType | data-validation | Enum: WHOLE_NUMBER, DECIMAL, LIST, DATE, TIME, TEXT_LENGTH, CUSTOM |
DataValidationOperator | data-validation | Enum: BETWEEN, EQUAL, GREATER_THAN, etc. |
DataValidationAlertStyle | data-validation | Enum: STOP, WARNING, INFORMATION |
CSVHandler | csv-handler | Métodos estáticos para importação/exportação de CSV |
CSVLoadOptions | csv-handler | Opções para carregar arquivos CSV |
CSVSaveOptions | csv-handler | Opções para salvar arquivos CSV |
MarkdownHandler | markdown-handler | Métodos estáticos para exportação de Markdown |
MarkdownSaveOptions | markdown-handler | Opções para exportação de Markdown |
JsonHandler | json-handler | Métodos estáticos para exportação de JSON |
JsonSaveOptions | json-handler | Opções para exportação de JSON |
Shape | forma | Desenhando forma com preenchimento, linha, texto e formatação de fonte |
ShapeCollection | forma | Todas as formas em uma planilha (ws.shapes) |
MsoDrawingType | forma | Enum: RECTANGLE, OVAL, TEXT_BOX, ARROW, etc. |
Table | tabela | Tabela do Excel (referência estruturada) em uma planilha |
TableCollection | tabela | Todas as tabelas em uma planilha (ws.list_objects) |
TableColumn | tabela | Definição de coluna dentro de uma Tabela |
TableStyleInfo | tabela | Configurações de estilo visual para uma Tabela |
SparklineGroup | sparkline | Grupo de gráficos sparkline que compartilham um estilo visual |
SparklineGroupCollection | sparkline | Todos os grupos de sparkline (ws.sparkline_groups) |
Sparkline | sparkline | Uma única célula sparkline vinculada a um intervalo de dados |
SparklineType | sparkline | Enum: LINE, COLUMN, WIN_LOSS |
HorizontalPageBreakCollection | page-break | Quebras de página horizontais manuais (ws.horizontal_page_breaks) |
VerticalPageBreakCollection | quebra de página | Quebras de página verticais manuais (ws.vertical_page_breaks) |
AgileEncryptionParameters | criptografia | Parâmetros de criptografia AES-256/SHA-512 (recomendado) |
StandardEncryptionParameters | criptografia | Parâmetros de criptografia AES-128/SHA-1 legados |
CipherAlgorithm | criptografia | Enum: AES_128, AES_192, AES_256 |
HashAlgorithm | criptografia | Enum: SHA1, SHA256, SHA384, SHA512 |
ImageRenderOptions
ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions |
|---|---|
Workbook() | Criar uma nova planilha vazia (formato XLSX) |
Workbook(file_path: str) | Carregar uma pasta de trabalho a partir de um caminho de arquivo |
Workbook(file_path: str, password: str) | Carregar uma pasta de trabalho protegida por senha |
Propriedades Principais
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
worksheets | lista | Acessar planilhas por índice: workbook.worksheets[0] |
Métodos Principais
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
save(file_path) | ImageRenderOptions | Salvar em arquivo; formato inferido a partir da extensão |
save(file_path, save_format) | ImageRenderOptions | Salvar com SaveFormat explícito |
save_as_csv(file_path, options=None) | ImageRenderOptions | Salvar como CSV |
save_as_markdown(file_path, options=None) | ImageRenderOptions | Salvar como tabelas Markdown |
save_as_json(file_path, options=None) | ImageRenderOptions | Salvar como JSON |
load_csv(file_path, options=None) | ImageRenderOptions | Carregar dados CSV na pasta de trabalho |
add_worksheet(name=None) | ImageRenderOptions | Adicionar uma nova planilha |
get_worksheet(index_or_name) | ImageRenderOptions | Obter planilha por índice ou nome |
remove_worksheet(index_or_name) | ImageRenderOptions | Remover uma planilha |
copy_worksheet(index_or_name_or_ws) | ImageRenderOptions | Copiar uma planilha existente |
protect(password=None, lock_structure=True) | ImageRenderOptions | Proteger a pasta de trabalho com senha |
unprotect(password=None) | ImageRenderOptions | Remover a proteção da pasta de trabalho |
is_protected() | bool | Verificar se a pasta de trabalho está protegida |
ImageRenderOptions
Propriedades Principais
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
name | str | Nome da aba da planilha |
cells | ImageRenderOptions | Todas as células nesta planilha |
charts | ChartCollection | Todos os gráficos nesta planilha |
ImageRenderOptions
Cells suporta acesso estilo dicionário por string de endereço de célula.
Padrões de Acesso
# Read a cell value
value = ws.cells["A1"].value
# Set a cell value directly
ws.cells["A1"].value = "Hello"
# Assign a Cell object
from aspose.cells_foss import Cell
ws.cells["A1"] = Cell(42)
ws.cells["A2"] = Cell(3.14)
ws.cells["A3"] = Cell("Hello World")
ws.cells["A4"] = Cell(None, "=SUM(A1:A3)") # formula cellImageRenderOptions
ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions |
|---|---|
Cell(value=None) | Crie uma célula com um valor (int, float, str ou None) |
Cell(value, formula) | Crie uma célula de fórmula (o valor geralmente é None) |
Propriedades Principais
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
value | ImageRenderOptions | Valor da célula (str, int, float ou None) |
formula | str | String de fórmula (ex.:., "=SUM(A1:A5)") |
style | ImageRenderOptions | Estilo da célula (fonte, preenchimento) |
ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
font | ImageRenderOptions | Configurações de fonte para este estilo |
fill | ImageRenderOptions | Configurações de preenchimento de fundo |
ImageRenderOptions
Cores são expressas como 8-digit AARRGGBB hex strings sem um # prefixo. Exemplos: "FFFF0000" = vermelho opaco, "FF0000FF" = azul opaco, "FF000000" = preto.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|---|
name | str | ImageRenderOptions | Nome da família de fontes |
size | float | 11 | Tamanho da fonte em pontos |
color | str | FF000000 | 8-digit AARRGGBB hex color string |
bold | bool | ImageRenderOptions | Texto em negrito |
italic | bool | ImageRenderOptions | Texto em itálico |
underline | bool | ImageRenderOptions | Texto sublinhado |
strikethrough | bool | ImageRenderOptions | Texto tachado |
ImageRenderOptions
Font(name="Calibri", size=11, color="FF000000",
bold=False, italic=False, underline=False, strikethrough=False)ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions |
|---|---|
set_solid_fill(color) | Fundo sólido; color é uma string hexadecimal de 8 dígitos AARRGGBB |
set_pattern_fill(pattern_type, fg_color, bg_color) | Preenchimento com padrão |
set_no_fill() | Remover preenchimento de fundo |
MarkdownHandler
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
MarkdownHandler.save_markdown_to_string(workbook) | str | Exportar a pasta de trabalho para uma string Markdown na memória |
MarkdownSaveOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|---|
default_alignment | str | esquerda | Alinhamento da coluna: esquerda, direita ou central |
include_worksheet_name | bool | ImageRenderOptions | Se deve incluir o nome da planilha como título |
header_level | int | 2 | Nível de título Markdown (1-6) |
worksheet_index | int | 0 | Índice da planilha a exportar; -1 exporta todas as planilhas |
ChartCollection
Os gráficos são adicionados usando métodos dedicados por tipo. Os índices de linha e coluna são baseado em zero.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
add_bar(top_row, left_col, bottom_row, right_col) | ImageRenderOptions | Adicionar um gráfico de colunas (barras verticais) |
add_line(top_row, left_col, bottom_row, right_col) | ImageRenderOptions | Adicionar um gráfico de linhas |
add_pie(top_row, left_col, bottom_row, right_col) | ImageRenderOptions | Adicionar um gráfico de pizza |
ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
title | str | Título do gráfico como uma string simples (não .title.text) |
category_data | str | Intervalo de células para rótulos de categoria do eixo x |
n_series | NSeries | Coleção de séries de dados |
show_legend | bool | Se deve exibir a legenda |
legend_position | str | Posição da legenda: direita, inferior, esquerda ou superior |
NSeries
| ImageRenderOptions | ImageRenderOptions |
|---|---|
add(data_range, category_data=None, name=None) | Adicionar uma série de dados nomeada |
Enumeração SaveFormat
| ImageRenderOptions | Formato de saída |
|---|---|
SaveFormat.XLSX | Excel Open XML (padrão) |
SaveFormat.CSV | Valores separados por vírgula |
SaveFormat.TSV | Valores separados por tabulação |
SaveFormat.MARKDOWN | Tabelas Markdown |
SaveFormat.JSON | Dados estruturados em JSON |
ImageRenderOptions: SaveFormat.PDF, SaveFormat.HTML, SaveFormat.PNG, SaveFormat.TIFF, SaveFormat.DOCX, e SaveFormat.PPTX são não disponíveis em Aspose.Cells FOSS. Esses formatos requerem o comercial aspose-cells-python pacote.
Exemplos de Código
Criar, estilizar e salvar uma planilha
from aspose.cells_foss import Workbook, Cell
wb = Workbook()
ws = wb.worksheets[0]
ws.cells["A1"].value = "Revenue Report"
ws.cells["A2"].value = 125000
ws.cells["A1"].style.font.bold = True
ws.cells["A1"].style.font.size = 14
ws.cells["A1"].style.font.color = "FF1E64C8" # Blue (AARRGGBB, no #)
wb.save("report.xlsx")Exportar para Markdown na memória
from aspose.cells_foss import Workbook, Cell, MarkdownHandler
wb = Workbook()
ws = wb.worksheets[0]
ws.cells["A1"].value = "Name"
ws.cells["B1"].value = "Score"
ws.cells["A2"].value = "Alice"
ws.cells["B2"].value = 95
md = MarkdownHandler.save_markdown_to_string(wb)
print(md)Criar um gráfico de linhas
from aspose.cells_foss import Workbook, Cell
wb = Workbook()
ws = wb.worksheets[0]
for i, (m, v) in enumerate([("Jan", 50), ("Feb", 80), ("Mar", 120)], start=2):
ws.cells[f"A{i}"].value = m
ws.cells[f"B{i}"].value = v
chart = ws.charts.add_line(5, 0, 18, 7)
chart.title = "Monthly Trend"
chart.category_data = "A2:A4"
chart.n_series.add("B2:B4", category_data="A2:A4", name="Sales")
wb.save("trend.xlsx")Recursos Relacionados
- Guia do Desenvolvedor: Tutoriais para todos os recursos principais
- Introdução / Instalação: pip install e configuração
- Base de Conhecimento: Guias práticos orientados por tarefas
- Visão Geral do Produto: Resumo de recursos e capacidades
- Repositório GitHub
- Blog: Apresentando Aspose.Cells FOSS: Visão geral da biblioteca e início rápido
